@database Scegli.guide
@$VER: Scegli.guide 39.10 (18.1.99)
@(c) Copyright 1998 Matteo Beccati
@smartwrap
@tab 8

@macro _ipar "@{lindent 4}@{par}"
@macro _opar "@{lindent 0}@{par}"


@node "MAIN" "Scegli.guide"
@{_ipar}
@{b}@{u}Scegli 39.10@{uu}@{ub}@{par}

Copyright © 1998 Matteo Beccati@{par}

Data de Lançamento: 10-04-1999@{par}

@{"Introdução         " LINK "Introduzione"}@{line}
@{"Características    " LINK "Caratteristiche"}@{line}
@{"Informações Legais " LINK "Informazioni"}@{line}
@{"Requisitos         " LINK "Richieste"}@{line}
@{"Instalação         " LINK "Installazione"}@{par}

@{"Utilização         " LINK "Uso"}@{line}
@{"Configuração       " LINK "Configurazione"}@{par}

@{"Futuro             " LINK "Futuro"}@{line}
@{"Autor              " LINK "Autore"}@{line}
@{"História           " LINK "History"}@{_opar}

@{i}Nota: @{ui}Este manual requer o AmigaGuide v40 ou superior para ser
correctamente apresentado, embora também possa ser lido com versões
anteriores do AmigaGuide.@{par}
@ENDNODE

@NODE "Introduzione" "Scegli.guide/Introdução"
@{_ipar}
@{b}@{u}Introdução@{uu}@{ub}@{_opar}

Existem tantos programas de criação de menus de arranque existentes,
que é lícito perguntar porque fui eu programar mais um. Porque nenhum
deles correspondia precisamente às minhas necessidades.@{par}

Há muito tempo atrás, costumava ter dois programas logo no início
do ficheiro 'startup-sequence': um programa, cujo nome não me recordo,
que testava os botões do rato, e um outro chamado @{i}The Choice@{ui},
que apresentava um interface de escolha de scripts a lançar muito
semelhante ao do @{i}Scegli@{ui}.@{par}

Portanto, decidi criar um programa que integrasse as duas funções acima
mencionadas. Mas agora, para além dessas, o @{i}Scegli@{ui} tem um número
de @{"características" link "Caratteristiche"} muito maior do que eu
alguma vez imaginei possível! :-)@{par}
@ENDNODE

@NODE "Caratteristiche" "Scegli.guide/Características"
@{_ipar}
@{b}@{u}Características@{uu}@{ub}@{_opar}

A ideia básica do @{i}Scegli@{ui} é criar um menu de arranque que
aparecerá se o utilizador premir o botão esquerdo do rato, e
carregar um ficheiro 'startup-sequence' alternativo se o utilizador
premir o botão direito. Porém, não há nada que o impeça de
usar o programa mesmo depois do OS estar totalmente carregado,
porque:@{line}
 - a função de controlo por rato é opcional;@{line}
 - o programa pode usar o ficheiro de configuração da sua preferência
a qualquer momento;@{line}
 - o programa pode ser lançado a partir do Workbench, sendo configurável
através de ToolTypes.@{par}

O menu de arranque do @{i}Scegli@{ui} pode ser constituído por um ecrã
com botões, os quais podem ser dividos em categorias diferentes, com
o nome à sua escolha. Por exemplo: Jogos, Gráficos, Programação...@{par}

O ecrã do menu de arranque pode ser aberto em qualquer modo de ecrã
(PAL, dblPAL, CyberGFX...).@{par}

É igualmente possível escolher uma fonte para o ecrã e botões.@{par}

Para ambas as funções, basta usar o habitual pedido de ficheiros ASL.@{par}

O programa pode lançar tanto scripts como comandos individuais, e pode ser
configurado de modo a regressar ao menu depois da operação seleccionada
ter terminado.@{par}

Por último, o @{i}Scegli@{ui} aparece totalmente traduzido em Português,
mesmo se for usado antes do sistema se inicializar.@{par}
@ENDNODE

@NODE "Informazioni" "Scegli.guide/Informações Legais"
@{_ipar}
@{b}@{u}Informações Legais@{uu}@{ub}@{_opar}

O @{i}Scegli@{ui} é distribuído sob o conceito de Freeware, o que
significa que este arquivo pode ser distribuído desde que permaneça
completo e inalterado. As operações de compressão/descompressão com
um programa como o Lha não são consideradas alterações ilegais, desde
que todos os ficheiros e respectivos nomes não sofram alterações.@{par}

