[ Содержание ][ Перечень функций ]

XInitImage - инициализация локального графического образа

СИНТАКСИС
    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.


[ Содержание ][ Перечень функций ]