@database AFoil.guide

@author Roberto Sala
@$VER: AFoil V2.3 (30-Oct-2001)
@font courier.font 13

@Width 70
@TAB 3


@node Main "AFoil.guide"

                        @{B}    AFoil 2.3
                         di Roberto Sala
                     30-Oct-2001 v2.3 © 2001 @{UB}


        Tavola dei Contenuti

        @{" Avvertenze    " link "Avvertenze"}
        @{" CopyRight     " link "CopyRight"}
        @{" Scopo         " link "Scopo"}
        @{" Requisiti     " link "Requisiti"}
        @{" Funzioni      " link "Funzioni"}
        @{" Installazione " link "Installazione"}
        @{" Formato File  " link "FormatoFile"}
        @{" Compatibilità " link "Compatibilita"}
        @{" Futuro        " link "Futuro"}
        @{" Contatti      " link "Contatti"}
        @{" History       " link "History"}


@endnode



@node Avvertenze

@{B} Avvertenze @{UB}


Questo software è fornito 'così com'è', senza alcuna garanzia
di alcuna natura sulla sua funzionalità e sugli effetti derivanti
dalla sua installazione ed uso corretto o meno che sia.
In nessun caso l'autore è ritenuto responsabile per danni
diretti, indiretti, impliciti od espliciti a persone, cose e/o entità
di qualunque natura.

@endnode



@node CopyRight

@{B} CopyRight @{UB}


AFoil è copyright di Sala Roberto ed è un software totalmente
FreeWare.

Questo software è liberamente distribuibile a patto di mantenere
integro l'archivio 'lha' così come fornito dall'autore che
comunque detiene tutti i diritti su tale software.

L'autore diffida, altresì, chiunque dalla copia a scopo di lucro
di tale software. E' ammessa solo il pagamento del puro
supporto informatico utilizzato per la distribuzione e comunque
sempre nel rispetto delle leggi vigenti in materia di copyright.

Chiunque venga in possesso di copie manomesse di questo software
o di copie illegali a scopo di lucro, è moralmente obbligato
ad avvisare l'autore



Ogni marchio citato in questo documento è copyright del
rispettivo autore.

@endnode



@node Scopo

@{B} Scopo @{UB}


AFoil permette di plottare a video e successivamente su stampante
un qualsiasi profilo aereonautico utilizzato nella realizzazione
di aereomedelli in scala tipici del modellismo dinamico o RC.

Fornendo un file ASCII contenente, con opportuna sintassi, la tabella
delle coordinate (per punti cartesiani) rappresentanti il profilo
desiderato, AFoil crea un profilo continuo tramite l'interpolazione BSpline.

Sono disponibili in internet molti siti dove vi si trova interi
database contenenti tutti (o quasi) i profili più noti ed usati
nell'aereomodellismo (NACA, E, ecc...). Questi file sono tipicamente
ascii e quindi semplicemente convertibili nel formato per AFoil.



@endnode



@node Requisiti

@{B} Requisiti @{UB}


Gli elementi necessari per un corretto funzionamento di AFoil sono:

- Un Amiga (ovviamente!!!).
- WorkBench 3.0
- Font CGTimes correttamente installato (font scalabile).
- Una stampante grafica ed il relativo driver di sistema.

@endnode



@node Funzioni

@{B} Funzioni @{UB}


L'elenco delle funzionalità di AFoil sono:

- Totale indipendenza dal display grafico usato
  (viene clonato lo schermo WB anche su scheda grafica).

- Preview del profilo a video con rispetto della scala.

- Totale customizzazione del profilo da plottare tramite
  il file descrittore del profilo in ASCII.

- Numero di punti massimi da interpolare 50.

- Possibilità di programmare la dimensione del profilo
  stampato in millimetri, da un minimo di 40 mm
  ad un massimo dipendente dalla RAM necessaria ad AFoil
  per compiere l'operazione.

- Stampa su più pagine A4 per profili di dimensione superiore
  a 265 mm.

- Settaggio della stampante automatico, il programma setta la
  stampante autonomamente senza che l'utente debba toccare
  le preference di sistema.

- Possibilità di regolare la densità di stampa.

- Possibilità di impostare la stampa orrizontale o verticale.

- Totalmente localizzato in puro stile AmigaOS.


@endnode



@node Installazione

@{B} Installazione @{UB}