O @{i}Scegli@{ui} não é distribuído com nenhuma garantia. O autor
não pode ser responsabilizado por qualquer tipo de estrago ou prejuízo
causado durante a utilização deste programa. Está a usá-lo por sua
conta e risco!@{par}
@ENDNODE

@NODE "Richieste" "Scegli.guide/Requisitos"
@{_ipar}
@{b}@{u}Requisitos@{uu}@{ub}@{_opar}

O @{i}Scegli@{ui} requer o Kickstart 3.0 ou superior, porque usa alguns
recursos apenas disponíveis no Workbench 3.0 (ou superior), como a
'asl.library' e a 'diskfont.library'.@{par}

Além disso, é aconselhável ter um disco rígido, visto que o programa
foi especificamente concebido para trabalhar nesse sistema.@{par}
@ENDNODE

@NODE "Installazione" "Scegli.guide/Instalação"
@{_ipar}
@{b}@{u}Instalação@{uu}@{ub}@{_opar}

Ainda não existe nenhum script de instalação (se quiser um, por favor @{"contacte-me" link "Autore"} por email).
De qualquer forma, é muito fácil instalar o programa:@{par}

@{u}Para utilização na Shell:@{uu}@{_ipar}

- Copie o ficheiro 'Scegli' para 'C:';@{line}
- Crie um ficheiro 'S:Scegli.config' para @{"configurar" LINK "Configurazione"} o programa;@{line}
- Copie o directório Catalogs para 'LOCALE:'.@{line}
- Acrescente a linha 'C:Scegli MOUSE QUIET' (ver @{"Utilização" LINK "Uso"}) antes de 'SetPatch'@{line}
  no ficheiro 'S:startup-sequence'.@{_opar}

@{u}Para utilização no Workbench:@{uu}@{_ipar}

- Copie o directório @{i}Scegli@{ui} para onde quiser no seu disco rígido.@{_opar}

@{u}Notas:@{uu}@{_ipar}
Se quer usar o @{i}Scegli@{ui} como menu de arranque, é preciso fazer um
pequeno 'truque'. Quando o @{i}Scegli@{ui} é lançado pelo AmigaOS, as
várias configurações e atribuições de variáveis (assigns) ainda não foram
efectuadas, pelo que teoricamente não seria possível ter o programa
a aparecer traduzido. Mas na v39.10 acrescentei uma nova função que
resolve o problema: basta activar a variável 'ENVARC:Language', a qual
já deve estar incluída no Workbench 3.1. Se não tem essa versão do
Workbench ou não tem essa variável na sua configuração, pode criá-la
facilmente no CLI através dos seguintes comandos:@{par}

- SetEnv Language "<idioma_preferido>"@{line}
  onde <idioma_preferido> é português.@{line}
- Copy ENV:Language ENVARC:@{_opar}
@ENDNODE

@NODE "Uso" "Scegli.guide/Utilização"
@{_ipar}
@{b}@{u}Utilização@{uu}@{ub}@{_opar}

O @{i}Scegli@{ui} pode ser usado a partir da Shell ou do Workbench.@{par}

Se o usar a partir do Workbench, não é possível especificar todos os argumentos.@{_ipar}

@{b}Argumentos Textuais:@{ub}@{line}
@{"CONFIG  " LINK "arg_config"}            Ficheiro de configuração.@{line}
@{"FONT    " LINK "arg_font"}            Nome da fonte a usar.@{line}
@{"MODEID  " LINK "arg_modeid"}            Modo de ecrã a usar.@{line}
@{"RMOUSE  " LINK "arg_rmouse"}            Script a lançar quando o botão direito é premido.@{par}

@{b}Argumentos Numéricos:@{ub}@{line}
@{"FONTSIZE" LINK "arg_fontsize"}            Tamanho da fonte a usar.@{par}

@{b}Argumentos 'Ligado/Desligado':@{ub}@{line}
@{"MOUSE   " LINK "arg_mouse"}            Verifica se os botões do rato são premidos.@{line}
@{"NOEXIT  " LINK "arg_noexit"}            Regressa ao menu depois do script (ou comando) terminar.@{line}
@{"QUIET   " LINK "arg_quiet"}            Desliga a saída de erros.@{line}
@{"TOBLACK " LINK "arg_toblack"}            Apresenta um ecrã preto enquanto o script estiver a correr.@{_opar}

