EditorFeatureProfile — C# API

Данные ограничений интерфейса редактора, сохраняемые в .profile.

class EditorFeatureProfileReckfellSharpEditorНаследует RefCounted

Профиль может скрывать рабочие области, классы и свойства в инструментах редактора. Он не удаляет данные проекта или классы движка, не уменьшает экспорт и не является системой прав. SetDisable*() меняют объект данных; SaveToFile()/LoadFromFile() работают с JSON, но не активируют профиль.

Для применения используйте Editor → Manage Editor Features… → Import → Make Current; Reset to Default возвращает обычный интерфейс. Запреты native-классов и их контекстных редакторов наследуются, а IsClassPropertyDisabled() читает точную пару класса и свойства.

Создание, перенос и проверенный C#-пример.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

EditorFeatureProfileКонструктор

# EditorFeatureProfile

C#
public EditorFeatureProfile();

Методы11

GetFeatureNamestring

# GetFeatureName

C#
public string GetFeatureName(EditorFeatureProfile.Feature feature);

Возвращает читаемую подпись возможности редактора. Не используйте переводимую подпись как постоянный ключ JSON или идентификатор правила.

Параметры
Имя	Тип	По умолчанию
`feature`	`EditorFeatureProfile.Feature`	—

feature

Допустимый элемент Feature; Max обозначает размер enum, а не возможность.

Возвращает string

Отображаемое имя возможности.

IsClassDisabledbool

# IsClassDisabled

C#
public bool IsClassDisabled(StringName className);

Проверяет запрет native-класса с обходом родителей ClassDB. true может быть унаследовано: снятие собственного запрета потомка не отменяет запрет предка.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—

className

Native-имя класса Reckfell, например Entity3D.

Возвращает bool

true, если класс или native-предок запрещён.

IsClassEditorDisabledbool

# IsClassEditorDisabled

C#
public bool IsClassEditorDisabled(StringName className);

Проверяет запрет контекстного редактора класса с обходом native-предков. Не равнозначно запрету создания класса или универсальному read-only Inspector.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—

className

Native-имя класса Reckfell, например Entity3D.

Возвращает bool

true при собственном или унаследованном запрете контекстного редактора.

IsClassPropertyDisabledbool

# IsClassPropertyDisabled

C#
public bool IsClassPropertyDisabled(StringName className, StringName property);

Проверяет точную пару native-класса и свойства без обхода родителей. Inspector выполняет обход сам: false для Sprite2D не отменяет запись CanvasItem:modulate. Это запрос данных профиля, не полная проверка видимости поля.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—
`property`	`StringName`	—

className

Native-имя класса Reckfell, например Entity3D.

property

Native-имя свойства, например modulate, не C# Modulate или переводимая подпись.

Возвращает bool

true только при наличии указанной точной записи.

IsFeatureDisabledbool

# IsFeatureDisabled

C#
public bool IsFeatureDisabled(EditorFeatureProfile.Feature feature);

Читает флаг крупной возможности редактора. Отключение Feature3D отдельно от запрета классов Entity3D. Не проверяет наличие функции в сборке движка.

Параметры
Имя	Тип	По умолчанию
`feature`	`EditorFeatureProfile.Feature`	—

feature

Допустимый элемент Feature; Max обозначает размер enum, а не возможность.

Возвращает bool

true, если флаг отключения установлен.

LoadFromFileError

# LoadFromFile

C#
public Error LoadFromFile(string path);

Загружает JSON формата feature_profile в этот экземпляр, не активируя его в редакторе. В 1.0.0 отсутствие disabled_features сохраняет прежние флаги возможностей; для независимого чтения создавайте свежий экземпляр. Не считайте ошибку обещанием полного отката состояния.

Параметры
Имя	Тип	По умолчанию
`path`	`string`	—

path

Путь экспортированного JSON-профиля .profile.

Возвращает Error

Error.Ok при успешной загрузке; иначе код ошибки чтения или разбора.

SaveToFileError

# SaveToFile

C#
public Error SaveToFile(string path);

Записывает JSON-профиль с маркером type=feature_profile и массивами запретов. Используйте .profile для импорта менеджером; это не сериализация обычного ресурса .rdata и не активация профиля.

