InstancePlaceholder¶
Placeholder for the root Node of a PackedScene.
Description¶
Turning on the option Load As Placeholder for an instantiated scene in the editor causes it to be replaced by an InstancePlaceholder
when running the game, this will not replace the node in the editor. This makes it possible to delay actually loading the scene until calling create_instance. This is useful to avoid loading large scenes all at once by loading parts of it selectively.
The InstancePlaceholder
does not have a transform. This causes any child nodes to be positioned relatively to the Viewport from point (0,0), rather than their parent as displayed in the editor. Replacing the placeholder with a scene with a transform will transform children relatively to their parent again.
Methods¶
create_instance ( bool replace=false, PackedScene custom_scene=null ) |
|
get_instance_path ( ) const |
|
get_stored_values ( bool with_order=false ) |
Method Descriptions¶
Node create_instance ( bool replace=false, PackedScene custom_scene=null )
Not thread-safe. Use Object.call_deferred if calling from a thread.
String get_instance_path ( ) const
Gets the path to the PackedScene resource file that is loaded by default when calling create_instance. Not thread-safe. Use Object.call_deferred if calling from a thread.
Dictionary get_stored_values ( bool with_order=false )