Short:      3D graphics shared library V10.13(beta)
Uploader:   p.biancalani@mbox.match.it
Author:     p.biancalani@mbox.match.it
Type:       util/libs
Version	    10.13

--- English ----
First sorry for my bad English but I don't know it very well.
This is a simple but complete graphic 3D library that use for visualization
only the system library .
Main feature include :

   - Visualization of object in systems windows with single buffering.
   - Use of only fix point value than the math coprocessor is not
     necessary, and is relatively fast on machines us A1200 base too.
   - Implementation of visualization in Wire Frame ,Solid shading and
     Flat shading all simultaneous too and with light source freely 
     placeable .

Is tested on (for now): 
   A4000/40 with S.O. 3.0
   A1200 base with S.O 3.0

But now it is support a 68000 also (on a 68040 run) and I think that 
S.O. 2.0 can be sufficent to run, (but I don't tested).

The rendering engine is entirely based on blitzbasic graphic3D engine V0.9
by Maciej R.Gorny .

The library appears to be solid at my test but is only a beta version and
if anyone want to be a betatester can send to me an E-Mail is welcome.   

THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
I CAN UPDATE ALL ORIGINAL ARCHIVE.
It is very pleasant if you send me an e-mail if you use it.

I have included an example write in E (and full commented) and all the source in C of this library .The executable is 3dlib and it must be in the same
directory of #?.plg files. 

The documentation is now all traslate in English too, but this is very dirty
than sorry and if you found thinks that are not clear send me a e-mail and 
I try to correct it. 

The file graphics3d_000.library is the library for CPU from 68000.
The file graphics3d_020.library is the library for CPU from 68020.
You must rename the correct library to graphics3d.library before use it.

Thanks to:
   Maciej R.Gorny for the original routin of engine 3D.
   Alessandro Franchi for beta testing on A1200.
   VolKer Barthelmann author of VBCC the C compiler used by me to write the
   library.
   Andreas Kleinert author of the optimal startupcode for write shared
   library. 
   The authors of Tornado3D for the suggetions to implemented the single
   buffering in a window. 
   All ones that have write an e-mail to me.

I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
suggestions and signaling is :p.biancalani@mbox.match.it

--- Italiano ---

Questa e' una semplice ma completa libreria grafica 3D che si appoggia
interamente sulle librerie di sistema per la visualizzazione.
Le caratteristiche principali sono:
   
   - Visualizzazione oggetti nelle finestre con single buffering.
   - Usa valori solo in fix point quindi il coprocessore non serve
     ed e' relativamente veloce anche su macchine come il A1200 base.
   - Implementa la visualizzazione in Wire Frame ,Solid shading e
     Flat shading anche tutti contemporaneamente e con la fonte di 
     luce posizionabile a piacere.

E' stata testata su(per ora):
   A4000/40 con S.O. 3.0
   A1200 base con S.O 3.0

Ma adesso e' supportato anche il 68000 (gira su un 68040) e penso che sia
sufficente un S.0 dal 2.0 in poi. 

Il motore di rendering e' interamente basato sul blitzbasic 3d graphics
engine V0.9 di Maciej R.Gorny .

La libreria si e' dimostrata alle mie prove abbastanza solida, pero' e'
sempre una beta e se c'e' qualcuno disposto a farmi da betatester mi mandi
subito un E-Mail sara' il benvenuto. 

QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 

Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
dei file #?.plg .

La documentazione ora e' stata interamente tradotta anche in Inglese anche
se in modo orribile, se qualcuno volesse farmi notare errori o meglio 
correggerli e' veramente benvenuto.

Il file graphics3d_000.library e' per le CPU dal 68000.
Il file graphics3d_020.library e' per le CPU dal 68020.
Occorre rinominare la corretta libreria in graphics3d.library prima di
usarla.

Si ringrazia :
   Maciej R.Gorny per le routin del motore 3D.
   Alessandro Franchi per il parziale beta testing su A1200.
   VolKer Barthelmann autore del compilatore C VBCC da me usato per
   la stesura della libreria.
   Andreas Kleinert autore dell'ottimo startupcode per le shared
   library. 
   Gli autori di Tornado3D per il suggerimento su come implementare 
   il single buffering in una finestra.
   Tutti quelli che mi hanno scritto.

Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
suggerimenti e segnalazioni e': p.biancalani@mbox.match.it