home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / +system+ / tools / workbench / cycletomenu-2.1 / italiano / cycletomenu.doc < prev    next >
Text File  |  1997-02-27  |  12KB  |  380 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                               CycleToMenu 2.1
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. Il programma, la documentazione e gli altri file contenuti nel presente
  9. archivio possono essere liberamente copiati e distribuiti, purché l'archivio
  10. stesso non venga alterato in alcun modo e non venga richiesto alcun
  11. pagamento se non il minimo necessario per ripagare le spese di copiatura e
  12. distribuzione.
  13.  
  14. L'autore declina qualsiasi responsabilità per eventuali danni derivanti
  15. direttamente o indirettamente dall'uso del programma.
  16.  
  17.  
  18. Questo programma è CardWare, cioè l'autore non richiede alcun pagamento,
  19. però se il programma vi piace, l'autore gradirebbe ricevere una cartolina
  20. postale della vostra città.
  21.  
  22. L'indirizzo dell'autore è il seguente:
  23.  
  24.     Federico Giannici
  25.     Viale Francia 4
  26.     90146 Palermo
  27.     Italia
  28.  
  29.  
  30. Posta elettronica: MC4080@mclink.it
  31.  
  32.  
  33.  
  34.  
  35.     INTRODUZIONE
  36. ~~~~~~~~~~~~~~~~~~~~
  37. CycleToMenu è una Commodity che trasforma i normali gadget ciclici di
  38. sistema (cioè quei gadget con l'immagine di una freccia che ruota sulla
  39. sinistra) in menu a comparsa (menu popup, in Inglese) o in gadget "ad
  40. espansione". In tal modo la scelta dell'opzione desiderata risulta molto più
  41. semplice e veloce.
  42.  
  43. Se il gadget viene premuto sulla parte sinistra, in corrispondenza
  44. dell'immagine della freccia che ruota, si comporterà nel modo usuale. Tale
  45. possibilità è utile per passare velocemente alla voce successiva. Può
  46. risultare altresì utile nel caso in cui non vi sia sufficiente memoria o il
  47. menu a comparsa sia tanto lungo da non entrare nello schermo.
  48.  
  49. Da notare che la finestra di configurazione ed altre funzioni raramente
  50. utilizzate sono state messe in un overlay, in modo da non occupare memoria
  51. inutilmente quando non sono utilizzate. Un inconveniente è che non è
  52. possibile cancellare il file di CycleToMenu mentre il programma sta girando.
  53.  
  54.  
  55.  
  56.     REQUISITI
  57. ~~~~~~~~~~~~~~~~~
  58. · AmigaOS Release 2.0
  59. · Per la "localizzazione" è richiesto AmigaOS Release 2.1
  60.  
  61.  
  62.  
  63.     INSTALLAZIONE
  64. ~~~~~~~~~~~~~~~~~~~~~
  65. L'installazione è molto semplice: è sufficiente aprire il cassetto con il
  66. nome del linguaggio che si desidera installare (Italiano) e fare un doppio
  67. click sulla icona di installazione.
  68.  
  69. Partirà uno script AmigaDOS che copierà CycleToMenu nel cassetto WBStartup
  70. della propria partizione (o disco) del Workbench. Se si è scelto un
  71. linguaggio diverso dall'Inglese, verrà anche copiato il corrispondente file
  72. "catalog" nella directory appropriata, in modo tale da permettere a
  73. CycleToMenu di utilizzare quel determinato linguaggio. Infine, verrà chiesto
  74. se si desidera installare l'icona in stile MagicWB.
  75.  
  76. E' importante notare che CycleToMenu ha effetto solo su quei gadget ciclici
  77. creati dopo che CycleToMenu è stato già lanciato. E' quindi molto importante
  78. lanciare CycleToMenu prima possibile. A tal fine, il parametro STARTPRI
  79. della icona di CycleToMenu è stato posto pari ad un valore molto alto (100).
  80. Tale parametro è infatti usato dal Workbench per determinare l'ordine in cui
  81. lanciare i programmi presenti nel cassetto WBStartup.
  82.  
  83.  
  84.  
  85.     MODIFICA DELLA CONFIGURAZIONE
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87. Una volta che CycleToMenu è stato lanciato, è possibile aprirne la finestra
  88. di configurazione in tre modi diversi:
  89.  
  90. · Per mezzo della hot-key (il valore predefinito è "control alt y")
  91. · Tramite il programma Exchange
  92. · Lanciando nuovamente CycleToMenu
  93.  
  94. Dopodiché è possibile modificare l'aspetto ed il comportamento dei menu a
  95. comparsa tramite i gadget della finestra. Si possono immediatamente
  96. verificare gli effetti delle modifiche tramite i tre gadget ciclici di prova
  97. posti nella parte inferiore della finestra.
  98.  
  99. Quando si è soddifatti della configurazione corrente, la si può memorizzare
  100. tramite la voce "Salva" del menu.
  101.  
  102.  
  103.  
  104.     GADGET
  105. ~~~~~~~~~~~~~~
  106.  
  107.   Esegui zoom
  108.   -----------
  109. Se questa opzione è attiva, l'apertura e la chiusura dei menu a comparsa
  110. avverrà per gradi, come con una specie di zoom progressivo.
  111.  
  112.  
  113.   Durata minima
  114.   Durata massima
  115.   --------------
  116. Questi due gadget controllano la velocità dello zoom (espressa in frazioni
  117. di secondo). La durata effettiva è proporzionale al numero di voci del menu.
  118. La durata minima la si ottiene con menu composti da soltanto due voci,
  119. mentre quella massima è raggiunta con dieci o più voci.
  120.  
  121.  
  122.   Usa caratteri schermo
  123.   ---------------------
  124. Normalmente CycleToMenu utilizza gli stessi caratteri (font, in Inglese) del
  125. gadget ciclico. Se questa opzione è attiva, verranno utilizzati invece i
  126. caratteri dello schermo.
  127.  
  128.  
  129.   Min altezza caratteri
  130.   ---------------------
  131. Normalmente CycleToMenu utilizza gli stessi caratteri del gadget ciclico.
  132. Sfortunatamente molti programmi utilizzano font piuttosto piccoli (per
  133. esempio il topaz/8). Tramite questo gadget è possibile specificare la
  134. dimensione minima che devono avere i caratteri del gadget ciclico affiché
  135. vengano utilizzati da CycleToMenu. Se i caratteri sono più piccoli di quanto
  136. specificato dalla presente opzione, CycleToMenu utilizzerà i caratteri di
  137. schermo (sempre che questi ultimi siano più grandi di quelli dal gadget
  138. ciclico).
  139.  
  140.  
  141.   Minimo numero di voci
  142.   ---------------------
  143. Indica il minimo numero di voci del gadget ciclico affinché CycleToMenu apra
  144. il proprio menu a comparsa. Per esempio, un buon valore potrebbe essere "3",
  145. in tal caso non verrebbe aperto alcun menu a comparsa per i gadget ciclici
  146. con due sole voci.
  147.  
  148.  
  149.   Come menu
  150.   Come MagicMenu
  151.   Come gadget
  152.   --------------
  153. Questi gadget selezionano uno dei tre diversi tipi di aspetto dei menu a
  154. comparsa.
  155.  
  156. Come menu - Usa lo stesso aspetto dei normali menu di Intuition.
  157.  
  158. Come MagicMenu - Simula l'aspetto usato dai menu del programma MagicMenu
  159. (MagicMenu è copyright by Martin Korndörfer).
  160.  
  161. Come gadget - Invece di un aspetto da menu ne usa uno più simile a quello
  162. dei gadget. L'idea di fondo è che il gadget ciclico non sia altro che una
  163. piccola "finestra" sull'intera lista delle possibili voci del gadget. Quando
  164. l'utente clicca sul gadget, la finestra si espande rivelando l'intera lista
  165. sottostante delle voci.
  166.  
  167.  
  168.   Forza menu NewLook
  169.   ------------------
  170. Questa opzione forza CycleToMenu ad usare sempre il nuovo aspetto dei menu
  171. (NewLook) introdotto con l'AmigaOS 3.0. Sotto AmigaOS 2.x, CycleToMenu tenta
  172. ugualmente di emulare per quanto possibile il nuovo aspetto.
  173.  
  174.  
  175.   Centra su voce corrente
  176.   -----------------------
  177. Se questa opzione è attiva, i menu saranno posizionati in modo tale da
  178. centrare la voce corrente al di sopra del gadget ciclico.
  179.  
  180.  
  181.   Doppio bordo
  182.   ------------
  183. Questo gadget serve a simulare l'opzione "Double Borders" di MagicMenu.
  184.  
  185.  
  186.   Bordo interno
  187.   -------------
  188. Questa opzione aggiunge un bordo vuoto (cioè del medesimo colore dello
  189. sfondo) tra il normale bordo esterno dei menu a comparsa e le voci
  190. componenti il menu stesso (la differenza si nota soprattutto con la voce
  191. corrente, in quanto è generalmente disegnata con un colore di sfondo diverso
  192. dal resto).
  193.  
  194.  
  195.   Rientra voce corrente
  196.   ---------------------
  197. Se questa opzione è attiva, la voce corrente viene disegnata "rientrata"
  198. rispetto alle rimanenti voci del menu.
  199.  
  200.  
  201.   Gadget di prova
  202.   ---------------
  203. Questi gadget non hanno alcuna influenza sulla configurazione dei menu a
  204. comparsa. Il loro unico scopo è quello di provare immediatamente gli effetti
  205. delle modifiche ottenute attraverso gli altri gadget. Al fine di provare la
  206. configurazione corrente nelle situazioni più diverse, i tre gadget
  207. utilizzano tre diversi caratteri (indicati al di sopra) ed un diverso numero
  208. di voci.
  209.  
  210.  
  211.  
  212.     MENU
  213. ~~~~~~~~~~~~
  214.  
  215.   Salva
  216.   -----
  217. Questa voce del menu serve a registrare le impostazioni della configurazione
  218. corrente nei parametri Workbench della icona di CycleToMenu. Si noti che
  219. bisogna lanciare CycleToMenu da Workbench (o WBStartup) affinché i parametri
  220. dell'icona abbiano effetto.
  221.  
  222.  
  223.   Informazioni
  224.   ------------
  225. Apre un requester con alcune informazioni sul programma ed il suo autore.
  226.  
  227.  
  228.   Nascosto
  229.   --------
  230. Chiude la finestra di configurazione. CycleToMenu rimane in memoria con la
  231. configurazione corrente.
  232.  
  233.  
  234.   Fine
  235.   ----
  236. Chiude la finestra di configurazione e rimuove definitivamente CycleToMenu.
  237. I gadget ciclici riprenderanno a comportarsi nel modo normale.
  238.  
  239.  
  240.  
  241.     PARAMETRI WORKBENCH E SHELL
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  243. CycleToMenu utilizza gli stessi nomi sia per i parametri Shell che
  244. Workbench.
  245.  
  246. Normalmente non è necessario modificare direttamente questi parametri perché
  247. è molto più comodo servirsi della finestra di configurazione. Gli unici
  248. parametri che si potrebbe avere la necessità di modificare sono CX_POPKEY e
  249. PUBSCREEN.
  250.  
  251.  
  252.   CX_POPKEY                    Valore predefinito: control alt y
  253.   ---------
  254. Questa è la hot-key (il tasto di richiamo) della finestra di configurazione.
  255. Consulta il manuale utente del Workbench per una descrizione completa della
  256. definizione delle hot-key.
  257.  
  258.  
  259.   CX_POPUP                     Valore predefinito: YES
  260.   --------
  261. Questo parametro indica se bisogna aprire la finestra di configurazione non
  262. appena viene lanciato il programma. Normalente si pone questo parametro
  263. uguale a NO.
  264.  
  265.  
  266.   CX_PRIORITY                  Valore predefinito: 0
  267.   -----------
  268. Questa è la priorità dell'handler delle commodity associato alla hot-key.
  269. Normalmente non c'è motivo di modificarlo.
  270.  
  271.  
  272.   PUBSCREEN                    Valore predefinito: lo schermo Workbench
  273.   ---------
  274. Questo è il nome dello schermo pubblico dove aprire la finestra di
  275. configurazione.
  276.  
  277.  
  278.   MAKEZOOM                     Valore predefinito: YES
  279.   --------
  280. Questo parametro corrisponde al gadget "Esegui zoom".
  281.  
  282.  
  283.   MINZOOMDURATION              Valore predefinito: 8
  284.   ---------------
  285. Questo parametro corrisponde al gadget "Durata minima".
  286.  
  287.  
  288.   MAXZOOMDURATION              Valore predefinito: 16
  289.   ---------------
  290. Questo parametro corrisponde al gadget "Durata massima".
  291.  
  292.  
  293.   USESCREENFONT                Valore predefinito: NO
  294.   -------------
  295. Questo parametro corrisponde al gadget "Usa caratteri schermo".
  296.  
  297.  
  298.   MINFONTSIZE                  Valore predefinito: 0
  299.   -----------
  300. Questo parametro corrisponde al gadget "Min altezza caratteri".
  301.  
  302.  
  303.   MINITEMS                     Valore predefinito: 0
  304.   --------
  305. Questo parametro corrisponde al gadget "Minimo numero di voci".
  306.  
  307.  
  308.   LOOK                         Valore predefinito: GADGET
  309.   ----
  310. Questo parametro corrisponde ai tre gadget di scelta del tipo di menu. Può
  311. assumere tre diversi valori:
  312.  
  313. MENU - corrisponde alla opzione "Come menu"
  314.  
  315. MAGICMENU - corrisponde alla opzione "Come MagicMenu"
  316.  
  317. GADGET - corrisponde alla opzione "Come gadget"
  318.  
  319.  
  320.   FORCENEWLOOKMENU             Valore predefinito: NO
  321.   ----------------
  322. Questo parametro corrisponde al gadget "Forza menu NewLook".
  323.  
  324.  
  325.   CENTRECURRENT                Valore predefinito: NO
  326.   ----------------
  327. Questo parametro corrisponde al gadget "Centra su voce corrente".
  328.  
  329.  
  330.   DOUBLEBORDER                 Valore predefinito: NO
  331.   ------------
  332. Questo parametro corrisponde al gadget "Doppio bordo".
  333.  
  334.  
  335.   INNERBORDER                  Valore predefinito: NO
  336.   -----------
  337. Questo parametro corrisponde al gadget "Bordo interno".
  338.  
  339.  
  340.   RECESSCURRENT                Valore predefinito: NO
  341.   -------------
  342. Questo parametro corrisponde al gadget "Rientra voce corrente".
  343.  
  344.  
  345.  
  346.     LIMITAZIONI
  347. ~~~~~~~~~~~~~~~~~~~
  348. CycleToMenu funziona con tutti quei programmi che utilizzano i gadget
  349. ciclici di sistema (quelli della gadtools.library), ma non funziona con quei
  350. programmi che invece simulano tali gadget (praticamente solo quei programmi
  351. che funzionano anche sotto AmigaOS 1.3).
  352.  
  353. Alcuni cattivi programmi non utilizzano il campo IntuiMessage->Code ma
  354. assumono semplicemente che ogni volta che il gadget viene premuto passa alla
  355. voce successiva. Ciò è sbagliato e contro le specifiche dettate dalla
  356. Commodore! Comunque, in questi casi, come accennato prima, è possibile
  357. rimediare premendo il gadget ciclico sopra l'immagine della freccia che
  358. ruota, ottenendo così il normale funzionamento dei gadget ciclici e
  359. aggirando quindi il problema.
  360.  
  361.  
  362.  
  363.     RINGRAZIAMENTI
  364. ~~~~~~~~~~~~~~~~~~~~~~
  365. Come sempre, desidero ringraziare i miei beta-tester per il loro prezioso
  366. aiuto: Nicola Salmoria, Dante Profeta e Stefano Iacus.
  367.  
  368. Un ringraziamento particolare va a Reinhard Spisser per la traduzione in
  369. Tedesco, a Ronald van Eijck per quella in Olandese e a Goncalves A. Georges
  370. per quella in Francese.
  371.  
  372. Infine voglio ringraziare tutti coloro che mi hanno mandato suggerimenti e
  373. bug-report.
  374.  
  375.  
  376.    __
  377.   |-
  378.   |ederico
  379.  
  380.