InstancePlaceholder
Заполнитель для корневого Entity PackedEntity.
Заполнитель для корневого Entity PackedEntity.
Включение параметра Загрузить как плейсхолдер для созданной сцены в редакторе приводит к её замене на InstancePlaceholder при запуске игры, но не заменяет узел в редакторе. Это позволяет отложить фактическую загрузку сцены до вызова InstancePlaceholder.CreateInstance. Это полезно, чтобы избежать одновременной загрузки больших сцен, загружая их по частям.
Примечание: Как и Entity, InstancePlaceholder не имеет преобразования. Это приводит к тому, что все дочерние узлы располагаются относительно начала координат Viewport, а не относительно их родительских узлов, как отображается в редакторе. Замена плейсхолдера на сцену с преобразованием снова преобразует дочерние узлы относительно их родительских узлов.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Методы3
CreateInstanceEntity
public Entity CreateInstance(bool replace = false, PackedEntity customScene = null);Вызовите этот метод для фактической загрузки узла. Созданный узел будет помещен как родственный выше InstancePlaceholder в дереве сцены. Ссылка на Entity также возвращается для удобства.
Примечание: InstancePlaceholder.CreateInstance не является потокобезопасным. Используйте ReckfellObject.CallDeferred при вызове из потока.
| Имя | Тип | По умолчанию |
|---|---|---|
replace | bool | false |
customScene | PackedEntity | null |
EntityGetInstancePathstring
public string GetInstancePath();Получает путь к файлу ресурсов PackedEntity, который загружается по умолчанию при вызове InstancePlaceholder.CreateInstance. Не потоко-безопасно. Используйте ReckfellObject.CallDeferred при вызове из потока.
stringGetStoredValuesReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary GetStoredValues(bool withOrder = false);Возвращает список свойств, которые будут применены к узлу при вызове InstancePlaceholder.CreateInstance.
Если with_order равен true, ключ с именем .order (обратите внимание на начальную точку) добавляется в словарь. Этот ключ .order представляет собой Reckfell.Collections.Array имен свойств string, определяющих порядок, в котором будут применены свойства (индекс 0 является первым).
| Имя | Тип | По умолчанию |
|---|---|---|
withOrder | bool | false |
Reckfell.Collections.Dictionary