imgfile.md

1> **Источник:** https://python-all.ru/2.7/library/imgfile.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 39.11. [`imgfile`](https://python-all.ru/2.7/library/imgfile.html#module-imgfile) – Поддержка файлов SGI imglib89Устарело с версии 2.6: Модуль [`imgfile`](https://python-all.ru/2.7/library/imgfile.html#module-imgfile) удалён в Python 3.1011Модуль [`imgfile`](https://python-all.ru/2.7/library/imgfile.html#module-imgfile) позволяет программам на Python получать доступ к файлам изображений SGI imglib (также известным как файлы `.rgb`). Модуль далёк от полной реализации, однако предоставляется, поскольку имеющейся функциональности в некоторых случаях достаточно. В настоящее время файлы цветовых карт не поддерживаются.1213Модуль определяет следующие переменные и функции:1415#### `exception imgfile.error`1617Это исключение возбуждается при любых ошибках, например, неподдерживаемый тип файла и т.д.1819#### `imgfile.getsizes(file)`2021Эта функция возвращает кортеж `(x, y, z)`, где *x* и *y* – размер изображения в пикселях, а *z* – количество байтов на пиксель. В настоящее время поддерживаются только 3-байтовые пиксели RGB и 1-байтовые пиксели в оттенках серого.2223#### `imgfile.read(file)`2425Эта функция читает и декодирует изображение из указанного файла и возвращает его в виде строки Python. Строка содержит либо 1-байтовые пиксели в оттенках серого, либо 4-байтовые пиксели RGBA. Первым в строке идёт левый нижний пиксель. Этот формат подходит, например, для передачи в `gl.lrectwrite()`.2627#### `imgfile.readscaled(file, x, y, filter[, blur])`2829Эта функция идентична read, но возвращает изображение, масштабированное до заданных размеров *x* и *y*. Если параметры *filter* и *blur* опущены, масштабирование выполняется простым удалением или дублированием пикселей, поэтому результат будет далёк от идеала, особенно для компьютерных изображений.3031В качестве альтернативы можно указать фильтр для сглаживания изображения после масштабирования. Поддерживаются следующие формы фильтра: `'impulse'`, `'box'`, `'triangle'`, `'quadratic'` и `'gaussian'`. Если фильтр указан, *blur* – необязательный параметр, задающий размытие фильтра. По умолчанию `1.0`.3233[`readscaled()`](https://python-all.ru/2.7/library/imgfile.html#imgfile.readscaled) не пытается сохранить правильное соотношение сторон, поэтому это ответственность пользователей.3435#### `imgfile.ttob(flag)`3637Эта функция устанавливает глобальный флаг, определяющий, читаются или записываются строки изображения снизу вверх (флаг равен нулю, совместимо с SGI GL) или сверху вниз (флаг равен единице, совместимо с X). По умолчанию – ноль.3839#### `imgfile.write(file, data, x, y, z)`4041Эта функция записывает данные RGB или в оттенках серого из *data* в файл изображения *file*. *x* и *y* задают размер изображения, *z* равен 1 для 1-байтовых изображений в оттенках серого или 3 для изображений RGB (которые хранятся как 4-байтовые значения, из которых используются только младшие три байта). Это форматы, возвращаемые `gl.lrectread()`.42