Редактор логики ¶

Table of Content

Редактор логики
- Основы
- Control Flow
- Animation
- Camera
- Object
- Operations
- Sound
- Network
- Time
- Layout
- Debug
- Other Features

Основы ¶

Визуальное программирование осуществляется путем создания нодового дерева логики в окне нодового редактора. С помощью Logic Editor можно существенно расширить функциональность сцены, не прибегая при этом к программированию.

Для активации логики, на вкладке настроек сцены Blender необходимо установить галочку Logic Editor и добавить/выбрать активное нодовое дерево:

Для редактирования дерева логики необходимо перейти в Редактор Нод (Node Editor) выбрать тип нодового дерева Blend4Web logic:

Затем выбрать дерево для редактирования:

Создание нод осуществляется привычным для Blender сочетанием клавиш Shift+A.

Ноды - это логические блоки, выполнение которых начинается с Entry Point, которая имеет один единственный выход. Почти все остальные ноды помимо одного или двух выходов имеют также входы, таким образом они могут быть вставлены в любое место в дереве. Ноды без выходов, например Page Redirect, могут быть вставлены только в конец какой-либо ветви. Ноды с двумя выходами позволяют ветвить алгоритм в зависимости от успеха/провала указанного условия, например Conditional Jump.

Для реализации сложной логики предусмотрены переменные, которые могут иметь как числовые, так и строковые значения. Переменные могут быть использованы для хранения какого-либо состояния сцены (например, это может быть счётчик проигрываемых анимаций, количество жизней, оставшихся у персонажа и т.д.).

Пример использования редактора логики:

Ниже перечислены все доступные ноды.

Control Flow ¶

Entry Point¶

Является точкой начала выполнения скрипта. Использование нескольких точек входа позволяет эмулировать многопоточное выполнение.

Входные параметры¶

Отсутствуют.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Run From Script: Если этот параметр активирован, точка входа может быть запущена с помощью API, используя метод run_entrypoint.

Select¶

Позволяет отследить событие выбора какого-либо объекта из списка объектов.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

<имя объекта> Hit: Этот параметр передаёт управление следующей ноде в случае, если выбран объект, упомянутый в его названии. По умолчанию нода Select имеет один параметр этого типа, также присутствует возможность создавать новые и удалять уже существующие (нода может и не иметь ни одного такого параметра).
Miss: Этот параметр передаёт управление следующей ноде в случае, если выбран любой из объектов со свойством Selectable, не из числа объектов, указанных в данной ноде.

Внутренние параметры¶

Object: Один из объектов, доступных для выбора пользователю. Такие параметры создаются и удаляются автоматически при создании или удалении выходных параметров типа Hit.
Variable: Если активирован этот параметр, переменная типа Object может быть указана в поле Object.
Destination: Задаёт переменную, в которой сохраняется вбранный объект.

Branch¶

Перейти к указанной ноде в случае выполнения выбранного условия. В качестве параметров условия (операндов) могут выступать также переменные, которые активируются с помощью соответствующих переключателей.

_images/logic_editor_conditional_jump.png

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

True: Утверждение истинно.
False: Утверждение ложно.

Внутренние параметры¶

Condition

Логическое утверждение. Может иметь один из следующих типов:

Equal (=) - первый операнд равен второму.
Not Equal (!=) - первый операнд не равен второму.
Less Than (<) - первый операнд меньше второго.
Greater Than (>) - первый операнд больше второго.
Less Than Or Equal (<=) - первый операнд меньше либо равен второму.
Greater Than Or Equal (=>) - первый операнд больше либо равен второму.

Operand1

Первый операнд логического выражения. Может быть числом либо строкой (если включена опция String Operators). Может быть задан в самой ноде либо с помощью ссылки на одну из переменных (если включена опция Variable).

Operand2

Второй операнд логического выражения. Аналогичен первому.

Operand’s Type

Тип операндов. Доступные варианты - Number (значение по умолчанию), String и Object.

Switch¶

Эта нода стравнивает несколько переменных с заданным значением и выполняет условный переход в зависимости от результатов сравнения.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

