******** ENGLISH  ****************************************

 -----  GENERAL NOTES OVER GRAPHICS3D.LIBRARY ------

(from the original documentation of Maciej R.Gorny)

1)	3D coordinates system

Coordinate system used is a left-handed coordinate system: X-axis goes from left
to right, Y-axis, from down up-wards, and Z-axis from behind (us) into the
screen.

               ^ +Y
               |        Into the screen
               |
               |      +Z
               |     /
               |    /
               |   /
               |  /
               | /
               |/
-X ---------------------------> +X
              /|
             / |
            /  |
           /   |
          /    |
       -Z/     |
               |
 Viewer        | -Y


2)	Objects and polygons supported

The objects are group of polygons of two types:
The first with three vertices (triangles) or with four vertices (quads) in clockwise order and with one or two side .
The second with one(point) or two(lines) vertex, obiouvsly with this entitys
the caratteristics of first type here are ignored.
All other will be either rejected or will cause problems.

One-sided polygons will be visible only when they are facing a viewer. 
This is useful if we want to limit number of polygons rendered to screen by 
using backface culling and remove polygons that cannot be seen in an object.
Objects cannot concave in such case.

Two-sided polygons will always be rendered to a screen (provided they get
passed clipping procedures), because they have two sides that are visible to
a viewer: front and back.


3)	Limits

In the space 3D defined with the function GD_display3D() you can insert a
max of 100 objects (you can change recompiled with a new value for MAXOBJECT
see graphics3d.h) and a max of 10000 polygons simultaneous visible on the
actual view (you can change recompiled with a new value for MAXPLFRAM see
graphics3d.h) than for any objects you can define a max of 1000 vertex (you
can change recompiled with a new value for MAXVERT see graphics3d.h).
I think that this value generally sufficent for all, but if you increase
its warnig! because the memory usage is not too linear.
 

******** ITALIANO ****************************************

 -----  NOTE GENERALI SULLA GRAPHICS3D.LIBRARY -----

(tratto dalla documentazione originale di Maciej R.Gorny)

1)	Sistema di coordinate nello spazio

Il sistema sistema di coordinate usate segue la regola della mano sinitra
cioe' : l'asse X va da sinistra a destra , l'asse Y va dal basso in alto
e l'asse Z entra nello schermo

               ^ +Y
               |        Verso lo schermo
               |
               |      +Z
               |     /
               |    /
               |   /
               |  /
               | /
               |/
-X ---------------------------> +X
              /|
             / |
            /  |
           /   |
          /    |
       -Z/     |
               |
 osservatore   | -Y


2) 	Oggetti e poligoni supportati.	

Gli oggetti sono intesi come insiemi di poligoni di due tipi :
Il primo con tre(triangoli) o quattro (quadrilateri)vertici in ordine orario
e con una o due facce, non sono ammessi altri casi.
Il secondo con uno (punto) o due (linee)vertici ovviamente con queste due
entita' non hanno senso le caratteristiche associate ai poligoni del
primo tipo qui del tutto ignorate. 

I poligoni con una faccia saranno visibili solo se saranno rivolti verso
l'osservatore (ovvero con la faccia esterna all'oggetto).Questo e' utile
per limitare il numero di poligoni visualizzati sullo schermo.
L'oggetto in tal caso non deve essere aperto.

I poligoni con due facce saranno invece sempre visibili sullo schermo
poiche' hanno due lati visibili all'osservatore : anteriore e posteriore.


3)	Limiti

Nello spazio 3d definito con la funzione GD_display3D() si possono inserire
un massimo di 100 oggetti (si puo' variare ricompilando con un valore 
diverso per MAXOBJECT vedi graphics3d.h) ed un massimo di 10000 poligoni
contemporaneamente visibili nella vista attuale (si puo' variare ricompilando
con un valore diverso per MAXPLFRAM vedi graphics3d.h) inoltre per ogni 
oggetto si puo' definire un massimo di 1000 vertici (si puo' variare 
ricompilando con un valore diverso per MAXVERT vedi graphics3d.h) .
In ogni caso penso siano valori generalmente sufficenti e se li aumentate
attenzione all'uso della memoria perche' aumentera in modo non troppo 
lineare.