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
Дескриптор поверхности, куда будет сохранен снимок.

Библиотека:

gf

Описание:

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


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


Warning: Потоки не должны вызывать эту функцию между вызовами 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