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 установленным цветом фона; по умолчанию эти биты считаются прозрачными.

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

Данный примитив игнорирует шаблоны растровых операций (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