Параметры
Имя	Тип	По умолчанию
`path`	`string`	—

path

Путь файла в существующем доступном для записи каталоге.

Возвращает Error

Код результата сохранения; проверьте его до импорта файла.

SetDisableClassvoid

# SetDisableClass

C#
public void SetDisableClass(StringName className, bool disable);

Задаёт запрет native-класса в этом объекте профиля. Потомки наследуют его при проверке. Не удаляет классы из движка и не активирует профиль в редакторе автоматически.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—
`disable`	`bool`	—

className

Native-имя класса Reckfell, например Entity3D.

disable

true отключает возможность; false снимает собственный запрет.

SetDisableClassEditorvoid

# SetDisableClassEditor

C#
public void SetDisableClassEditor(StringName className, bool disable);

Задаёт запрет специализированного контекстного редактора класса. Проверка наследует правило родителя. Отдельно управляйте доступностью класса и видимостью свойств; эта настройка не обещает запрет записи из кода.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—
`disable`	`bool`	—

className

Native-имя класса Reckfell, например Entity3D.

disable

true отключает возможность; false снимает собственный запрет.

SetDisableClassPropertyvoid

# SetDisableClassProperty

C#
public void SetDisableClassProperty(StringName className, StringName property, bool disable);

Задаёт точный запрет свойства в классе. Inspector учитывает такие записи родителей. Для disable=false сначала проверьте IsClassPropertyDisabled(): в 1.0.0 снятие правила у класса без записанных свойств выдаёт ошибку native API.

Параметры
Имя	Тип	По умолчанию
`className`	`StringName`	—
`property`	`StringName`	—
`disable`	`bool`	—

className

Native-имя класса Reckfell, например Entity3D.

property

Точное native-имя свойства; значение данных не удаляется.

disable

true отключает возможность; false снимает собственный запрет.

SetDisableFeaturevoid

# SetDisableFeature

C#
public void SetDisableFeature(EditorFeatureProfile.Feature feature, bool disable);

Меняет флаг интерфейса в объекте профиля. Это не удаление подсистемы, оптимизация экспорта или применение профиля в запущенном редакторе.

Параметры
Имя	Тип	По умолчанию
`feature`	`EditorFeatureProfile.Feature`	—
`disable`	`bool`	—

feature

Допустимый элемент Feature; Max обозначает размер enum, а не возможность.

disable

true отключает возможность; false снимает собственный запрет.

EditorFeatureProfile.Feature

Значение	Описание
`AssetLib = 2`	Вкладка Хранение активов. Если эта функция отключена, вкладка Хранение активов отображаться не будет.
`Feature3D = 0`	3D-редактор. Если эта функция отключена, то 3D-редактор не будет отображать, но 3D узлы будут показываться в New Entity Диалог.
`FilesystemDock = 5`	Просмотр контента. Если эта функция отключена, то он не будет виден.
`Game = 8`	Вкладка «Игра», которая позволяет встраивать игровое окно и выбирать узлы, щелкая внутри него. Если эта функция отключена, вкладка «Игра» не будет отображаться.
`GroupsDock = 10`	Панель «Группы». Если эта функция отключена, группы не будут видны и недоступны для изменения в редакторе.
`HistoryDock = 7`	Док истории. Если эта функция отключена, док истории не будет виден.
`ImportDock = 6`	Док импорта. Если эта функция отключена, док импорта не будет виден.
`Max = 11`	Представляет размер перечисления `EditorFeatureProfile.Feature`.
`NodeDock = 4`	Устаревший API Отмечено атрибутом Obsolete в установленном SDK. Сообщение SDK на английском: Replaced by the Signals and Groups docks. Док-станция Entity. Если эта функция отключена, сигналы и группы не будут видны и не будут доступны для изменения из редактора.
`SceneTree = 3`	Редактирование дерева сцены. Если эта функция отключена, док-станция дерева сцены будет по-прежнему видна, но будет доступна только для чтения.
`Script = 1`	Вкладка Script, которая содержит редактор скриптов и браузер ссылок на классы. Если эта функция отключена, вкладка Script не будет отображаться.
`SignalsDock = 9`	Панель «Сигналы». Если эта функция отключена, сигналы не будут видны и недоступны для изменения в редакторе.