<имя переменной>: Одна из переменных, используемых при сравнении. Если значение переменной, заданной этип параметром, совпадает со значением, заданным параметром Variable, управление передаётся ноде, соединённой с соответствующих выходом. По умолчанию нода Switch включает один параметр этого типа, но пользователь может добавлять новые и удалять уже существующие (нода может и не иметь ни одного подобного параметра).
Default: Этот выход передаёт управление следующей ноде в случае, если но одно из заданных значений не совпадает со значение переменной, заданной параметром Variable.

Внутренние параметры¶

Variable: Задаёт переменную, используемую при сравнении.

JS Callback¶

Используется для вызова callback-функции, заранее заданной в вашем Blend4Web-приложении.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Callback ID

ID JavaScript-функции, которая будет вызываться нодой.

Это значение может быть задан напрямую или с помощью переменной (если включена опция Variable).

In Params

Список входных параметров функции. Каждый параметр может представлять собой либо переменную, либо ссылку на объект сцены. Количество входящих параметров может быть настроено. По умолчанию список пуст.

Входные параметры передаются callback-функции в виде массива, который используется в качестве первого аргумента функции.

Param <param_number>

Задаёт входящий параметр. Параметр может быть как переменной (R1 по умолчанию), так и ссылкой на объект сцены, в зависимости от значения параметра Type (у каждого входного параметра всегда есть соответствующий параметр Type).

Type

Тип соответствующего входного параметра. Может иметь одно из двух значений: Variable (в этом случае в качестве параметра будет использована одна из переменных) или Object (ссылка на объект сцены).

Out Params

Список выходных параметров. По умолчанию пуст. Количество выходных параметров поддаётся настройке.

Массив, состоящий из выходных параметров, используется в качестве второго аргумента callback-функции.

Param <param_number>

Задаёт переменную, которая будет использоваться в качестве одного из выходных параметров. По умолчанию используется переменная R1.

Define Function¶

Эта нода может применяться для объединения нескольких логических нод в функцию, т.е. подпрограмму, которая может вызываться из основоного нодового дерева. Эта нода всегда выступает как начальная точка отдельного логического дерева и не имеет входных параметров.

Входные параметры¶

Отсутствуют.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Function: Имя функции.
In Params: Список входных параметров функции. Список пуст по умолчанию, но пользователь может добавлять и удалять параметры с помощью кнопок + и -. Параметрам также могут быть присвоены имена.
Out Params: Список выходных параметров функции. Рабоает по тому же принципу, что и список In Params.

Call Function¶

Эта нода применяется для вызова функии, заданной нодой Define Function.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

NodeTree: Имя нодового дерева, содержащего вызываемую функцию.
Function: Имя функции.
In Params: Список переменных, задающих входные параметры функции, установленной при помощи параметра Function.
Out Params: Список переменных, задающих выходные параметры функции, заданной параметром Function.

Animation ¶

Play Timeline¶

Позволяют управлять NLA анимацией. Нода Play Timeline проигрывать участок NLA, начиная с кадра, на который указывает маркер. Анимация воспроизводится до следующего маркера, либо до конца шкалы времени сцены, после чего управление переходит к следующей ноде.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Start Marker: Первый кадр анимации.

Примечание

Если этот параметр не указан, анимация воспроизводится с текущего кадра, т.е. если до этого анимация не воспроизводилась, она начнётся с первого кадра таймлайна. Если анимация была остановлена с помощью ноды Stop Timeline, а затем запущена заново, она продолжится с последнего воспроизведённого кадра.
End Marker: Последний кадр анимации.

Примечание

Если этот параметр не указан, анимация воспроизводится до следующего маркера, а при отсутствии такового - до конца таймлайна.
Do Not Wait: Если этот параметр активирован, нода Play Animation передаст управление следующей ноде сразу после начала воспроизведения анимации. В противном случае управление будет передано только после окончания анимации.

Stop Timeline¶

Останавливает воспроизведение NLA-анимации, запущенное нодой Play Animation.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Set First Frame: Если этот параметр активирован, анимация будет сброшена на первый кадр таймлайна после остановки воспроизведения. В противном случае анимация будет остановлена на кадре, заданном при помощи параметра End Marker ноды Play Timeline.

Play Animation¶

Эта нода используется для воспроизведения анимации объекта.

Проигрываемая анимация может иметь один из трёх типов:

Обычный Action:

Шейдерный Action:

Система частиц:

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Environment Anim.

Если этот параметр включён, воспроизводиться будет анимация окружающей среды (т.е., объекта типа World).

