2.3.7.1        Struttura delle directory.


Il codice sorgente di POV-Ray è distribuito in archivi, dove i file sono disposti secondo una particolare gerarchia di directory (o cartelle, a seconda del sistema operativo). Quando si estraggono gli archivi, lo si dovrebbe fare in maniera che mantenga intatta la struttura delle directory (ad esempio, pkunzip -d oppure tar -xvfz). In generale, si suggerisce di creare una directory chiamata povray3 ed estrarre i file al suo interno. L'estrazione creerà una directory chiamata source con molti file e sotto-directory. In generale ci sono archivi separati per ogni piattaforma hardware e sistema operativo, ma ciascuno di questi archivi può supportare più di un compilatore. Ad esempio, qui è riportata la struttura delle directory per l'archivio MS-Dos

source
source\libpng
source\zlib
source\msdos
source\msdos\pmode
source\msdos\borland
source\msdos\djgpp
source\msdos\watcom

La directory source contiene i file sorgenti per le parti generiche di POV-Ray, uguali su tutte le piattaforme. La directory source\libpng contiene file per la compilazione di una libreria di routine usate nel leggere e scrivere immagini in formato PNG (Portable Network Graphics). La directory source\zlib contiene file per la compilazione di una libreria utilizzata da libpng per comprimere e decomprimere flussi di dati. Tutti questi file sono utilizzati da tutte le piattaforme e tutti i compilatori e si trovano in ogni versione degli archivi contenenti i sorgenti.
La directory source\msdos contiene tutti i sorgenti per la versione MS-Dos comuni a tutti i compilatori supportati. La sub-directory source\msdos\pmode contiene i sorgenti per la libreria pmode.lib che è richiesta da tutte le versioni per MS-Dos. Le sottodirectory borland, djgpp, watcom contengono sorgenti, makefile e project file per i rispettivi compilatori C. Questa directory è unica nell'archivio per MS-Dos. Analogamente la versione per Windows contiene una directory source\windows, la versione Unix contiene source\unix ecc.
La directory source\msdos contiene un file, cmpl_msd.doc, nel quale si trovano informazioni relative alla compilazione specifiche per la versione MS-Dos. Altre versioni contengono file analoghi, di nome cmpl_xxx.doc. Assicurarsi di avere letto tutti i file cmp_xxx.doc pertinenti alla propria piattaforma e compilatore.