Admin: 1 revision imported

2025-01-22T06:53:41Z

1 revision imported

1>Admin at 06:05, 22 January 2025

2025-01-22T06:05:20Z

New page

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

== Синтаксис ==
<code>
{{Grey|GI.}}'''ShaderAdd'''(''<Тип шейдера (INT)>'',''<Исходный текст шейдера (STRING)>''):''<Уникальный номер (INT)>''
</code>

==== Аргументы ====
* <code>''<Тип шейдера (INT)>''</code> - Аргумент задает числовой тип шейдера. На данный момент доступны следующие типы:
** '''0''': Шейдер фрагмента (fragment)
** '''1''': Шейдер вершины (vertex)
** '''2''': Шейдер геометрии (geometry)
** '''3''': Шейдер контроля тесселяции (tesselation control)
** '''4''': Шейдер оценки тесселяции (tesselation evaluation)
** '''5''': Шейдер вычислений (compute)
* <code>''<Исходный текст шейдера (STRING)>''</code> - Аргумент задает исходный текст для компиляции драйвером и превращении в псевдокод.

==== Возвращаемое значение ====
Возвращается числовое значение.

== Примеры ==
<pre>
//Примитивный шейдер-пример, создающий белый фон
Стр:="#version 130
|gl_FragColor=vec4(1,1,1,1);";

//Создадим программу из шейдера
Прг:=aGI.ShaderProgramAdd(aGI.ShaderAdd(0,Стр));

//Используем ее
aGI.ShaderProgramUse(Прг);

//Выполним рисование
aGI.glBegin(aGI.GL_QUADS);
aGI.glVertex3f(0,0,0.5);
aGI.glVertex3f(aGI.Width,0,0.5);
aGI.glVertex3f(aGI.Width,aGI.Height,0.5);
aGI.glVertex3f(0,aGI.Height,0.5);
aGI.glEnd();
</pre>

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

GI.ShaderAdd - Revision history

Admin: 1 revision imported

1>Admin at 06:05, 22 January 2025