Per installare AFoil basta decomprimere l'archivio
con l'opzione

lha x AFoil.lha

direttamente nella directory desiderata e copiare il file
di catalogo nella rispettiva directory per la propria lingua.


Unico problema è se non si ha i font CompuGraphics installati nel sistema.
In tal caso occorre installare il font CGTimes tramite floppy
o CD d'installazione di AmigaOS.

@endnode



@node FormatoFile

@{B} Formato File @{UB}


Il file d'input prevede 6 campi (linee):

1) Keyword: La prima linea DEVE sempre contenere la keyword #spline#,
            questo per permettere al programma di discriminare semplicemente
            un file contenente le informazioni adatte.

2) Name   : Una stringa ascii rappresentante il nome del profilo a cui i dati
            si riferiscono. Tale stringa sarà quella usata in stampa e preview.

3) SupAsseX: Coordinate X dei punti da interpolare che rappresentano la parte
             superiore del profilo.

4) SupAsseY: Coordinate Y dei punti da interpolare che rappresentano la parte
             superiore del profilo.

5) InfAsseX: Coordinate X dei punti da interpolare che rappresentano la parte
             inferiore del profilo.

6) InfAsseY: Coordinate Y dei punti da interpolare che rappresentano la parte
             inferiore del profilo.


La precisione dei numeri utilizzati è quella tipica dei float in Amiga con
matematica standard.

Un massimo di 10 cifre (compreso il segno e virgola) sono ammesse per la
rappresentazione ASCII dei numeri in virgola mobile.

E' NECESSARIO usare il punto decimale per indicare la virgola.

Il numero di punti viene dedotto automaticamente dal software, ma vi è il limite
intrinseco al software di 50.

L'unico vincolo tra il numero di punti delle varie coordinate è, ovviamente,
che il numero di punti X corrisponda al numero di punti Y della relativa
parte del profilo (superiore od inferiore).

Non vi è alcun limite tra i valori delle X ed Y sia superiori che inferiori.


@endnode



@node Compatibilita

@{B} Compatibilità @{UB}


Io l'ho testato molto con il mio Amiga così configurato:

- Amiga OS 3.0
- A4000-40 25MHz
- 18MByte RAM
- 3.6 GByte HD0, 512MByte HD1
- CyberVision 3D con cybergraphic
- SCSI Oktagon, CDROM SCSI 4X, ZIP 100MByte, Scanner SCSI
- Stampante Epson, driver di sistema Epson.



@endnode



@node Futuro

@{B} Futuro @{UB}


- Stampa di uno stesso profilo ripetuto in varie misure
  sullo stesso foglio.

- Aggiunta di una retta inclinata per indicare l'incidenza in gradi.

- Gestione, con GUI, della fase di stampa. Possibilità di stampa di solo
  alcune pagine e del numero di copie.


@endnode



@node Contatti

@{B} Contatti @{UB}


Se ritenete tale software utile vi sarei molto grato se mi invierete
una mail al mio address:


Roberto Sala    odissy@tiscalinet.it


con commenti e/o suggerimenti.

@endnode





@node History

@{B} History @{UB}


V1.0  10-Oct-95

- Prima release.



V1.1  15-Nov-95

- Risolti alcuni problemi sull'apertura della
  stampante e l'invio dei comandi di stampa.



V2.0  10-Feb-2001

- Completo rework del software.

- Modificata routine di Dump grafico verso la stampante.



V2.1  17-Feb-2001

- Aggiunta finestra di attesa in stampa.

- Corretti alcuni bug sulla correzione della dimensione
  del profilo stampato in Landscape.

- Aggiunto tratteggio di zero cartesiano sul profilo.

- Aggiunta completa localizzazione del programma.



V2.2  03-Mar-2001

- Svincolato il numero di punti X ed Y tra le coordinate
  superiori e quelle inferiori.

- Aggiunto controllo spessore linea di stampa.

- Aggiunto setting per FormFeed a fine stampa.

- Prima release Pubblica.



V2.3  30-Oct-2001

- Risolto il problema dato dall'uscita del programma in
  presenza di un errore nell'allocare le risorse di sistema.

- Aggiunta possibilità di stampare profili grandi su
  più pagine A4.

- Aggiunta indicazione di pagina in stampa.

- Modificato Catalog file (v2.3).

@endnode
