VisualShaderNodeCustom

public bool Initialized { get; set; }

Внутренний флаг инициализации элемента редактора. Не используйте его как признак GPU-компиляции или готовности материала. При true обычные методы изменения начальных входов пользовательского блока ограничены.

public string Properties { get; set; }

Внутреннее сериализованное представление выбора выпадающих настроек. Для объявления вариантов используйте _GetProperty*(), а для чтения выбора — GetOptionIndex(); не собирайте строку вручную.

public int GetOptionIndex(int option);

Читает сохранённый выбор выпадающей настройки для генерации кода. Если для настройки нет сохранённого значения, native-реализация возвращает 0.

public virtual string _GetCategory();

Задаёт путь категории пользовательского блока, например Reckfell/Color. Редактор добавляет префикс Addons; разделитель / создаёт вложенность. Не применяйте ограничения имени блока к всему пути.

public virtual string _GetCode(Reckfell.Collections.Array<string> inputVars, Reckfell.Collections.Array<string> outputVars, Shader.Mode mode, VisualShader.Type type);

Возвращает инструкции на шейдерном языке Reckfell для одного экземпляра блока. Используйте выражения inputVars и присваивайте результаты outputVars; подписи портов не заменяют эти строки. Не объявляйте общую функцию повторно в каждом экземпляре.

public virtual int _GetDefaultInputPort(VisualShaderNode.PortType type);

Выбирает вход при создании блока протягиванием связи в пустую область графа. Возвращайте подходящий индекс для переданного типа. В native-реализации 1.0.0 без переопределения возвращается 0.

public virtual string _GetDescription();

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

public virtual string _GetFuncCode(Shader.Mode mode, VisualShader.Type type);

Добавляет общий код в начало функций шейдера для данного типа блока. Порядок вставки кода разных пользовательских типов не определён; не стройте между ними зависимость от порядка.

public virtual string _GetGlobalCode(Shader.Mode mode);

Добавляет общие объявления вне функций шейдера. Для одного использованного C#-скрипта генератор добавляет их один раз, даже при нескольких экземплярах. Используйте уникальные имена и не храните здесь состояние отдельного экземпляра.

public virtual int _GetInputPortCount();

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

public virtual Variant _GetInputPortDefaultValue(int port);

Возвращает начальное значение неподключённого входа. Редактор применяет callback при добавлении блока через UI. В 1.0.0 программный VisualShader.AddNode() сам эти значения не записывает: явно вызовите SetInputPortDefaultValue() после добавления.

public virtual string _GetInputPortName(int port);

Задаёт подпись входного порта. Это не готовое имя переменной GPU: в _GetCode() используйте переданное выражение inputVars[port].

public virtual VisualShaderNode.PortType _GetInputPortType(int port);

Задаёт тип данных входа. Согласуйте его со значением по умолчанию и выражениями шейдерного кода; Vector3D соответствует vec3, Scalar — float.

public virtual string _GetName();

Задаёт имя блока в списке добавления и графе. Для регистрации в редакторе используйте допустимый ASCII-идентификатор без пробелов, например BlendTint.

public virtual int _GetOutputPortCount();

Задаёт число выходных портов блока. Каждому вычисляемому выходу присвойте значение в _GetCode().

public virtual string _GetOutputPortName(int port);

Задаёт подпись выходного порта. В _GetCode() присваивайте результат outputVars[port], а не строке подписи.

public virtual VisualShaderNode.PortType _GetOutputPortType(int port);

Задаёт тип данных выхода; генерируемое присваивание должно выдавать совместимое значение.

public virtual int _GetPropertyCount();

Задаёт число выпадающих настроек пользовательского блока; это не число входных портов. Для каждой задайте имя, список вариантов и при необходимости начальный индекс.

public virtual int _GetPropertyDefaultIndex(int index);

Задаёт начальный индекс выбранного варианта выпадающей настройки. Он должен соответствовать массиву _GetPropertyOptions().

public virtual string _GetPropertyName(int index);

Задаёт подпись выпадающей настройки блока.

public virtual string[] _GetPropertyOptions(int index);

Задаёт упорядоченный список вариантов выпадающей настройки. Выбранный индекс читается через GetOptionIndex().

public virtual VisualShaderNode.PortType _GetReturnIconType();

Выбирает значок типа результата в списке добавления. Это метаданные UI; настоящие типы выходов задаются _GetOutputPortType().

public virtual bool _IsAvailable(Shader.Mode mode, VisualShader.Type type);

Фильтрует доступность блока по режиму и этапу графа; по умолчанию true. Не переводит шейдерный код в другой режим и не доказывает его GPU-совместимость.

public virtual bool _IsHighend();

Помечает блок как требующий возможностей Forward+ или Mobile в списке добавления. По умолчанию false. Это подсказка редактора, а не переключение рендерера и не замена проверки GPU-кода.