Выражения
The expressions are used to specify UnigineScript code to be called on some event or on user demand. They can be used to generate various elements used in the material (e.g., textures, texture arrays, unstructured buffers, etc.) or contain other logic.Выражения используются для указания UnigineScript код, который будет вызываться при каком-либо событии или по требованию пользователя. Они могут использоваться для генерации различных элементов, используемых в материале (например, текстур, массивов текстур, неструктурированных буферов и т. д.), или содержать другую логику.
As a node value you must specify a UnigineScript-based code enclosed in "#{" and "#}". You can also specify a path to an external script file (in usc or h format) or the name of a Script node inside this material.В качестве значения узла необходимо указать код на основе UnigineScript, заключенный в "#{" и "#}". Вы также можете указать путь к внешнему файлу скрипта (в формате usc или h) или имя узла Script внутри этого материала.
The syntax is the following:Синтаксис следующий:
Expression name =
#{
// UnigineScript code
#}OrИли
Script script_name =
#{
// UnigineScript code
#}
Expression name = script_nameOrИли
Expression name = "some/path/to/your/script.h" // script.h consists of some UnigineScript codeWhen the name of an expression specified as RENDER_* (where * is a name of a render callback) and the current material is set globally or assigned to the main camera, the expression code will be executed automatically at the corresponding stage of the rendering sequence. Materials containing such expressions are called scriptable.Когда имя выражения указано как RENDER_* (где * — это имя рендер-коллбэка ) и текущий материал установленного глобально или назначенного на основную камеру, код выражения будет выполняться автоматически на соответствующем этапе рендеринга . Материалы, содержащие такие выражения, называются скриптовыми .
It is possible to call an expression via the runExpression() function of the Material class. The expression’s name must be unique.Можно вызвать выражение через функцию runExpression() класса Material. Имя выражения должно быть уникальным.
Usage ExamplesПримеры использования#
Expression RENDER_CALLBACK_BEGIN_SSAO =
#{
// typical most frequently used parameters passed to the expression when it is called.
int in_width;
int in_height;
int in_depth;
Material in_material;
// get a temporary texture
Texture texture = engine.render.getTemporaryTexture(in_width, in_height);
// set the modified texture as albedo texture of the material
in_material->setTexture("albedo", texture);
#}