跳到主要内容

InstancePlaceholder

继承

Node

简要描述

PackedScene的根Node的占位符。

描述

在编辑器中打开实例场景的选项加载为占位符会导致在运行游戏时将其替换为InstancePlaceholder。这可以延迟真实场景加载知道调用replace_by_instance。这对于避免加载大场景有用。

InstancePlaceholder没有转换。这会导致任何子节点被放置在相对于视口原点,而不是他们的父亲节点。用场景transform替换占位会transform子节点相对于父亲节点。

方法

返回值类型方法名称
Nodecreate_instance(replace: bool = false, custom_scene: PackedScene = null)
Stringget_instance_path() const
Dictionaryget_stored_values(with_order: bool = false)
voidreplace_by_instance(custom_scene: PackedScene = null)

方法说明

  • create_instance create_instance(replace: bool = false, custom_scene: PackedScene = null)

  • get_instance_path get_instance_path() const

获取到调用replace_by_instance时默认加载的PackedScene资源文件的路径。


  • get_stored_values get_stored_values(with_order: bool = false)

  • replace_by_instance replace_by_instance(custom_scene: PackedScene = null)

将此占位符替换为作为参数传递的场景,如果未提供参数,则替换为原始场景。对于所有资源,场景只有在没有被加载时,才会加载。可以通过手动提前加载场景。