No meu ficheiro 'startup-sequence', por exemplo, o programa é lançado da seguinte forma:

C:Scegli @{"QUIET" LINK "arg_quiet"} @{"RMOUSE" LINK "arg_rmouse"}=SYS:g/ShapeShifter @{"FONT" LINK "arg_font"}=dgsansserif @{"FONTSIZE" LINK "arg_fontsize"}=8 @{"MODEID" LINK "arg_modeid"}=167936@{par}

@ENDNODE

@NODE "Configurazione" "Scegli.guide/Configuração"
@{_ipar}
@{b}@{u}Configuração@{uu}@{ub}@{_opar}

Nesta secção, encontra-se um exemplo de um ficheiro de configuração.@{par}

Um '#' no início de uma linha cria uma categoria. Este caracter
TEM de ser inserido na primeira linha do ficheiro.@{par}

A linha seguinte contém o nome do primeiro botão, e a que se
lhe segue contém o script correspondente a executar; se o primeiro
caracter desta linha for um '+', o @{i}Scegli@{ui} executará o conjunto
de instruções como um comando. É possível inserir qualquer número de
categorias e botões.@{par}

   Exemplo:@{par}

<-------------------------- BEGIN OF FILE --------------------------------->@{line}
   #Games                     <- Primeira linha com uma categoria (indispensável)@{line}
   Alien Breed                <- Primero botão@{line}
   Games:AlienBreed/Start     <- Script associado ao primeiro botão@{line}
   Zak McCracken              <- Segundo botão@{line}
   +Games:Zak/StartZak        <- Comando associado ao segundo botão@{line}
   ...                           etc..@{line}
   ...@{line}
   #Programs                  <- Segunda categoria@{line}
   LightWave                  <- Primeiro botão da segunda categoria@{line}
   SYS:s/StartLW              <- Script associado ao botão da segunda categoria@{line}
   ...                           etc...@{line}
<--------------------------- END OF FILE ---------------------------------->@{par}

@ENDNODE

@NODE "Futuro" "Scegli.guide/Futuro"
@{_ipar}
@{b}@{u}Futuro@{uu}@{ub}@{_opar}

Se tiver alguma sugestão, por favor @{"contacte-me" link "Autore"}!@{par}
@ENDNODE

@NODE "Autore" "Scegli.guide/Autor"
@{_ipar}
@{b}@{u}Autor@{uu}@{ub}@{_opar}

Se quiser entrar em contacto comigo por qualquer motivo (relatórios de
bugs, novas ideias, presentes, CyberstormPPC... :), pode usar o seguinte
endereço:@{_ipar}

Matteo Beccati@{line}
Via del Castagno, 8@{line}
44100 Ferrara (FE)@{line}
Italy@{par}

email:  ciaccia@writeme.com@{_opar}

@ENDNODE

@NODE "History" "Scegli.guide/História do Programa"
@{_ipar}
@{b}@{u}História do Programa@{uu}@{ub}@{_opar}

Scegli 39.10:    - Acrescentei a opção TOBLACK;

                 - Acrescentei a possibilidade de localização, mesmo quando
usada antes do assign LOCALE: e antes de lançar o iPrefs;

                 - Retirei o pedido de assign ENV: caso não se encontre
disponível;@{par}

Scegli 39.9:     - Primeiro lançamento público.@{par}

@ENDNODE

@NODE arg_config "Scegli.config/Utilização/CONFIG"
@{_ipar}
@{b}@{u}Config@{uu}@{ub}@{_opar}

Aqui pode definir um ficheiro de @{"configuração" LINK "Configurazione"} a usar.

O argumento @{b}CONFIG@{ub} é opcional.@{par}

O ficheiro escolhido habitualmente é 'S:Scegli.config'.@{par}

@ENDNODE

@NODE arg_font "Scegli.config/Utilização/FONT"
@{_ipar}
@{b}@{u}Font@{uu}@{ub}@{_opar}

Aqui pode definir a fonte a usar (sem a extensão '.font').@{par}

Normalmente, a fonte escolhida é a do Workbench.@{par}

