[ Содержание ] | [ Перечень функций ] |
Status XInitImage(image) XImage *image;
АРГУМЕНТЫ
Эта фунция должна вызываться для всех изображений, самостоятельно создаваемых программой. Изображения, полученные как результат работы какой-либо функции Xlib не нуждаются в инициализации этой функцией.
Функция XInitImage устанавливает внутренние указатели структуры image на подпрограммы для работы с этим графическим образом, основываясь на значениях параметров изображения, предварительно записанных в эту структуру. Все поля, кроме указателей на подпрограммы к моменту вызова XInitImage уже должны иметь необходимые значения.
Если значение поля bytes_per_line равно нулю, то это означает, что строки изображения должны храниться в виде непрерывного массива данных и XInitImage вычисляет соответсвующее значение для этого поля. Иначе, значение этого поля остаётся без изменений.
В зависимости от некоторых параметров изображения, функция XInitImage устанавливает указатели на разные подпрограммы работы с изображением.
В случае успешной инициализации изображения, функция XInitImage возвращает ненулевой статус. Если была обнаружена ошибка или несоответствие параметров изображения, то никаких изменений в структуру не вносится и возвращается нулевой статус.
Cм. также: XCreateImage, XGetPixel, XPutPixel, XSubImage, XAddPixel, XDestroyImage, XPutImage, XGetImage, XGetSubImage.
[ Содержание ] | [ Перечень функций ] |