gf_draw_blit2()

Блиттинг области между двумя поверхностями

Прототип:

#include <gf/gf.h>
 
int gf_draw_blit2( gf_context_t context,
                   gf_surface_t ssurface,
                   gf_surface_t dsurface,
                   int sx1,
                   int sy1,
                   int sx2, 
                   int sy2, 
                   int dx, 
                   int dy );

Аргументы:

context: Дескриптор графического контекста для выполнения блиттинга.
ssurface: Дескриптор поверхности, содержащей копируемую область пикселей. Если передан NULL, будет использована поверхность, ассоциированная с контекстом context.
dsurface: Дескриптор поверхности, принимающей копируемую область пикселей. Если передан NULL, будет использована поверхность, ассоциированная с контекстом context.
sx1,sy1: Координаты верхнего левого угла исходной области блиттинга.
sx2,sy2: Координаты нижнего правого угла исходной области блиттинга.
dx,dy: Координаты смещенной позиции, начиная с которой будет скопировано исходное изображение.

Данная функция выполняет блиттинг (от англ. "BLock Image Transfer", BLIT или копирование пикселей) из ассоциированной с поверхностью ssurface области данных в поверхность dsurface. Размер области остается неизменным, но координаты начала отображения могут менятья. Если обе области принадлежат единой поверхности, допустимо перекрытие данных.

Результирующая область подлежит обрезке, используя функцию gf_context_set_clipping(), только в том случае, если она ассоциирована с контекстом context. В противном случае она ограничена лишь размером поверхности dsurface. Исходная область должна укладываться лишь в границы поверхности ssurface.

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

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

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

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

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

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

gf_draw_blit1(), gf_draw_blitscaled()

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