imgfile — Поддержка файлов SGI imglib

Модуль imgfile позволяет программам Python получать доступ к файлам изображений SGI imglib (также известные как .rgb файлы). Модуль далёк от завершения, но всё же предоставлен, так как в некоторых случаях функциональность достаточна. В настоящее время цветовые карты не поддерживаются.

Модуль определяет следующие переменные и функции:

exception imgfile.error

Это исключение возникает при всех ошибках, таких как неподдерживаемый тип файла и т. д.

imgfile.getsizes(file)

Эта функция возвращает кортеж (x, y, z), где x и y — размер изображения в пикселях, а z — количество байтов на пиксель. В настоящее время поддерживаются только 3-байтовые RGB-пиксели и 1-байтовые изображения в оттенках серого.

imgfile.read(file)

Эта функция считывает и декодирует изображение из указанного файла и возвращает его как строку Python. Строка содержит пиксели в оттенках серого (1 байт) или RGBA (4 байта). Левый нижний пиксель — первый в строке. Этот формат подходит для передачи в gl.lrectwrite(), например.

imgfile.readscaled(file, x, y, filter[, blur])

Эта функция идентична функции read, но возвращает изображение, масштабированное до заданных размеров x и y. Если параметры filter и blur опущены, масштабирование выполняется простым удалением или дублированием пикселей, поэтому результат будет менее идеальным, особенно для компьютерно сгенерированных изображений.

В качестве альтернативы можно указать фильтр для сглаживания изображения после масштабирования. Поддерживаемые типы фильтров — 'impulse', 'box', 'triangle', 'quadratic' и 'gaussian'. Если указан фильтр, blur — необязательный параметр, определяющий размытость фильтра. По умолчанию он равен 1.0.

readscaled() не пытается сохранить правильное соотношение сторон, поэтому эта ответственность лежит на пользователе.

imgfile.ttob(flag)

Эта функция устанавливает глобальный флаг, определяющий, считываются ли строки сканирования изображения сверху вниз (флаг равен нулю, совместимо с SGI GL) или снизу вверх (флаг равен единице, совместимо с X). По умолчанию флаг равен нулю.

imgfile.write(file, data, x, y, z)

Эта функция записывает данные RGB или оттенков серого из data в файл изображения file. x и y задают размер изображения, z равно 1 для 1-байтовых изображений в оттенках серого или 3 для RGB-изображений (которые хранятся как 4-байтовые значения, из которых используются только три младших байта). Это форматы, возвращаемые функцией gl.lrectread().