gf_display_snapshot()

Сохраняет содержимое дисплеея в поверхность

Прототип:

#include <gf/gf.h>
 
int gf_display_snapshot( gf_display_t display,
                         int output,
                         int x1, 
                         int y1,
                         int x2,
                         int y2, 
                         gf_surface_t surface );

Аргументы:

display: Дескриптор дисплея, откуда будет сделан снимок. Этот дескриптор получается в результате вызова gf_display_attach().
output: Видеовыход, из которого производится захват снимка.
x1,y1,x2,y2: Координаты области снимка. Если данная область выходит за рамки области дисплея, снимок является пересечением прямоугольника, описываемого координатами области снимка, и области дисплея.
surface: Дескриптор поверхности, куда будет сохранен снимок.

Данная функция создает снимок определенной области из специализированного выдеовыхода дисплея. Все видимые слои захватываются и собираются в единый слой, результат сохраняется в surface, передаваемый в функцию.

Только аппаратное обеспечение Fujitsu Carmine поддерживает эту функцию. Если функция будет вызвана для не поддерживаемого аппаратного обеспечения, то она завершится и возвратит GF_ERR_NOSUPPORT.

Потоки не должны вызывать эту функцию между вызовами gf_draw_begin() и gf_draw_end() во избежание возникновения взаимной блокировки.

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

GF_ERR_OK: Успешное завершение.
GF_ERR_NOSUPPORT: Аппаратное обеспечение не поддерживает данную функциональность.
GF_ERR_PARM: Значение параметра display или surf равно NULL.

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

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

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

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

gf_display_attach()

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