Python скрипты

Wrap поддерживает Python для скриптинга проекта и выражений параметров.

Совет

В настоящее время используется Python 3.8.3.

Выражение параметров в Python

Рядом с большинством параметров ноды находится кнопка создания скрипта.

../_images/PythonScriptingButton.jpg

Если скрипт параметров вычисляется с ошибками, кнопка скриптинга становится красной. Если вы удерживаете мышь над кнопкой скриптинга, отображается сообщение об ошибке.

При нажатии на кнопку скриптинга появляется диалог Python Expression Editor.

../_images/PythonExpressionEditor.png

Одна строка кода рассматривается как выражение Python и должна возвращать значение.

1 + 2 * 3

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

fileName = "Model.obj"
dir = "C:/Models/"
return dir + fileName

В настоящее время поддерживается семь встроенных функций:

  • frame() возвращает номер текущего кадра на временной шкале.

  • frameRange() возвращает кортеж из начального и конечного номеров временной шкалы.

  • nodeParamValue("nodeName", "paramName") возвращает значение параметра ноды.

  • commonDir() возвращает значение $COMMON_DIR.

  • galleryDir() возвращает значение $GALLERY_DIR.

  • projectDir() возвращает значение $PROJECT_DIR.

  • projectName() возвращает значение $PROJECT_NAME.

  • projectPath() возвращает абсолютный путь к файлу проекта, или пустую строку, если проект не был сохранен.

Скрипт проекта Python

Каждый проект Wrap имеет сценарий проекта, в котором может храниться Python-код, доступный из каждого выражения параметров. В скрипте проекта можно хранить общие функции или классы, которые можно многократно использовать в разных местах.

Перейдите в File >> Edit Project Script или нажмите CTRL + I, чтобы открыть диалог Project Script Editor.

../_images/PythonProjectScriptEditor.png