14.8 rgbimg -- Leggere e scrivere file ``SGI RGB''

Il modulo rgbimg permette ai programmi Python l'accesso a file di immagini SGI imglib (conosciuti anche come file .rgb). Il modulo č lontano dall'essere completo, ma fornisce ad ogni modo funzionalitą spesso sufficienti in alcuni casi. I file colormap non sono al momento supportati.

Note: Questo modulo č costruito solamente per piattaforme a 32-bit; non ci si aspetta che funzioni correttamente su altri sistemi.

Il modulo definisce le seguenti variabili e funzioni:

exception error
Questa eccezione viene sollevata su tutti gli errori, come file di tipo non supportati, etc. etc..

sizeofimage( file)
Questa funzione restituisce una tupla (x, y) dove x e y sono la misura dell'immagine in pixel. Solo pixel RGBA a 4 byte, pixel RGB a 3 byte e scale di grigio ad 1 byte vengono correntemente supportate.

longimagedata( file)
Questa funzione legge e decodifica l'immagine del file specificato, e lo restituisce come una stringa Python. La stringa ha pixel RGBA a 4 byte. Il pixel nella parte inferiore di sinistra nella stringa č il primo. Questo formato č adatto per essere passato a gl.lrectwrite(), per istanza.

longstoimage( data, x, y, z, file)
Questa funzione scrive i dati RGBA data in un file, file, di un'immagine. x ed y forniscono la dimensione dell'immagine. z vale 1 se l'immagine salvata dovrebbe essere in scala di grigi ad 1 byte, 3 se l'immagine salvata dovrebbe essere un dato in RGB a 3 byte, o 4 se l'immagine salvata dovrebbe essere un dato in RGBA a 4 byte. I dati di input devono sempre contenere 4 byte per pixel. Questi sono i formati restituiti da gl.lrectread().

ttob( flag)
Questa funzione imposta un flag globale che definisce quando le righe di ricerca dell'immagine vengono lette o scritte dal basso verso l'alto (l'opzione č zero, compatibile con SGI GL) o dall'alto verso il basso (opzione uno, compatibile con X). Per definizione č zero.
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.