gf_draw_blitscaled()

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

Perform a scaled blit

Прототип:

#include <gf/gf.h>
 
int gf_draw_blitscaled( gf_context_t context,
                        gf_surface_t ssurface,
                        gf_surface_t dsurface,
                        int sx1,
                        int sy1,
                        int sx2,
                        int sy2,
                        int dx1,
                        int dy1,
                        int dx2,
                        int dy2 );

Аргументы:

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

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

Если исходная и результирующая области принадлежат одной и той же поверхности (ssurface и dsurface указывают на одну поверхность), их перекрытие не допустимо. В противном случае результат будет непредсказуемым на программном и аппаратном уровне.

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

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

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

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

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

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

gf_draw_blit1(), gf_draw_blit2()

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