World

Задаёт объект типа World, анимация которого будет воспроизводиться. Этот параметр доступен только в том случае, если включена опция Environment Anim..

Object

Имя объекта, анимацию которого следует воспроизвести.

Variable

Если этот параметр включён, в поле Object может быть указана переменная типа Object.

Anim. Name

Имя анимации, которую следует воспроизвести. В случае, если имя анимации не указано, проигрывается вся временная шкала.

Behavior

Задаёт поведение анимации. Может иметь одно из следующих значений:

Finish Stop - анимация воспроизводится один раз.
Finish Reset - анимация воспроизводится один раз, после её завершения объект возвращается в исходное состояние.
Loop - анимация воспроизводится циклически до тех пор, пока не остановлена с помощью ноды Stop Animation.

Do Not Wait

Если этот параметр активирован, нода Play Animation передаст управление следующей ноде сразу после начала воспроизведения анимации. В противном случае управление будет передано только после окончания анимации.

Stop Animation¶

Используется для остановки анимации объекта.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Environmental Anim.: Если активирован этот параметр, остановлена будет анимация окружающей среды (т.е., объекта типа World).
World: Задаёт объект типа World, анимация которого будет остановлена. Этот параметр доступен только в том случае, если включена опция Environment Anim..
Object: Имя объекта, анимацию которого следует остановить.
Variable: Если этот параметр включён, в поле Object может быть указана переменная типа Object.
Set First Frame: Вернуться к первому кадру после того, как анимация остановлена.

Camera ¶

Move Camera¶

Позволяет перемещать камеру, в том числе с плавной интерполяцией положения.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Camera

Камера, которую необходимо переместить.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

Location

Объект, к которому перемещается камера. После того, как перемещение завершится, координаты камеры и объекта будут совпадать.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

Target

Объект, в направлении которого камера будет развёрнута после перемещения.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

Duration

Время (в секундах), которое займёт перемещение. По умолчанию равно нулю (в этом случае камера перемещается мгновенно). Может быть задано вручную или с помощью ссылки на переменную (эта возможность появляется при активации параметра Variable).

Set Camera Move Style¶

Используется для задания нового режима перемещения камеры.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Camera

Камера, режим перемещения которой будет изменён.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

New Camera Move Style

Задаёт новый режим перемещения выбранной камеры. Доступно четыре варианта: Hover, Eye, Target и Static.

Следующие параметры недоступны в том случае, если параметр New Camera Move Style имеет значение Static:

Translation: Задаёт скорость перемещения камеры. Значение по умолчанию - 1.0.
Rotation: Задаёт скорость поворота камеры. Значение по умолчанию - 1.0.
Zoom: Задаёт скорость приближения и удаления камеры. Значение по умолчанию - 0.10. Этот параметр доступен только в том случае, если параметр New Camera Move Style имеет значение Hover или Target.

Следующие параметры используются для задания цели или точки привязки камеры. Они доступны только если параметр New Camera Move Style имеет значение Hover или Target.

Use Object: Эта опция включает и выключает использования объекта сцены в качестве цели или точки привязки камеры (в зависимости от типа камеры). Если опция включена, появляется текстовое поле для задания объекта. Эта опция деактивирована по умолчанию.

Если параметр Use Object деактивирован, становятся доступны следующие три опции:

x: X-координата цели или точки привязки камеры.
y: Y-координата цели или точки привязки камеры.
z: Z-координата цели или точки привязки камеры.

Set Camera Limits¶

Эта нода применяется для настройки ограничений движения камеры. Нода содержит список всех ограничений, доступных в движке, но применяет только ограничения, совместимые с типом камеры.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Camera

Камера, ограничители движения которой будут изменены.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

Distance Limits

Задаёт параметр Distance Limits, доступный для камер типов Target и Hover.

Hor. Rotation Limits

Задаёт параметр Horizontal Rotation Limits, доступный для камер типов Target и Eye.

Vert. Rotation Limits

Задаёт параметр Vertical Rotation Limits, доступный для камер типов Target, Hover и Eye.

Pivot Translation Limits

Задаёт параметр Pivot Translation Limits, доступный для камер типа Target.

Hor. Translation Limits

Задаёт параметр Horizontal Translation Limits, доступный для камер типа Hover.

