home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / grafix / flashmandel / docs / flashmandel.guide (.txt) < prev    next >
Encoding:
Amigaguide Document  |  1998-02-02  |  32.3 KB  |  516 lines

  1. @database FlashMandel.guide
  2. @author "Dino Papararo"
  3. @(c) "Copyright 
  4.  1998 Dino Papararo"
  5. @$VER: FlashMandel.guide 0.870 (02/02/99)
  6. @font courier.font 13
  7. @wordwrap
  8. @node Main "FlashMandel Guide"
  9. @{b}@{fg highlight}FlashMandel@{fg text}@{ub} 0.870 Copyright 1997 Dino Papararo
  10. Questo 
  11.  un altro programma per la generazione dell'@{"insieme di Mandelbrot" link Mandelbrot}.
  12.     @{"Installazione  " link Install}  Come installare il programma
  13.     @{"Richieste      " link Required}  Richieste minime del programma
  14.     @{"YAFG           " link YAFG}  @{fg highlight}Yet Another Fractal Generator@{fg text}
  15.     @{"Interfaccia    " link Interfc}  L'interfaccia del programma
  16.     @{"Caratteristiche" link Caratte}  Le caratteristiche peculiari
  17.     @{"Futuro         " link Futuro}  Il futuro del programma
  18.     @{"La Storia      " link History}  La storia e le versioni precedenti
  19.     @{"Autore         " link Autore}  I giusti riferimenti all'autore
  20.     @{"Ringraziamenti " link Ringra}  Le persone meritevoli...
  21.     @{"Copyright      " link CopyRg}  Le obbligatorie informazioni
  22. @endnode
  23. @node Install "Installazione"
  24. Per installare il programma basta spostare il cassetto "FlashMandel" nella directory desiderata.
  25. @{b}@{fg highlight}FlashMandel@{fg text}@{ub} non necessita comunque di assegnamenti, modifiche alla user-startup o librerie particolari.
  26. @next Required
  27. @endnode
  28. @node Mandelbrot "Informazioni su Mandelbrot"
  29. @prev Mandelbrot
  30. t Mandelbrot 
  31.  notoriamente l'inventore dei frattali. Nel 1975 coni
  32.  questo termine per riferirsi a forme auto-simili e frammentate, caratteristiche comuni di tutti i frattali che somigliano sempre a se stessi, anche se vengono ingranditi a varie scale e sono non-continui.
  33. L'@{fg highlight}insieme di Mandelbrot@{fg text} 
  34.  un frattale generato dalla formula matematica @{fg fill}Z = Z
  35. +c@{fg text}.
  36. Questa formula viene iterata varie volte nel campo complesso (ossia si prende un numero complesso, si fa il quadrato e gli si sottrae una costante, a questo numero risultato viene nuovamente applicato il procedimento); "@{i}varie volte@{ui}" 
  37.  proprio corrispondente alle "@{i}iterazioni@{ui}" che possono essere impostate nella stragrande maggioranza dei programmi che generano frattali.
  38. Il valore di questa iterazione pu
  39.  o convergere ad un numero finito o tendere all'infinito. Nel caso tenda all'infinito si assegna un particolare colore corrispondente alla velocit
  40.  di fuga sul piano complesso.
  41. Questo insieme 
  42.  il famoso @{"Pupazzo di Mandelbrot" link Mandelbrot.brush/main} che tutti conoscono.
  43. @next Mandelbrot
  44. @endnode
  45. @node Required "Richieste di sistema"
  46. @prev Install
  47. @{b}@{fg highlight}FlashMandel@{fg text}@{ub} non 
  48.  esoso di risorse.
  49. Funziona su un qualsiesi @{b}Amiga@{ub} che abbia almeno 512 Kb di ram, con qualsiesi processore, dal @{"68000 al 68060" link Processori} e qualsiesi @{"chip-set" link ChipSet}.
  50. Dalla versione 0.870 in poi per
  51.  necessario che il sistema operativo sia almeno il @{b}3.0@{ub}.
  52. Se sono presenti @{"Schede Grafiche" link ChipSet} esse sono supportate sia tramite @{fg highlight}Screen Database@{fg text} che i @{fg highlight}ToolTypes@{fg text}.
  53. @endnode
  54. @node YAFG "Yet Another Fractal Generator"
  55. "@{b}@{i}@{fg highlight}@{bg text}Perch
  56.  un altro generatore di frattali?@{bg back}@{fg text}@{ui}@{ub}"
  57.  per divertimento, questo 
  58.  il primo programma serio dell'@{"autore" link Autore}, ma anche perch
  59.  non esiste un programma del genere che si appoggi @{b}totalmente@{ub} al sistema operativo di @{b}Amiga@{ub} e non faccia, magari per essere un p
  60.  veloce, sporchi trucchi.
  61. Il programma al momento 
  62.  corto di 65 Kb, mentre altri programmi simili sono grandi centinaia di Kb, non supportano correttamente l'RTG, l'Overscan, il Mutitasking e magari scrivono direttamente nella Chip ram o chiss
  63.  dove...
  64. Ovviamente questo non vuol dire che non ci possano essere BUG !
  65. Per le altre caratteristiche leggere l'apposito nodo @{"Caratteristiche" link Caratte}.
  66. @endnode
  67. @node Interfc "L'interfaccia del programma"
  68. Poich
  69.  @{b}@{fg highlight}FlashMandel@{fg text}@{ub} si appoggia totalmente al sistema, rispettando la @{b}Style Guide@{ub} tutti i gadget, menu e requester sono di facile comprensione.
  70. Al lancio del programma, se non sono stati introdotti nuovi ToolTypes questo inizia a disegnare l'@{"insieme di Mandelbrot" link Mandelbrot.brush/main} tra le coordinate (-2.2,-1.125i) e (+0.8,+1.125i), con uno schermo di dimensioni 640 x 480 al massimo numero di colori supportati (256 sotto @{"AGA/RTG" link ChipSet} e 64 in ExtraHalfBrite sotto @{"ECS/OCS" link ChipSet}).
  71. Terminato il disegno compare il requester di about.
  72. Sulla barra dello schermo ci sono i seguenti parametri:
  73. @{b}Real@{ub} corrisponde alla attuale coordinata dell'asse reale.
  74. @{b}Imag@{ub} corrisponde alla attuale coordinata dell'asse immaginario.
  75. Queste due variabili cambiano continuamente durante lo spostamento del mouse sullo schermo.
  76. @{b}W:H@{ub} esprime il rapporto tra le dimensioni dello schermo.
  77. @{b}R:I@{ub} esprime il rapporto tra le dimensioni dell'insieme.
  78. Per una visualizzazione corretta queste variabili @{b}DEVONO@{ub} corrispondere !
  79. Nel caso non sia cos
  80.  @{b}NECESSARIO@{ub} andare nel @{b}@{fg highlight}Coordinates Requester@{fg text}@{ub} ShortCut @{b}@{fg highlight}Amiga C@{fg text}@{ub} e premere il pulsante @{b}@{fg highlight}Ratio@{fg text}@{ub}, quindi ricalcolare l'insieme con i nuovi valori ottenuti.
  81. Ci sono quattro menu che ovviamente prevedono gli shortcut da tastiera:
  82.     @{" Project " link Project}
  83.     @{" Options " link Options}
  84.     @{"Calculate" link Calculate}
  85.     @{"  Video  " link Video}
  86. Se si preme col tasto sinistro del mouse sul disegno del frattale, si disegna un rettangolo che corrisponder
  87.  alle nuove coordinate di un eventuale Zoom o Preview.
  88. Durante il rendering premendo il tasto @{b}@{fg highlight}Tab@{fg text}@{ub} si salta il @{"rettangolo corrente" link CProb}, premendo il tasto @{b}@{fg highlight}Esc@{fg text}@{ub} o selezionando il menu @{b}@{fg highlight}Stop@{fg text}@{ub} con il Mouse o da ShortCut @{b}@{fg highlight}Amiga X@{fg text}@{ub} si termina il calcolo del frattale.
  89. @next Caratte
  90. @endnode
  91. @node Project "Menu Project"
  92. @prev Interfc
  93. Sono presenti sette voci, @{b}About@{ub}, @{b}Load Picture@{ub}, @{b}Save Picture@{ub}, @{b}Load Palette@{ub}, @{b}Save Palette@{ub}, @{b}Print@{ub} e @{b}Quit@{ub}.
  94. @{b}About@{ub} produce lo stesso requester che compare all'inizio e d
  95.  informazioni sull'@{"Autore" link Autore} e sul gruppo di lavoro.
  96. Shortcut: @{b}Amiga A@{ub}
  97. @{b}Load Picture@{ub} permette di caricare un'immagine IFF precedentemente salvata, impostando correttamente i paramerti come quelli al momento del salvataggio.
  98. Shortcut: @{b}Amiga L@{ub}
  99. @{b}Save Picture@{ub} salva l'immagine corrente in IFF, con in aggiunta uno speciale @{b}Chunk@{ub} nel quale vengono memorizzate le coordinate del frattale e gli altri parametri di lavoro (iterazioni, tipo di mapping, ecc.). Cliccando su tale immagine dal Workbench verra' richiamato automaticamente il MultiView, che quindi deve essere nel Path di ricerca.
  100. Shortcut: @{b}Amiga S@{ub}
  101. @{b}Load Palette@{ub} carica una palette IFF, sia a se stante che da un'immagine IFF qualsiasi, attenzione ai colori perche' FlashMandel li utilizza a partire dal piu' alto contrariamente ad altri programmi simili...
  102. Shortcut: @{b}Amiga K@{ub}
  103. @{b}Save Palette@{ub} salva la palette corrente in formato IFF, utilizzabile da qualsiesi programma di editing grafico.
  104. Shortcut: @{b}Amiga J@{ub}
  105. @{b}Print@{ub} f
  106.  un'@{i}hard copy@{ui} dello schermo, ossia manda l'immagine corrente cosi' come 
  107.  sulla stampante, i settaggi sono quelli delle preferences.
  108. Shortcut: @{b}Amiga D@{ub}
  109. @{b}Quit@{ub} f
  110.  terminare il programma.
  111. Shortcut: @{b}Amiga Q@{ub}
  112. @endnode
  113. @node Options "Menu Options"
  114. Sono presenti sei voci: @{b}Title@{ub}, @{b}Limits@{ub}, @{b}Iterations@{ub}, @{b}Priority@{ub}, @{b}Color mapping@{ub}, @{b}Precision@{ub}.
  115. @{b}Title@{ub} 
  116.  un sottomenu che contiene un @{"flag booleano" link BoolFlag} che specifica se mostrare o meno la barra dello schermo (Shortcut: @{b}Amiga O@{ub}); se la barra manca 
  117.  possibile fare zoom anche in alto e premendo il tasto destro si potr
  118.  comunque accedere ai menu.
  119. Il sottomenu contiene anche l'indicazione @{b}Last time@{ub} (Shortcut: @{b}Amiga T@{ub}) che mostra sulla barra dei menu il tempo impiegato a calcolare l'ultimo frattale.
  120. @{b}Limits@{ub} mostra una finestra con alcuni gadget numerici e permette di inserire a mano i nuovi valori per le coordinate.
  121. I quattro @{"Button Gadget" link ButtGad}, prinpipali @{b}Accept Ratio Reset Cancel@{ub} permettono rispettivamente di accettare e rendere attivi i cambiamenti, adeguare l'aspect ratio delle coordinate dell'insieme alla dimensione dello schermo, riportare i valori a quelli originari e chiudere la finestra senza apportare modifiche alle coordinate.
  122. L'altro pulsantino invece serve solo a decidere quali delle due dimensioni dell'insieme lasciare inalterate per un eventuale adeguamento del rapporto tra le dimensioni del frattale e quelle dello schermo, di default vengono mantenute le coordinate reali dell'insieme.
  123. Shortcut: @{b}Amiga C@{ub}
  124. @{b}Iteration@{ub} 
  125.  un sottomenu in cui si pu
  126.  segliere il numero delle @{"iterazioni" link Mandelbrot}, o con valori predefiniti oppure scegliendolo a mano con un requester; va notato che a seconda del metodo di @{"mapping dei colori" link MappingCol} utilizzato, il miglior numero di iterazioni dovrebbe essere maggiore al numero dei colori dello schermo, infatti se questo non fosse vero si avrebbero alcuni colori inutilizzati. Questo parametro influenza enormemente il risultato finale, sia come resa grafica che come tempi di elaborazione !
  127. Il numero massimo di iterazioni consentite e' di 2^16.
  128. Shortcut: @{b}Amiga I@{ub} per un numero di iterazioni non predefinito.
  129. @{b}Priority@{ub} 
  130.  un sottomenu nel quale si pu
  131.  scegliere la priorit
  132.  del task tra -5 e +5 per non interferire con le normali attivit
  133.  dell'O.S.
  134. Shortcut: @{b}Amiga <n>@{ub} per impostare la priorit
  135.  a +<n> dove <n> 
  136.  un tasto numerico compreso tra 0 e 5.
  137. @{b}Amiga Shift <n>@{ub} per impostare la priorit
  138.  a -<n>.
  139. @{b}NOTA:@{ub} Al momento i tasti impostati per le priorit
  140.  negative sono relativi ai tasti di una tastiera italiana e quindi sono, in sequenza da -1 a -5, <@{b}!@{ub}> <@{b}"@{ub}> <@{b}
  141. @{ub}> <@{b}$@{ub}> <@{b}%@{ub}>
  142. @{b}Color mapping@{ub} 
  143.  un sottomenu che permette di scegliere il @{"mapping dei colori" link MappingCol}, ossia come debbanno essere messi in relazione iterazioni del punto in considerazione e colore della palette.
  144.     @{b}Repeated@{ub}  consente di ripetere i colori ciclicamente
  145.     @{b}Spread@{ub}    mappa i colori linearmente tra massima e minima iterazione
  146. @{b}Precision@{ub} permette di scegliere la @{"modalit
  147.  di calcolo" link IntIeee} tra intera e IEEE, la prima 
  148.  ultraveloce ma manca di precisione dopo un po', la seconda usa le normali funzioni di libreria e/o coprocessore matematico.
  149. @endnode
  150. @node Calculate "Menu Calculate"
  151. Sono presenti cinque voci: @{b}Preview@{ub}, @{b}ReCalculate@{ub}, @{b}UnDo@{ub}, @{b}Zoom@{ub}, @{b}Stop@{ub}.
  152. @{b}Preview@{ub} apre una finestra grande un quarto di schermo e vi disegna il frattale aggiornato alle nuove coordinate.
  153. Shortcut: @{b}Amiga W@{ub}
  154. @{b}ReCalculate@{ub} ridisegna il frattale sullo schermo, aggiornato ai vari parametri.
  155. Shortcut: @{b}Amiga R@{ub}
  156. @{b}UnDo@{ub} permette di tornare solo alle precedenti coordinate.
  157. Shortcut: @{b}Amiga U@{ub}
  158. @{b}Zoom@{ub} ridisegna il frattale tra le coordinate del rettangolo che viene selezionato.
  159. Shortcut: @{b}Amiga Z@{ub}
  160. @{b}Stop@{ub} ferma il disegno del frattale.
  161. Shortcut: @{b}Amiga X@{ub}, lo stesso risultato si ottiene premendo il tasto ESC.
  162. @endnode
  163. @node Video "Menu Video"
  164. Sono presenti quattro voci: @{b}Cycle@{ub}, @{b}Palette@{ub}, @{b}Screen mode@{ub}, @{b}Font settings@{ub}.
  165. @{b}Cycle@{ub} 
  166.  un sottomenu con tre opzioni:
  167.   @{b}Forward@{ub}  abilita il @{"ciclo dei colori" link ColCyc} in avanti (Shortcut: @{b}Amiga >@{ub}).
  168.   @{b}Backward@{ub} abilita il @{"ciclo dei colori" link ColCyc} all'indietro (Shortcut: @{b}Amiga <@{ub}).
  169.   @{b}Delay@{ub}    permette di impostare il ritardo (in cinquantesimi di secondo) tra i cambi di colore (Shortcut: @{b}Amiga -@{ub}).
  170. @{b}Palette@{ub} apre un @{"Palette requester" link PalReq} che permette di cambiare i colori della palette.
  171. @{b}Screen mode@{ub} apre un requester ASL e permette di scegliere la modalit
  172.  video in cui tracciare il frattale; sono ovviamente supportate anche le modalit
  173.  video di schede grafiche che aggiornino lo @{fg highlight}Screen Database@{fg text}.
  174. Comunque e' bene sottolineare che attualmente @{b}FlashMandel@{ub} gestisce al massimo una palette di 256 colori, quindi di soli 8 bitplane, e perci
  175.  addirittura controproducente, causa un rallentamento nel rendering, selezionare schermi con pi
  176.  di 256 colori.
  177. @{b}Font settings@{ub} permette di cambiare i caratteri sullo schermo per una migliore lettura, specialmente alle risoluzioni piu' alte.
  178. @next Interfc
  179. @endnode
  180. @node BoolFlag "Flag Booleano"
  181. @prev BoolFlag
  182. Un flag Booleano ha solo due stati, acceso/spento, zero/uno, in questo caso determina se la barra dello schermo deve essere presente o meno.
  183. (@{fg fill}Non pensavo che ci fosse gente che non lo conoscesse...@{fg text})
  184. @next BoolFlag
  185. @endnode
  186. @node ButtGad "Button Gadget"
  187. @prev ButtGad
  188. Un @{b}Button Gadget@{ub} 
  189.  un Gadget (elemento selezionabile dell'interfaccia) che pu
  190.  essere premuto per far eseguire qualche funzione.
  191. (@{fg fill}Non pensavo che ci fosse gente che non lo conoscesse...@{fg text})
  192. @next ButtGad
  193. @endnode
  194. @node PalReq "Palette Requester"
  195. @prev PalReq
  196. Il @{b}Palette Requester@{ub} 
  197.  una finestra che permette di cambiare i colori della palette (la tavolozza dei colori).
  198. Questa finestra 
  199.  composta da svariati gadget. Il primo 
  200.  un rettangolo che contiene tutti i colori modificabili, selezionandone uno si potr
  201.  operare sulle sue componenti cromatiche. I colori sono ordinati da sinistra a destra e dall'alto al basso, il primo colore 
  202.  quello in alto a sinistra, il secondo quello successivo; terminata una riga il colore successivo 
  203.  quello all'inizio della riga successiva.
  204. Il gadget @{b}Copy@{ub} permette di copiare il colore selezionato in un'altra posizione. Dopo aver selezionato il colore da copiare e aver premuto @{b}Copy@{ub} bisogner
  205.  selezionare il colore di destinazione e premere il gadget @{b}Paste@{ub}.
  206. Il gadget @{b}Paste@{ub} copia effettivamente nella posizione corrente il colore copiato precedentemente con il gadget @{b}Copy@{ub}.
  207. Il gadget @{b}Spread@{ub} sfuma i colori compresi tra quello selezionato al momento della pressione del gadget e il colore che si selezioner
  208.  successivamente.
  209. Il gadget @{b}UnDo@{ub} permette di annullare solo l'ultima operazione compiuta.
  210. I tre gadget di scorrimento permettono di modificare le componenti di rosso (R), verde (G) e blu (B) del colore corrente.
  211. Oltre che con il mouse 
  212.  possibile utilizzarli da tastiera con i tasti 'E'-'T' per rispettivamente diminuire-aumentare la quantita' di rosso, 'F'-'H' per il verde, 'V'-'N' per il blu.
  213. I tre gadget @{b}Accept@{ub}, @{b}Reset@{ub} e @{b}Cancel@{ub} in basso permettono rispettivamente di accettare le nuove impostazioni cromatiche, ripristinare le impostazioni originali e chiudere la finestra senza effettuare cambiamenti.
  214. @next PalReq
  215. @endnode
  216. @node ColCyc "Color Cycling"
  217. @prev ColCyc
  218. Il @{i}Cycling dei colori@{ui} 
  219.  una funzione che permette di creare una specie di animazione in un disegno, spostando i colori della palette.
  220. Se abbiamo un'immagine contenente una @{"barra colorata" link Bar.brush/main} con una scala di colori e in seguito copiamo il primo colore nel secondo, il secondo nel terzo e cos
  221.  via otteniamo l'effetto di far animare la barra, di farla scorrere.
  222. L'@{"insieme di Mandelbrot" link Mandelbrot} generato da questo programma (e da molti altri) ha la propriet
  223.  che velocit
  224.  di fuga vicine corrispondano a colori vicini nella palette. Per cui la rotazione della palette, in questo caso, genera un piacevole effetto.
  225. @next ColCyc
  226. @endnode
  227. @node MappingCol "Color Mapping"
  228. @prev MappingCol
  229. Sono previste due modalit
  230.  di Color Mapping, quella di default ossia la Spread 
  231.  quella che maggiormente si avvicina alla realt
  232.  assegnando ai vari punti dell'insieme un colore univoco. A tutti i punti del piano complesso che presentano una velocit
  233.  di fuga simile viene assegnato un colore a partire dalla parte alta della palette (in basso a destra del Palette Requester) fino via via ad arrivare alla parte bassa man mano che ci si addentra nei meandri del frattale. Una volta esauriti i colori 
  234.  necessrio aumentare il numero di iterazioni per punto cos
  235.  che ritornano disponibili anche i colori pi
  236.  in alto.
  237. Inoltre ho previsto anche la classica e forse meno accattivante tecnica del Repeat che assegna ad ogni punto con una velocit
  238.  di fuga diversa un colore diverso fino all'ultimo disponibile, dopodich
  239.  si riparte dal primo e cos
  240.  via...
  241. E' indispensabile che le Iterazioni siano sempre maggiori (15-25% in pi
  242.  del numero dei colori per i primi zoom fino via via ad aumentare) del numero massimo dei colori, pena la perdita cromatica nella resa a video.
  243. @next MappingCol
  244. @endnode
  245. @node Caratte "Caratteristiche (peculiari) del programma"
  246. @prev Interfc
  247. Il programma rispetta totalmente l'O.S. e il Multitasking, fa uso solo delle funzioni di libreria standard, non sono stati rilevati Enforcer o Mungwall Hit.
  248. E' stato testato con il Kickstart @{b}3.0 A-1200@(ub) standard e Omega 1200,  @{b}Amiga 4000@{ub} con 060/PPC604 + CV64, e con il @{b}3.1@{ub} @{b}Amiga 2000@{ub} con GVP Combo + CV643D.
  249. Sfrutta qualsiasi modo video presente nello @{fg highlight}Screen Database@{fg text}, quindi anche quelli aggiunti da eventuali schede grafiche.
  250. Usa matematica @{i}@{"Fixed Point" link IntIeee}@{ui} a 32 bit per aumentare la velocit
  251.  di calcolo su computer senza FPU.
  252. Nella versione @{i}IEEE@{ui} usa le librerie matematiche a doppia precisione avere maggior profondit
  253.  e sfruttare il coprocessore se presente.
  254. Nella versone @{i}FPU@{ui} aumenta l'efficienza della FPU utilizzandola direttamente.
  255. Il disegno del frattale sfrutta le caratteristiche di @{"continuit
  256.  probabilistica" link CProb} dell'@{"insieme di Mandelbrot" link Mandelbrot}, che permette di abbreviare i tempi nel rendering di aree che hanno la stessa velocit
  257.  di fuga.
  258. Utilizza i ToolTypes per una corretta configurazione.
  259. Sono contenuti i sorgenti.
  260. @endnode
  261. @node Futuro "Il futuro del programma"
  262. Come avrete notato la versione attuale 
  263.  la 0.870 ossia non 
  264.  la versione definitiva. Mancano alcune piccole migliorie come:
  265. @{b}1)@{ub} Il supporto del PowerPC !
  266. @{b}2)@{ub} La documentazione in pi
  267.  lingue.
  268. @{b}3)@{ub} Il supporto per la @{fg highlight}Locale.library@{fg text}.
  269. @{b}4)@{ub} Una rappresentazione 3D dell'immagine calcolata.
  270. @{b}5)@{ub} Il supporto per insiemi diversi da quello di @{"Mandelbrot" link Mandelbrot} come quelli di Julia e di Lyapunov.
  271. @{b}6)@{ub} Una versione a 128 bit delle funzioni Fixed Point.
  272. @{b}7)@{ub} Eventuali richieste...
  273. Comunque non vi sono bug o effetti collaterali conosciuti.
  274. Sono graditi suggerimenti o segnalazioni di eventuali bug da mandare all'@{"autore" link Autore} via posta normale o all'indirizzo E-Mail @{fg fill}DinoP@IName.Com@{fg text}.
  275. @next History
  276. @endnode
  277. @node History "La storia di FlashMandel"
  278. @prev Futuro
  279. @{b}@{fg highlight}FlashMandel 0.870@{fg text}@{ub}
  280.  Implementati ToolTypes.
  281.  Implementato Font requester.
  282.  Implementato Ratio button nel Coordinates requester.
  283.  Cambiate coordinate di partenza.
  284.  Cambiata barra del titolo dello schermo.
  285.  Fissata risoluzione minima di schermo a 640x480.
  286.  Riscritta documentazione.
  287.  Eliminato script di installazione.
  288.  Aggiunte palettes e pictures a 256 colori.
  289.  Eliminati alcuni potenziali bug e effetti collaterali specialmente su RTG.
  290. @{b}@{fg highlight}FlashMandel 0.810@{fg text}@{ub}
  291.  Aperto lo schermo con un certo numero di colori era possibile solo diminuirli.
  292.  Corretto bug nel cycle per il riconoscimento di uno schermo EHB.
  293.  Agiunto controllo da tastiera per le varie componenti R,G,B del palette requester.
  294.  Aggiunte altre palette a 256 colori e diminuite quelle a 32.
  295.  Aggiunte altre pictures.
  296.  Varie modifiche minori al codice.
  297.  Ricompilato con il SAS C 6.58.
  298.  Aggiornata la documentazione.
  299.  Riveduto lo script di install.
  300. @{b}@{fg highlight}FlashMandel 0.700@{fg text}@{ub}
  301.  Aggiunti i moduli di @{b}Load@{ub} e @{b}Save@{ub} per immagini e palette.
  302.  Migliorata l'apertura dello schermo iniziale.
  303.  Corretti molti piccoli Bug.
  304. @{b}@{fg highlight}FlashMandel 0.100@{fg text}@{ub}
  305.  Aggiunto il @{"ciclo dei colori" link ColCyc}.
  306.  Aggiunto un @{"Palette Requester" link PalReq}.
  307.  Eliminati le funzioni relative ai particolari processori e aggiunte versioni interamente compilate per @{"processori diversi" link Processori}.
  308.  Metodo di calcolo del frattale secondo la @{"continuit
  309.  probabilistica" link CProb} migliorato per evitare di ricalcolare pi
  310.  volte gli stessi punti.
  311.  Aggiunti diversi tipi di @{"mapping dei colori" link MappingCol}.
  312.  Aggiunto uno @{"script d'istallazione" link Install}.
  313.  Corretti alcuni bug nel programma e nella documentazione.
  314. @{b}@{fg highlight}FlashMandel 0.99@{fg text}@{ub}
  315.  Versione inizialmente rilasciata.
  316. @next Ringra
  317. @endnode
  318. @node Autore "L'autore di FlashMandel"
  319. @prev RBrandner
  320. Indirizzo posta normale:
  321.     @{fg highlight}Dino Papararo@{fg text}
  322.     Via Manzoni 184
  323.     80123 Napoli
  324.         Italia
  325. Indirizzo E-Mail:
  326.         DinoP@IName.Com
  327. Indirizzo FidoNet:
  328.         2:335/202.50
  329. Autore del codice di @{b}@{fg highlight}FlashMandel@{fg text}@{ub}.
  330. @next CPucci
  331. @endnode
  332. @node CPucci "Prezioso collaboratore"
  333. @prev Autore
  334. Indirizzo posta normale:
  335.     @{fg highlight}Claudio Pucci@{fg text}
  336.     Via Umberto Viale 2
  337.     56124 Pisa  
  338.         Italia
  339. Indirizzo E-Mail:
  340.     E-Mail: @{fg fill}PucciC\@Cli.Di.UniPi.It@{fg text}
  341. Ha realizzato la prima documentazione in @{b}AmigaGuide@{ub}, i vecchi script d'installazione non pi
  342.  supportati, e ha collaborato alla risoluzione di alcuni problemi riscontrati nel 
  343. -testing e alla stesura di piccoli pezzi di codice.
  344. @next LDPietra
  345. @endnode
  346. @node LDPietra "Per le iniziali spiegazioni sui Fixed Point"
  347. @prev CPucci
  348.     @{fg highlight}Lelio della Pietra@{fg text}
  349. Ha spiegato le operazioni fondamentali della matematica in Fixed Point.
  350. @next STassi
  351. @endnode
  352. @node STassi "Fondamentale Beta tester"
  353. @prev LDPietra
  354.     @{fg highlight}Sergio Tassi@{fg text}
  355. Ha svolto il lavoro fondamentale di beta testing su di un A-1200 NF, ha curato le palette del programma, e l'aspetto estetico della GUI.
  356. @next GStaffelli
  357. @endnode
  358. @node GStaffelli "Per il debug su CGX"
  359. @prev STassi
  360.     @{fg highlight}Giuseppe Staffelli@{fg text}
  361. Ha svolto il lavoro di debug su CyberGraphix.
  362. @next RBrandner
  363. @endnode
  364. @node RBrandner "Autore di un altro generatore di frattali"
  365. @prev GStaffelli
  366.     @{fg highlight}Robert Brandner@{fg text}
  367.     Austria
  368. Ha creato un altro programma di generazione dei frattali, dal quale @{b}@{fg highlight}FlashMandel@{fg text}@{ub} 
  369.  derivato. Il suo programma era stato scritto in ModulaII nel lontano 1991, e gi
  370.  possedeva l'ottimizzazione del disegno secondo le propriet
  371.  dell'@{"insieme di Mandelbrot" link Mandelbrot} ossia la @{"continuit
  372.  probabilistica" link CProb}.
  373. Naturalmente @{b}@{fg highlight}FlashMandel@{fg text}@{ub} 
  374.  una netta evoluzione del progetto originale il quale ai tempi d'oggi 
  375.  completamente obsoleto e mal scritto... (@{"Dino Papararo" link Autore})
  376. @next TFerMGie
  377. @endnode
  378. @node TFerMGie "Autori di Mandel-92"
  379. @prev RBrandner
  380.     @{fg highlight}Tobias Ferber e Martin Giese@{fg text}
  381. Hanno scritto un programma di calcolo dei frattali (Mandel-92) che conteneva una funzione di calcolo della velocit
  382.  di fuga di un punto di un frattale che utilizzava una matematica @{"Fixed Point" link IntIeee} di tipo 4+28 da cui l'autore ha sviluppato la propria routine di calcolo.
  383. @next Autore
  384. @endnode
  385. @node Ringra "I doverosi ringraziamenti"
  386. @prev History
  387. L'@{"autore" link Autore} deve ringraziare varie persone per il supporto datogli durante la stesura del codice e lo sviluppo del progetto:
  388. @{"Lelio della Pietra" link LDPietra} per le spiegazioni sui Fixed Point.
  389. @{"Claudio Pucci" link CPucci} per il lavoro di debugging svolto (mandando i sorgenti e le varie pre-versioni da Napoli a Pisa prima con un vecchissimo modem a 2400 BAUD e in seguito tramite posta) e per la prima versione della documentazione in @{b}AmigaGuide@{ub}, i vecchi @{"script d'istallazione" link Install} non piu' supportati e la intelligente funzione per il Cycle dei colori.
  390. @{"Sergio Tassi" link STassi} per il beta testing, le palette e la gui.
  391. @{"Giuseppe Staffelli" link GStaffelli} per il debug su CGX.
  392. @{"Robert Brandner" link RBrandner} per un vecchio programma di frattali da cui l'autore ha avuto lo spunto per iniziare @{b}@{fg highlight}FlashMandel@{fg text}@{ub}.
  393. @{"Tobias Ferber e Martin Giese" link TFerMGie} per una funzione di calcolo della velocit
  394.  di fuga di un punto di un frattale che utilizzava matematica @{"Fixed Point" link IntIeee} da cui l'autore ha sviluppato le proprie routine.
  395. @endnode
  396. @node CopyRg "Informazioni di CopyRight"
  397. Il programma @{b}@{fg highlight}FlashMandel@{fg text}@{ub} 
  398.  GiftWare, mandate un qualsiasi regalo all'@{"autore" link Autore} se lo ritenete meritevole.
  399. USATE @{b}@{fg highlight}FlashMandel@{fg text}@{ub} A VOSTRO RISCHIO E PERICOLO, NON C'E' NESSUNA GARANZIA DI FUNZIONAMENTO, DI STABILITA' O CHE NON VI FORMATTI L'HARD DISK, CHE VI PIANTI LA MACCHINA UN SECONDO PRIMA DI RAGGIUNGERE IL RISULTATO CHE ASPETTAVATE DOPO GIORNI E GIORNI DI CALCOLI. L'@{"AUTORE" link Autore} NON E' NE' SI SENTIRA' RESPONSABILE DI NULLA.
  400. Nessuna parte o pezzo di @{b}@{fg highlight}FlashMandel@{fg text}@{ub} pu
  401.  essere utilizzata a fini di lucro, tuttavia pu
  402.  liberamente essere incluso in qualsivoglia raccolta di programmi Public Domain, ShareWare, GiftWare, ecc. purch
  403.  non venga chiesta una cifra troppo elevata. Sono liberi di includere questo programma le raccolte Fred Fish e i CD di Aminet.
  404. @next CopyRg
  405. @endnode
  406. @node Processori "I processori supportati"
  407. @prev Processori
  408. Sono supportati tutti i processori Motorola
  409.  della famiglia 68000.
  410. Nell'archivio vengono rilasciate le versioni per 68000, 68020+68881 e 68060, si possono tranquillamente eliminare quelle superflue e rinominare quella pi
  411.  adatta al vostro sistema in "FlashMandel".
  412. Non sono rilasciate versioni compilate per 68010, 68020, 68030 (+68881/2) e 68040 perch
  413.  non c'
  414.  nessun miglioramento rispetto alle versioni fornite.
  415. @next Processori
  416. @endnode
  417. @node ChipSet "I chipset supportati"
  418. @prev ChipSet
  419. Sono supportati tutti i chipset originali @{b}Amiga@{ub}, l'@{b}OCS@{ub}, l'@{b}ECS@{ub} e l'@{b}AGA@{ub}. Il programma si adatta a quello posseduto, permettendo un massimo di 64 colori (in ExtraHalfBrite) con @{b}OCS@{ub} e @{b}ECS@{ub}, e schermi fino a 256 colori sotto @{b}AGA@{ub}.
  420. Se sono presenti schede grafiche che aggiungono propri schermi allo @{fg highlight}Screen Database@{fg text}, il programma sfrutter
  421.  tali schermi in qualsiesi risoluzione sempre con una limitazione di 256 colori, al momento.
  422. @next ChipSet
  423. @endnode
  424. @node IntIeee "Differenze tra Matematica fixed point e IEEE"
  425. @prev IntIeee
  426. @{b}@{fg highlight}FlashMandel@{fg text}@{ub} sfrutta due diversi tipi di calcolo che hanno i rispettivi vantaggi e svantaggi:
  427. @{b}Fixed Point@{ub} 
  428.  una matematica che divide la parte intera dalla parte decimale di un numero sempre nello stesso numero di bit (in questo caso 1 bit di segno 3 bit di intero e 28 bit di virgola fissa). Le funzioni usate utilizzano 32 bit di precisione (una LongWord) e sono molto veloci, hanno lo svantaggio di perdere velocemente di precisione nella parte decimale (non sono infatti pi
  429.  precise di "uno su due alla 27" dovuto agli errori nelle approssimazioni). La funzione in Fixed Point prende spunto da quella di Mandel-92 programma per il calcolo dei frattali scritto da @{"Tobias Ferber" link TFerMGie} e @{"Martin Giese" link TFerMGie} che l'@{"autore" link Autore} ha fortemente ottimizzato.
  430. Avendo soli tre bit di precisione per gli interi, che possono rappresentare numeri tra -8 e +8, non si pu
  431.  disegnare il frattale al di fuori di questo intervallo numerico.
  432. @{b}IEEE@{ub} 
  433.  la matematica standard che viene usata dalla stragrande maggioranza dei processori, 
  434.  lenta perch
  435.  usa la virgola mobile ma ha una maggiore precisione; se presente il coprocessore matematico viene sfruttato oltre che con le versioni appositamente compilate anche con la libreria IEEE di sistema che lo riconosce automaticamente.
  436. @next IntIeee
  437. @endnode
  438. @node CProb "Continuit
  439.  Probabilistica"
  440. @prev CProb
  441. @{b}@{fg highlight}FlashMandel@{fg text}@{ub} sfrutta la propriet
  442.  dell'@{"insieme di Mandelbrot" link Mandelbrot} nota come @{b}Continuit
  443.  Probabilistica@{ub} ossia:
  444. @{b}@{i}Dato un rettangolo sul piano complesso contenente l'@{"insieme di Mandelbrot" link Mandelbrot}, se tutti i punti sui contorni del rettangolo hanno la stessa velocit
  445.  di fuga allora 
  446.  "molto probabile" che anche l'area all'interno abbia la medesima velocit
  447.  di fuga.@{ui}@{ub}
  448. Il programma traccia i bordi del rettangolo da disegnare e se questi hanno il medesimo colore riempie l'area con il colore stesso, altrimenti divide il rettangolo in due parti e ricomincia nuovamente sui due rettangoli generati ricorsivamente, con una strategia detta @{i}divide et impera@{ui}.
  449. Una spiegazione del @{i}probabilistico@{ui} si pu
  450.  capire se si f
  451.  tracciare al programma l'area del piano complesso di coordinate (-8,-8i) (8,8i), che riempie tutta con un colore uniforme; non 
  452.  un bug del programma, ha solo fatto un errore in probabilit
  453. @next CProb
  454. @endnode
  455. @{b} @database <name> @{ub}
  456. This command must always be the very first line of the @{b}AmigaGuide@{ub} database.
  457. @{b}@{fg highlight} @author <name> @{ub}@{fg text}
  458. Specify the author of the database.
  459. @{b}@{fg highlight} @(c) <copyright> @{ub}@{fg text}
  460. The copyright notice for the database.
  461. @{b}@{fg highlight} @$VER: <AmigaDOS version string> @{ub}@{fg text}
  462. Used to specify the version of the database.  This command must always be in upper-case.
  463. @{b} @master <name> @{ub}
  464. Used to specify the source file for the database.
  465. @{b}@{fg highlight} @font <name> <size> @{ub}@{fg text}
  466. Specify the font to use for a database.
  467. @{b} @index <name/node> @{ub}
  468. Specify the name of the index node, accessed by the @{"  Index  " beep 0} button.  Can be a node in an external database.
  469. @{b} @help <name/node> @{ub}
  470. Specify the name of the help node, accessed by the @{"  Help  " beep 0} button or the help key on the keyboard.  Can be a node in an external database.
  471. @{b}@{fg highlight} @wordwrap @{ub}@{fg text}
  472. Turn wordwrap on for the database.
  473. @{b} @node <name> [title] @{ub}
  474. Start a node.
  475. @{b} @dnode <name> [title] @{ub}
  476. Start a dynamic node.  The dynamic node hosts are queried for the node data.
  477. @{b} @remark <remark> @{ub}
  478. Remark (not displayed to the user).
  479. The following commands can be used within a node.
  480. @{b} @title <title> @{ub}
  481. The title for the node.
  482. @{b} @toc <name> @{ub}
  483. Specify the name of the Contents node for this node.  Can be a node in an external database.
  484. @{b} @prev <name> @{ub}
  485. Specify the name of node to go to when the @{" Browse < " beep 0} button is pressed.
  486. @{b} @next <name> @{ub}
  487. Specify the name of node to go to when the @{" Browse > " beep 0}  button is pressed.
  488. @{b}@{fg highlight} @keywords <keywords> @{ub}@{fg text}
  489. Keywords assigned to a node.  Used when searching for a node.
  490. @{b}@{fg highlight} @font <name> <size> @{ub}@{fg text}
  491. Specify the font to use within the node.
  492. @{b} \@{<label> <command>} @{ub}
  493. Indicate a textual link point.  Can be anywhere in a line.  This is displayed as a button within the text.
  494. Starting with 3.0 @{b}AmigaGuide@{ub}, buttons can also link to graphics, sounds and other datatypes.  See @{"Amiga" link amiga.brush/main}.
  495. @{b} @endnode @{ub}
  496. End a node.
  497. The following list of attributes can be applied to the text.  This feature is only supported with the 3.0 version of @{b}AmigaGuide@{ub}.
  498.  \@{b}        Turns @{b}bold@{ub} on.
  499.  \@{ub}        Turns @{b}bold@{ub} off.
  500.  \@{i}        Turns @{i}italic@{ui} on.
  501.  \@{ui}        Turns @{i}italic@{ui} off.
  502.  \@{u}        Turns @{u}underline@{uu} on.
  503.  \@{uu}        Turns @{u}underline@{uu} off.
  504. The foreground, or text, color can be changed using the \@{fg <color>} command.  The background color can be changed using the \@{bg <color>} command.  <color> can be:
  505.   @{fg text}text@{fg text}
  506.   @{fg shine}shine@{fg text}
  507.   @{fg shadow}shadow@{fg text}
  508.   @{fg fill}fill@{fg text}
  509.   @{fg filltext}filltext@{fg text}
  510.   @{fg back}@{bg text}background@{fg text}@{bg back}
  511.   @{fg highlight}highlight@{fg text}
  512. Commands can be displayed as normal text, by preceeding the @ sign with a backslash.  For example:
  513.   \\@{"Fake" link Main}
  514. would show up as normal text within the database.
  515. @endnode
  516.