Spatial

Inherits: Node < Object

Inherited By: Joint, RayCast, Camera, BoneAttachment, CollisionShape, Path, VisualInstance, VehicleWheel, Position3D, ProximityGroup, SpatialPlayer, WorldEnvironment, PathFollow, NavigationMeshInstance, Listener, InverseKinematics, VisibilityNotifier, Navigation, CollisionPolygon, GridMap, Skeleton, CollisionObject

Category: Core

Brief Description

Base class for all 3D nodes.

Member Functions

SpatialGizmo	get_gizmo ( ) const
Transform	get_global_transform ( ) const
Object	get_parent_spatial ( ) const
Vector3	get_rotation ( ) const
Vector3	get_rotation_deg ( ) const
Vector3	get_scale ( ) const
Transform	get_transform ( ) const
Vector3	get_translation ( ) const
World	get_world ( ) const
void	global_rotate ( Vector3 normal, float radians )
void	global_translate ( Vector3 offset )
void	hide ( )
bool	is_hidden ( ) const
bool	is_local_transform_notification_enabled ( ) const
bool	is_set_as_toplevel ( ) const
bool	is_visible ( ) const
void	look_at ( Vector3 target, Vector3 up )
void	look_at_from_pos ( Vector3 pos, Vector3 target, Vector3 up )
void	orthonormalize ( )
void	rotate ( Vector3 normal, float radians )
void	rotate_x ( float radians )
void	rotate_y ( float radians )
void	rotate_z ( float radians )
void	set_as_toplevel ( bool enable )
void	set_gizmo ( SpatialGizmo gizmo )
void	set_global_transform ( Transform global )
void	set_hidden ( bool hidden )
void	set_identity ( )
void	set_ignore_transform_notification ( bool enabled )
void	set_notify_local_transform ( bool enable )
void	set_rotation ( Vector3 rotation_rad )
void	set_rotation_deg ( Vector3 rotation_deg )
void	set_scale ( Vector3 scale )
void	set_transform ( Transform local )
void	set_translation ( Vector3 translation )
void	show ( )
void	translate ( Vector3 offset )
void	update_gizmo ( )

Signals

• visibility_changed ( )

Numeric Constants

• NOTIFICATION_TRANSFORM_CHANGED = 29 — Spatial nodes receive this notification with their global transform changes. This means that either the current or a parent node changed its transform.
• NOTIFICATION_ENTER_WORLD = 41
• NOTIFICATION_EXIT_WORLD = 42
• NOTIFICATION_VISIBILITY_CHANGED = 43

Description

Spatial is the base for every type of 3D Node. It contains a 3D Transform which can be set or get as local or global. If a Spatial Node has Spatial children, their transforms will be relative to the parent.

Member Function Description

SpatialGizmo get_gizmo ( ) const

Transform get_global_transform ( ) const

Return the global transform, relative to worldspace.

Object get_parent_spatial ( ) const

Return the parent Spatial, or an empty Object if no parent exists or parent is not of type Spatial.

Vector3 get_rotation ( ) const

Vector3 get_rotation_deg ( ) const

Vector3 get_scale ( ) const

Transform get_transform ( ) const

Return the local transform, relative to the bone parent.

Vector3 get_translation ( ) const

World get_world ( ) const

void global_rotate ( Vector3 normal, float radians )

void global_translate ( Vector3 offset )

void hide ( )

bool is_hidden ( ) const

bool is_local_transform_notification_enabled ( ) const

bool is_set_as_toplevel ( ) const

bool is_visible ( ) const

void look_at ( Vector3 target, Vector3 up )

void look_at_from_pos ( Vector3 pos, Vector3 target, Vector3 up )

void orthonormalize ( )

void rotate ( Vector3 normal, float radians )

void rotate_x ( float radians )

void rotate_y ( float radians )

void rotate_z ( float radians )

void set_as_toplevel ( bool enable )

void set_gizmo ( SpatialGizmo gizmo )

void set_global_transform ( Transform global )

Set the transform globally, relative to worldspace.

void set_hidden ( bool hidden )

void set_identity ( )

void set_ignore_transform_notification ( bool enabled )

void set_notify_local_transform ( bool enable )

void set_rotation ( Vector3 rotation_rad )

void set_rotation_deg ( Vector3 rotation_deg )

void set_scale ( Vector3 scale )

void set_transform ( Transform local )

Set the transform locally, relative to the parent spatial node.

void set_translation ( Vector3 translation )

void show ( )

void translate ( Vector3 offset )

void update_gizmo ( )