Vert. Translation Limits

Задаёт параметр Vertical Translation Limits, доступный для камер типа Hover.

Object ¶

Show Object¶

Используется для отображения объектов.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object: Объект, который нужно отобразить.
Variable: Если этот параметр включён, в поле Object может быть указана переменная типа Object.
Process child objects: Если этот параметр включён, объекты-потомки также будут показаны.

Hide Object¶

Используется для скрытия объекта.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object: Объект, который нужно скрыть.
Variable: Если этот параметр включён, в поле Object может быть указана переменная типа Object.
Process child objects: Если этот параметр включён, объекты-потомки также будут скрыты.

Transform Object¶

Используется для изменения координат, размеров и углов поворота объекта.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object

Объект, который нужно трансформировать.

Variable

Если этот параметр включён, в поле Object может быть указана переменная типа Object.

Space

Этот параметр определяет систему координат, которая будет использована для трансформации объекта. Может принимать одно из следующих значений:

World - глобальная система координат.
Parent - система координат объекта, который является предком объекта, указанного в параметре Object. Точка привязки родительского объекта используется как центр координат, а углы наклона задают направления координатных осей.
Local - локальная система координат выбранного объекта. Схожа с системой координат родительского объекта, но в данном случае точка привязки самого объекта используется в качестве начала координат.

Значение по умолчанию - World.

Location

Перемещение объекта по осям X, Y и Z. По умолчанию все три значения равны нулю. Значения могут быть заданы в самой ноде либо с помощью переменной (если включена опция Variable).

Rotation

Углы поворота объекта вокруг осей X, Y и Z. По умолчанию все три угла равны нулю. Значения могут быть заданы непосредственно в ноде или через переменные (в том случае, если включена опция Variable).

Scale

Масштаб объекта. Может быть задан напрямую или с помощью переменной (если включена опция Variable). По умолчанию равен нулю.

Duration

Время (в секундах), которое займёт трансформация. Может быть задано как напрямую, так и посредством переменной (для этого должна быть включена опция Variable). По умолчанию равно нулю.

Move To¶

Позволяет перемещать объекты.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object

Объект, который требуется переместить. Может быть задан напрямую или с помощью переменной (если включена опция Variable).

Destination

Цель (объект, источник света, камера и т.п.), к которой перемещается объект. После того, как перемещение завершится, координаты объекта и цели будут совпадать.

Этот параметр может быть задан напрямую или с помощью переменной типа Object (если включена опция Variable).

Duration

Время (в секундах), которое займёт перемещение. По умолчанию равно нулю (в этом случае объект не движется, а мгновенно перемещается к точке назначения). Может быть задано как в самой ноде, так и с помощью переменной (если активирован параметр Variable).

Apply Shape Key¶

Позволяет задать значение параметра Shape Key.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object: Объект, к которому нужно применить трансформацию.
Shape Key: Ключ формы, который нужно применить к объекту.
Value: Степень влияния выбранного ключа формы на объект. Значение может быть задано в самой ноде или взято из переменной (если установлен параметр Variable). Изменяется в пределах от 0 до 1.

Outline¶

Позволяет управлять эффектом обводки объекта.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object

Объект, эффект обводки которого требуется настроить.

Variable

Если этот параметр включён, в поле Object может быть указана переменная типа Object.

Operation

Операция, которую следует произвести с обводкой объекта. Этот параметр может принимать одно из следующих значений:

PLAY - включает анимацию обводки
STOP - выключает её
INTENSITY - позволяет настраивать интенсивность обводки

Intensity

Интенсивность обводки объекта. Этот параметр появляется только если параметр Operation имеет значение INTENSITY. Интенсивность может быть задана численно или взята из переменной (для этого нужно активировать параметр Variable).

Set Shader Node Param¶

Позволяет установить значение одного или нескольких параметров шейдерной ноды. В данный момент поддерживаются ноды Value и RGB.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Object: Объект, материал которого нужно отредактировать.
Material: Материал, параметры которого нужно изменить. Должен использовать ноды.
Node: Нода, параметры которой нужно изменить. На данный момент поддерживаются только ноды Value и RGB.
Parameters: Доступные для редактирования параметры выбранной ноды. Значения этих параметров могут быть заданы непосредственно в самой ноде или взяты из указанных переменных (для этого нужно активировать параметр Variable).