@{u}Nota:@{uu}@{_ipar}
Se não especificar o argumento @{b}FONTSIZE@{ub}, será usado
o tamanho mais pequeno da fonte indicada.@{_opar}

Ver também:@{_ipar}
@{"FONTSIZE" LINK "arg_fontsize"}

@ENDNODE

@NODE arg_modeid "Scegli.config/Utilização/MODEID"
@{_ipar}
@{b}@{u}ModeID@{uu}@{ub}@{_opar}

Aqui pode definir o modo de ecrã a usar para o ecrã do @{i}Scegli@{ui}.@{par}

Os valores podem ser:@{_ipar}
- um número inteiro;@{line}
- um número hexadecimal (com o prefixo '$' ou '0x');@{line}
- um '?' para abrir uma janela de selecção de modos de ecrã.@{par}

O valor habitual é usar o modo de ecrã do Workbench.@{_opar}

@{u}Nota:@{uu}@{_ipar}
Sugiro-lhe que use o programa @{i}GetModeID@{ui} de M. Holmgren
para obter os valores correctos dos modos de ecrã.@{_opar}

@ENDNODE

@NODE arg_rmouse "Scegli.config/Utilização/RMOUSE"
@{_ipar}
@{b}@{u}RMouse@{uu}@{ub}@{_opar}

Aqui pode definir um script que será corrido se o botão direito
do rato for premido durante o arranque do sistema.@{par}

Normalmente, não é lançado nenhum script.@{_opar}

@{u}Nota:@{uu}@{_ipar}
Se esta opção for especificada, a opção @{b}MOUSE@{ub} será
automaticamente activada.@{par}
Esta opção não pode ser especificada a partir do Workbench.@{_opar}

Ver também:@{_ipar}
@{"MOUSE" LINK "arg_mouse"}

@ENDNODE

@NODE arg_fontsize "Scegli.config/Utilização/FONTSIZE"
@{_ipar}
@{b}@{u}Fontsize@{uu}@{ub}@{_opar}

Aqui pode definir o tamanho da fonte a usar.@{par}

Normalmente, é usado o tamanho da fonte do Workbench.@{par}

@{u}Nota:@{uu}@{_ipar}
Para que esta opção tenha efeito, é preciso igualmente especificar
o argumento @{b}FONT@{ub}.@{_opar}

Ver também:@{_ipar}
@{"FONT" LINK "arg_font"}

@ENDNODE

@NODE arg_mouse "Scegli.config/Utilização/MOUSE"
@{_ipar}
@{b}@{u}Mouse@{uu}@{ub}@{_opar}

Se activar esta opção, o @{i}Scegli@{ui} só apresentará o menu quando
o botão esquerdo do rato for premido durante o arranque do sistema.@{par}

@{u}Nota:@{uu}@{_ipar}
Esta opção não pode ser especificada a partir do Workbench.@{_opar}

Ver também:@{_ipar}
@{"RMOUSE" LINK "arg_rmouse"}

@ENDNODE

@NODE arg_noexit "Scegli.config/Utilização/NOEXIT"
@{_ipar}
@{b}@{u}NoExit@{uu}@{ub}@{_opar}

Se activar esta opção, o @{i}Scegli@{ui} regressará ao menu depois
do script ou comando terminar.@{par}

@ENDNODE

@NODE arg_quiet "Scegli.config/Utilização/QUIET"
@{_ipar}
@{b}@{u}Quiet@{uu}@{ub}@{_opar}

Se activar esta opção, o @{i}Scegli@{ui} não apresentará nenhuma mensagem de erro.@{par}

@{u}Nota:@{uu}@{_ipar}
Esta opção aplica-se tanto a scripts como comandos que estejam a correr
(caso o @{i}Scegli@{ui} seja lançado a partir da Shell).@{par}
@ENDNODE

@NODE arg_toblack "Scegli.config/Utilização/TOBLACK"
@{_ipar}
@{b}@{u}ToBlack@{uu}@{ub}@{_opar}

Se activar esta opção, o ecrã ficará preto após o clique de um botão do
rato, de modo que o ecrã do Workbench seja escondido durante o
arranque.@{par}

@{u}Nota:@{uu}@{_ipar}
Obviamente, se ligar esta opção, o @{i}Scegli@{ui} permanecerá na
memória até o script ou comando terminar.@{par}
Esta opção não pode ser especificada a partir do Workbench.@{_opar}

@ENDNODE