gf_draw_bitmap()

Рисование битовой карты

Прототип:

#include <gf/gf.h>
int gf_draw_bitmap( gf_context_t context,
const uint8_t *image,
unsigned stride,
unsigned bit0_offset,
int x,
int y,
unsigned w,
unsigned h,
unsigned flags );

Аргументы:

context
Дескриптор графического контекста для отображения.
image
Указатель на буфер, содержащий битовую карту.
stride
Число байт на горизонтальную линию изображения в байтах.
bit0_offset
Смещение до первого байта в исходной битовой карте. Для каждой строки изображения этот параметр определяет первый отображаемый пиксель.
x,y
Координаты верхнего левого угла изображения в результирующей поверхности.
w,h
Ширина и высота изображения в пикселях.
flags
Флаги:
GF_DRAW_BITMAP_BACKFILL
отображать биты со значением 0 установленным цветом фона; по умолчанию эти биты считаются прозрачными.

Библиотека:

gf

Описание:

Функция производит рендеринг битовой карты в координатах x и y, используя указанный контекст context. Битовые карты являются простыми изображениям, каждый бит данных которых определяет один отображаемый пиксель. Между последовательными горизонтальными линиями изображения может размещаться пустая выравнивающая область. Это выравнивание следует учесть в параметре stride. Биты со значениями 1 отображаются цветом, заданным в gf_context_set_fgcolor(), остальные пиксели считаются прозрачными. Если установлен флаг GF_DRAW_BITMAP_BACKFILL, то прозрачные пиксели будут отрисованы цветом, заданным в gf_context_set_bgcolor().


Note: Данный примитив игнорирует шаблоны растровых операций (ROP), установленные для контекста context.

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

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

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

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

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

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

gf_context_set_fgcolor(), gf_draw_blit1(), gf_draw_blit2(), gf_draw_blitscaled()




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