Inherit Material¶

Позволяет скопировать атрибуты одного материала на другой.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Source: Объект, которому присвоен материал, который требуется скопировать.
Material: Материал, который требуется скопировать.
Destination: Объект, которому требуется присвоить скопированный материал.
Material: Материал, который будет заменен скопированным материалом.

Operations ¶

Variable Store¶

Сохраняет числовое или строковое значение в переменную.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Var. name.: Имя переменной. Может быть выбрано из списка переменных либо задано самостоятельно (если включен параметр New variable).
Type: Тип переменной. Может иметь значения Number (численная переменная), String (строковая переменная) или Object (ссылка на объект).
Object: Этот параметр используется для задания объекта, используемого в качестве переменной. Доступен только в случае, если параметр Type имеет значение Object.
New Variable: Если этот параметр активирован, имя переменной может быть задано самостоятельно (а не выбрано из списка переменных). Может применяться для обмена данными с сервером.
Global: Включение этого параметра делает переменную глобальной. Доступен только если выбран параметр New Variable.

Math Operation¶

Выполнить математическую операцию и сохранить результат в регистр. Любой из параметров (операндов) может быть либо числовым значением, либо переменной.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Operation

Математическая операция, производимая над операндами. Может иметь один из следующих типов:

Random - генерация случайной величины больше первого операнда и меньше второго.
Add - сумма операндов.
Multiply - произведение операндов.
Subtract - разность операндов.
Divide - частное операндов.
Sin - синус угла (в радианах), заданного первым операндом.
Cos - косинус угла (в радианах), заданного первым операндом.
Tan - тангенс угла (в радианах), заданного первым операндом.
ArcSin - арксинус значения, заданного первым операндом.
ArcCos - арккосинус значения, заданного первым операндом.
ArcTan - арктангенс значения, заданного первым операндом.
Log - логарифм первого операнда; в качестве базы используется второй операнд.
Min - возвращает наименьший из двух операндов.
Max - возвращает наибольший из двух операндов.
Round - округляет первый операнд.
Mod - остаток от деления первого операнда на второй.
Abs - значение первого операнда по модулю.

Operand1

Первый операнд. Может представлять собой численное значение либо ссылку на одну из переменных (в случае, если активирован параметр Variable).

Operand2

Второй операнд. Аналогичен первому.

Destination

Переменная, в которую помещается результат операции.

String Operation¶

Выполнить операцию над строковыми переменными и сохранить результат в переменную.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Operation

Операция, которую нужно произвести над строками. Может иметь одно из следующих значений:

Join - объединить первую строку со второй.
Find - записывает в переменную позицию первого вхождения второй строки в первую. Если вхождений нет, в переменную записывается результат -1. Следует иметь в виду, что символы строки нумеруются, начиная с нуля, а не с единицы.
Replace - найти содержимое второй строки в первой и заменить третьей.
Split - разделить первую строку на две части, используя первое вхождение второй строки как маркер места разделения.
Compare - сравнить первую строку со второй. Для работы этой операции требуется определить логическое условие. Если условие выполняется, в Destination будет будет записана единица, если нет - ноль.

Condition

Логическое условие, по которому сравниваются строки. Этот параметр появляется только если параметр Operation имеет значение Compare. Аналогично параметру Condition ноды Conditional Jump.

Operand1

Первая строка. Может быть задана в самой ноде или с помощью переменной.

Operand2

Вторая строка. Аналогична первой.

Operand3

Этот параметр появляется только если параметр Operation имеет значение Replace. Здесь задаётся строка, которой будет заменена вторая строка.

Destination

Переменная, в которую будет сохранён результат операции.

Destination2

Этот параметр появляется только в том случае, если параметр Operation имеет значение Split. Определяет переменную, в которую будет сохранена вторая половина разделённой строки.

Sound ¶

Play Sound¶

Позволяет воспроизводить звук спикера.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Speaker: Источник звука, который требуется активировать.
Variable: Если этот параметр включён, в поле Speaker можно указать переменную типа Object.
Do Not Wait: Если этот параметр активирован, управление будет передано следующей ноде сразу же после того, как началось воспроизведение звука. В противном случае это произойдёт только после того, как звук закончится.

Stop Sound¶

