Admin: 1 revision imported

2025-01-22T06:53:38Z

1 revision imported

1>Admin at 07:33, 19 January 2025

2025-01-19T07:33:54Z

New page

{{infobox function
|name=BufferSavePicture
|object=[[Объект GI]]
|caption=Общие функции объекта GI
|type=1
|status=2
|db=0
|exception=Неверные аргументы, не поддерживаемый формат, системная ошибка.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция позволяет получить изображение из указанной области буфера или экрана (в том числе для мультиэталонного буфера (multi-sample buffer)), превратить его в картинку в указанном формате и поместить в указанный источник (буфер системы, строку или файл на диске).

== Синтаксис ==
<code>
{{Grey|GI.}}'''BufferSavePicture'''({{Optional|<Уникальный номер буфера или 0 для экрана (INT)>{{Default|{{Eq}}0}},<Смещение по x внутри буфера (INT)>{{Default|{{Eq}}0}},<Смещение по y внутри буфера (INT)>{{Default|{{Eq}}0}},<Ширина захватываемой картинки (INT)>{{Default|{{Eq}}0}},<Высота захватываемой картинки (INT)>{{Default|{{Eq}}0}},<Тип результата (INT)>{{Default|{{Eq}}0}},<Параметр, зависящий от типа результата>,<Формат результата (STRING)>{{Default|{{Eq}}"BMP"}},<Тип буфера (если не экран) (INT)>{{Default|{{Eq}}0}}}}):''<Результирующая картинка (BUFFER,STRING)>''
</code>

==== Аргументы ====
* <code>''<Уникальный номер буфера или 0 для экрана (INT)>''</code> - {{Optional}} Аргумент задает уникальный номер экранного буфера, если получение каринки происходит из него или 0 для получения картинки с экрана (по умолчанию).
* <code>''<Смещение по x внутри буфера (INT)>'',''<Смещение по y внутри буфера (INT)>''</code> - Аргументы задают начальное смещение в точках внутри источника. Для спецификации OpenGL точка (0,0) находится в нижней левой чсти экрана.
* <code>''<Ширина захватываемой картинки (INT)>'',''<Высота захватываемой картинки (INT)>''</code> - Аргументы задают ширину и высоту картинки в точках внутри источника. Если аргументы не указаны будут использоваться ширина и высота окна ''GI'' за минусом начальных смещений.
* <code>''<Тип результата (INT)>''</code> - {{Optional}} Аргумент задает тип получаемого результата, доступны следующие значения:
** '''0''' (по умолчанию) -- сохранить картинку в объект буфера (см. [[Буфер]]).
** '''1''' -- сохранить объект в ANSI строку.
** '''2''' -- сохранить объект в файл на диске. В этом режиме следующий аргумент задает имя файла.
* <code>''<Параметр, зависящий от типа результата>''</code> - {{Optional}} Аргумент задает имя файла на диске для сохранения картинки, если предыдущий аргумент равен ''2'', иначе текущий аргумент игнорируется.
* <code>''<Формат результата (STRING)>''</code> - {{Optional}} Аргумент задает формат сохраняемой картинки. Возможны следующие значения: '''BMP''' (по умолчанию), '''JPG''', '''PNG''', '''GIF'''.
* <code>''<Тип буфера (если не экран) (INT)>''</code> - {{Optional}} Аргумент задает тип графического буфера (в случае, если получение картинки происходит не с экрана). Возможные значения:
** '''0''' (по умолчанию) -- обычный графический буфер.
** '''1''' -- мультиэталонный графический буфера (multi-sample buffer).

==== Возвращаемое значение ====
При сохранении в строку или объект буфера, будут возвращены строка или буфер, при сохранении в файл на диске, будет возвращено пустое значение.

== Примеры ==
<pre>
...
//Сделать "снимок экрана" в виде PNG файла.
aGI.BufferSavePicture(,,,,,2,"c:\screen.png","png");
...
</pre>

← Older revision	Revision as of 06:53, 22 January 2025
(No difference)

GI.BufferSavePicture - Revision history

Admin: 1 revision imported

1>Admin at 07:33, 19 January 2025