14.8 rgbimg --- Lit et écrit des fichiers ``SGI RGB''

Le module rgbimg permet aux programmes Python d'accéder aux fichiers d'image SGI imglib (également connues sous le nom de fichiers .rgb). Le module est loin d'être complet, mais il est fourni malgré tout puisque ses fonctionnalités suffisent dans certains cas. Actuellement les fichiers couleur ne sont pas supportés.

Le module définit les variables et fonctions suivantes:

error
Cette exception est déclenchée sur toutes les erreurs, telles que type de fichier non supporté, etc.

sizeofimage(fichier)
Cette fonction retourne un tuple (x, y)x et y sont la taille de l'image en pixels. Seuls les pixels RGBA de 4 octets, les pixels RGB de 3 octets et les pixels de niveau de gris de 1 octet sont actuellement supportés.

longimagedata(fichier)
Cette fonction lit et décode l'image contenue dans le fichier spécifié, et la retourne sous forme d'une chaîne de caratères Python. La chaîne est constituée de pixels RGBA de 4 octets. Le pixel en bas à gauche est le premier de la chaîne. Ce format est adapté pour un passage à gl.lrectwrite(), par exemple.

longstoimage(donnees, x, y, z, fichier)
Cette fonction écrit les données RGBA de donnees dans le fichier image fichier. x et y donnent la taille de l'image. z vaut 1 si l'image sauvegardée est en niveau de gris sur 1 octet, 3 si elle est en données RGB de 3 octets, ou 4 si elle est en données RGBA de 4 octets. Les données d'entrée contiennent toujours 4 octets par pixel. Ce sont les formats retournés par gl.lrectread().

ttob(drapeau)
Cette fonction donne une valeur à un drapeau global qui définit si les lignes de balayage de l'image sont lues ou écrites du bas vers le haut (le drapeau vaut 0, compatible avec SGI GL) ou du haut vers le bas (le drapeau vaut 1, compatible avec X). La valeur par défaut est 0.