Позволяет останавливать звук спикера.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Speaker: Источник звука, который нужно отключить.
Variable: Если этот параметр включён, в поле Speaker можно указать переменную типа Object.

Network ¶

Send Request¶

Позволяет отправить HTTP GET запрос на указанный URL и поместить значения полей ответа в переменную.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Method

Метод отправки запроса. Может иметь одно из двух значений:

GET - отправляет запрос на получение данных с сервера.
POST - отправляет данные на сервер.

Значение по умолчанию - GET.

Url

Адрес, на который следует отправить запрос. Может быть задан напрямую или с помощью переменной (если включена опция Variable URL). По умолчанию имеет значение “https://www.blend4web.com”.

Response Params

Задаёт переменную, в которую будут сохранены данные с сервера.

Примечание

Информация, полученная с сервера, должна быть в формате JSON:

{
    "var0": 1,
    "var1": 10,
    "var2": 144
}

Content-Type: Определяет формат запроса. Состоит из типа и подтипа, например: text/plain. Значение по умолчанию - Auto. Используется для переназначения заголовка HTTP-запроса.
Request Params: Задаёт переменную, содержащую JSON-объект, который будет отправлен на сервер. Этот параметр доступен только если параметр Method имеет значение POST. Значение по умолчанию - R1.

JSON¶

Используется для кодирования и декодирования сложных JSON-объектов.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

JSON: Сcылка на JSON-объект, который нужно кодировать или декодировать. По умолчанию имеет значение R1.
JSON Operation: Операция, которую нужно произвести над JSON-объектом, указанном в параметре JSON. Может иметь одно из двух значений: ENCODE кодирует объект, PARSE декодирует его. Значение по умолчанию - ENCODE.
Paths: Список путей к переменным внутри объекта JSON. Пути используются для определения внутренней структуры объекта. Путь должен состоять из нескольких идентификаторов (разделённых точками), указывающих адрес поля JSON. Если имя фрагмента пути состоит только из цифр, такое имя интерпретируется как индекс массива. Пути создаются и удаляются вместе с переменными (в списке Variables); один путь всегда соответствует одной переменной. Список путей может использоваться как для кодирования, так и для декодирования объектов JSON. По умолчанию список пуст.
Variables: Список переменных, которые будут использованы для кодирования или декодирования JSON-объекта (в зависимости от значения параметра JSON Operation). Имена и количество переменных могут быть настроены. Этот список также пуст по умолчанию.

Кодирование объекта JSON с помощью логической ноды JSON.¶

_images/logic_editor_json_encode_example.png

Логическое дерево на изображении выше кодирует объект JSON и сохраняет его в переменной R1. Закодированный объект JSON будет иметь следующий вид:

{
    "main":{
        "part1":7,
        "part2":12,
        "part3":"abc"
    }
}

Декодирование объекта JSON с помощью логической ноды JSON.¶

_images/logic_editor_json_decode_example.png

Логическое дерево на изображении выше получает объект JSON с сервера, сохраняет его в переменной R1 и декодирует объект. Объект JSON имеет следующий вид:

{
    "a": {
        "b": 17,
        "c": "abc"
    }
}

При декодировании объекта JSON в этом примере создаются три переменные (создавать их заранее не требуется) с именами var0, var1 и var2, которые содержат разные части объекта JSON. В данном случае переменная var1 будет иметь значение, равное 17, переменная var2 будет иметь значение «abc», а переменная var0 будет содержать следующий фрагмент объекта JSON:

{
    "b": 17,
    "c": "abc"
}

Page Param¶

Позволяет сохранить произвольный параметр веб-страницы в выбранной переменной.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Param Name

Имя параметра веб-страницы.

Если параметр с данным именем присутствует в URL-строке, то его значение будет сохранено в переменную, определенную полем Destination.

Destination

Переменная, в которую следует сохранить параметр.

Param type

Тип параметра веб-страницы. Доступные значения: Number, String и Object.

Hash param

Если включена эта опция, нода Page Param возвращает хэш-параметры; если она не включена, нода возвращает обычные URL-параметры.

Page Redirect¶

Служит для перенаправления на другие веб-страницы. По этой причине нода всегда находится в конце логической цепочки и не имеет выходных параметров.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Отсутствуют.

Внутренние параметры¶

