InstancePlaceholder

Inherits: Node < Object

PackedScene 根 Node 的占位。

描述

在编辑器中为实例化场景打开选项 加载为占位符 会导致在运行游戏时将其替换为实例占位符InstancePlaceholder。这使得实际加载场景的时间可以推迟到调用replace_by_instance。这对于通过选择性加载部分场景来避免一次性加载大场景很有用。

实例占位符没有变换(transform)属性。这导致任何子节点从点（0,0）开始相对于视窗进行定位，而不是在编辑器中显示的父节点。用一个具有变换属性的场景来替换占位符，将使子节点再次相对于它们的父节点进行变换。

方法

Node

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

String

get_instance_path ( ) const

Dictionary

get_stored_values ( bool with_order=false )

void

replace_by_instance ( PackedScene custom_scene=null )

方法说明

不是线程安全的。如果从线程调用，请使用Object.call_deferred。

  • String get_instance_path ( ) const

获取调用 replace_by_instance 时默认加载的 PackedScene 资源文件的路径。不是线程安全的。如果从线程调用，请使用Object.call_deferred。

  • void replace_by_instance ( PackedScene custom_scene=null )

用作为参数的场景替换这个占位符，如果没有给出参数，则替换原始场景。对于所有的资源来说，只有当场景还没有被加载时才会被加载。通过事先手动加载场景，可以避免由这个函数引起的延迟。