gf_draw_image()

Рисование изображения

Прототип:

#include <gf/gf.h>
extern int gf_draw_image( gf_context_t context,
const uint8_t *pixels,
gf_format_t format,
unsigned stride,
int x,
int y,
unsigned w,
unsigned h,
unsigned flags );

Аргументы:

context
Дескриптор графического контекста для отображения.
pixels
Указатель на буфер, содержащий контент изображения.
format
Формат графической информации. Поддерживаемые форматы указаны на странице gf_format_t.

Note: Формат GF_FORMAT_PAL8 функцией не поддерживается.

stride
Число байт на горизонтальную линию изображения. Данный параметр значим только если высота изображения больше 1.
x,y
Координаты верхнего левого угла изображения в результирующей поверхности.
w,h
Ширина и высота изображения в пикселях.
flags
Флаги. В настоящий момент не поддерживаются, следует передавать значение 0.

Библиотека:

gf

Описание:

Данная функция производит рендеринг изображения в поверхность, ассоциированную с контекстом context. Позиция отображаемого изображения соответствует x, y. Между последовательными горизонтальными линиями изображения может размещаться пустая выравнивающая область. Это выравнивание следует учесть в параметре stride.


Note: Эта функция предназначена только для удобства. Она будет стремиться использовать программный блиттинг, поскольку тип памяти, которая содержит изображение неизвестен.

Возвращаемое значение:

GF_ERR_OK
Успешное завершение.
GF_ERR_PARM
Формат не поддерживается, либо значение параметра context или pixels равно NULL
GF_ERR_NOLOCK
Контекст рендеринга не обладает эксклюзивным доступом к оборудованию; убедитесь, что вызов gf_draw_begin() завершен успешно.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Graphics Framework

Безопасность использования
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

gf_draw_bitmap()




Предыдущий раздел: GF API