Admin: 1 revision imported

2025-01-22T06:53:41Z

1 revision imported

1>Admin at 06:24, 22 January 2025

2025-01-22T06:24:16Z

New page

{{infobox function
|name=ShaderProgramSetVariable
|object=[[Объект GI#Атрибуты и функции шейдеров и программ шейдеров|Шейдеры объекта GI]]
|caption=Функции шейдеров
|type=1
|status=2
|db=0
|exception=Неверные аргументы, недостаточно значений.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция устанавливает значение переменной (заданной по ее имени) программы шейдеров (заданной по ее уникальному номеру). Количество значений указывается для переменных, содержащих массивы, и задает количество значений в массиве. Значения могут быть заданы несколькими аргументами как числа (вещественные или целые), либо одним аргументом с типом список (содержащий сами значения), либо буфер или структура данных записи. В последнем случае, размера буфера с данными должно быть достаточно, чтобы уместить весь массив значений. Заданная один раз, переменная для данной программы шейдеров в дальнейшем сохраняет свое значение до того момента, пока программа не будет удалена или значение переменной не будет задано снова. '''Важно''': для спецификации OpenGL данную функцию нельзя использовать внутри последовательности <code>glBegin ... glEnd</code>, иначе значение не будет установлено. Заданная один раз, переменная для данной программы шейдеров в дальнейшем сохраняет свое значение до того момента, пока программа не будет удалена или значение переменной не будет задано снова. См. также функцию [[GI.ShaderAddVariable|ShaderAddVariable]] для описания способа указания на типы переменных.

== Синтаксис ==
<code>
{{Grey|GI.}}'''ShaderProgramSetVariable'''(''<Уникальный номер программы (INT)>'',''<Имя переменной (STRING)>''{{Optional|,<Количество значений (INT)>{{Default|{{Eq}}1}},<Значение 1>,<Значение 2>...}})
</code>

==== Аргументы ====
* <code>''<Уникальный номер программы (INT)>''</code> - Аргумент задает уникальный номер программы шейдеров, значение переменной которой необходимо изменить.
* <code>''<Имя переменной (STRING)>''</code> - Аргумент задает имя переменной программы шейдеров, значение переменной которой необходимо изменить. Обычно имена переменных не могут содержать менждународных символов.
* <code>''<Количество значений (INT)>''</code> - {{Optional}} Аргумент задает количество значений в массиве, если переменная содержит массив.
* <code>''<Значение 1>,<Значение 2>...''</code> - {{Optional}} Аргументы задают значения, способ задания значений зависит от типа первого из аргументов значений. Доступны следующие типы:
** '''Буфер''' или '''Объект записи с буфером''': значения будут получены из буфера общий размер буфера должен быть не меньше размера одного значения с типом данной переменной (для ''vec4'', к примеру, это 4 значения по 4 байта = 16 байт) умноженного на количество значений, если переменная является массивом.
** '''Список''': значения будут получены из списка общее количество значений в списке должно быть не меньше количества чисел в одном значении с типом как у данной переменной (для ''vec4'', к примеру, это 4 значения) умноженного на количество значений, если переменная является массивом.
** '''Число''': все значения будут получены из аргументов функции. Общее количество значений должно быть равно количеству чисел в одном значении с типом как у данной переменной (для ''vec4'', к примеру, это 4 значения) умноженному на количество значений, если переменная является массивом.

== Примеры ==
<pre>
...
aGI.ShaderProgramSetVariable(аПрограмма,"u_pos0",,x0,y0,dx,dx);
aGI.ShaderProgramSetVariable(аПрограмма,"u_mode",,?(лкРежимИгры=0,1,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.ShaderProgramSetVariable - Revision history

Admin: 1 revision imported

1>Admin at 06:24, 22 January 2025