Url: Адрес веб-страницы, которая будет открыта. Может быть задан напрямую или с помощью переменной (если включена опция Variable URL). Значение по умолчанию - “https://www.blend4web.com”.

Time ¶

Date & Time¶

Эта нода возвращает текущее время и дату.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Time Format

Этот параметр определяет формат, в котором измеряется время. Он может принимать одно из следующих значений:

UTC: Всемирное координированное время.

Примечание

Всемирное координированное время, возвращаемое этой нодой, основывается на локальном системном времени и часовом поясе.
Local: Значение по умолчанию. Если выбрано это значение, нода возвращает локальное системное время.

Время и дата возвращаются в виде набора чисел (текущий год, месяц, день и т.д.), каждое из которых может быть записано в специально выбранную переменную. Среди этих чисел:

Year: Текущий год.
Month: Текущий месяц.
Day: Текущий день.
Hours: Часы.
Minutes: Минуты.
Seconds: Секунды.

Get Timeline¶

Эта нода используется для получения текущего кадра NLA-анимации или таймлайна.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

NLA Timeline: Если этот параметр активирован, нода будет возвращать текущий кадр NLA-анимации. Если параметр не активирован, нода будет возвращать текущий кадр таймлайна. Включено по умолчанию.
Destination: Задаёт переменную, в которую будет сохранено значение текущего кадра. По умолчанию имеет значение R1.

Elapsed¶

Эта нода возвращает время, прошедшее с момента рендеринга предыдущего кадра.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Логическая нода Elapsed обладает одним внутренним параметром, позволяющим пользователю назначить переменную, в которую будет записано количество секунд, прошедших с момента рендеринга предыдущего кадра. По умолчанию используется переменная R1.

Delay¶

Позволяет установить задержку (в секундах) перед выполнением следующей ноды.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Value: Время (в секундах), на которое задерживается передача управления следующей ноде. По умолчанию равно нулю. Может быть задано в явном виде или же взято из переменной (в случае, если активирован параметр Variable).

Layout ¶

Frame¶

Дополнительный элемент, который применяется для разделения нод на группы.

Совет

Это не обязательное требование, но frame’ы рекомандуется использовать в сложных нодовых деревьях, чтобы сделать их проще для восприятия.

Элемент Frame обладает рядом параметров, доступных из панели Properties. Среди этих параметров - Label (используется для задания заголовка frame’а) и Color (устанавливает цвет frame’а).

Этот элемент также присутствует в стандарнтных нодовых редакторах Blender.

Empty¶

Простая нода, не выполняющая никаких действий кроме передачи управления следующей ноде. Может применяться для объединения нескольких логических нитей в одну или для того, чтобы сделать логическое дерево более простым для понимания.

Входные параметры¶

Previous: Предыдущая нода (либо несколько нод).

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Отсутствуют.

Reroute¶

В редакторе логики также присутствуют элементы Reroute - специальные ноды, который не выполняют никаких операций, а только передают управление следующей ноде (или следующему элементу Reroute). Они могут применяться для создания циклических структур или для того, чтобы сделать логическую цепочку более понятной и лёгкой для восприятия.

В отличие от ноды Empty, через элемент Reroute может проходить только одна логическая нить.

Примечание

Выходной параметр не может быть подключён к входному параметру той же ноды. В случае, когда это требуется сделать (например, для того, чтобы зациклить выполнение какой-либо операции), следует использовать Reroute.

Debug ¶

Console Print¶

Позволяет выводить значения переменных и дополнительную информацию в консоли браузера. Может использоваться для отладки логики.

Входные параметры¶

Previous: Предыдущая нода.

Выходные параметры¶

Next: Следующая нода.

Внутренние параметры¶

Message: Сообщение, которые будет напечатано в консоли вместе со значениями переменных.
<имя переменной>: Имя одной из переменных, значение которой нужно вывести в консоли. По умолчанию нода Console Print имеет один параметр такого типа, также имеется возможность создавать новые и удалять уже существующие (нода может и не иметь ни одного параметра этого типа).

Other Features ¶

Для отладки имеется возможность отключения (muting) нод. Для этого необходимо выделить ноду и нажать горячую клавишу M. Отключенная нода не выполняется, но при этом передает управление следующей ноде. Если у отключенной ноды имеется несколько выходов, то будет происходить выполнение ветки со стороны выхода отрицательного результата (Miss, False).