Admin: 1 revision imported

2025-01-22T06:53:42Z

1 revision imported

1>Admin at 07:35, 19 January 2025

2025-01-19T07:35:36Z

New page

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

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

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

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

== Примеры ==
<pre>
...
//Сохранить первую текстуру объекта GI на диск в виде PNG файла.
aGI.TextureSavePicture(aGI.Texture(1),2,"c:\texture.png","png");
...
</pre>

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

GI.TextureSavePicture - Revision history

Admin: 1 revision imported

1>Admin at 07:35, 19 January 2025