Module prelude

Often-imported symbols.

Re-exports

pub use super::builtin::math::FloatExt as _;

pub use super::obj::EngineBitfield as _;

pub use super::obj::EngineEnum as _;

pub use super::obj::NewAlloc as _;

pub use super::obj::NewGd as _;

pub use super::obj::WithBaseField as _;

Modules

real_consts

Re-export of std::f32::consts or std::f64::consts, depending on precision config.

Macros

array

Constructs Array literals, similar to Rust’s standard vec! macro.

dict

Constructs Dictionary literals, close to Godot’s own syntax.

godot_error

Pushes an error message to Godot’s built-in debugger and to the OS terminal.

godot_print

Prints to the Godot console.

godot_print_rich

Prints to the Godot console. Supports BBCode, color and URL tags.

godot_script_error

Logs a script error to Godot’s built-in debugger and to the OS terminal.

godot_warn

Pushes a warning message to Godot’s built-in debugger and to the OS terminal.

real

A macro to coerce float-literals into the real type.

reals

Array of reals.

swizzle

Access vector components in different order.

varray

Constructs VariantArray literals, similar to Rust’s standard vec! macro.

Structs

Aabb

Axis-aligned bounding box in 3D space.

Array

Godot’s Array type.

AudioStreamPlayer

Godot class AudioStreamPlayer.

Base

Restricted version of Gd, to hold the base instance inside a user’s GodotClass.

Basis

A 3x3 matrix, typically used as an orthogonal basis for Transform3D.

Callable

A Callable represents a function in Godot.

Camera2D

Godot class Camera2D.

Camera3D

Godot class Camera3D.

Color

Color built-in type, in floating-point RGBA format.

ColorHsv

HSVA floating-number Color representation.

ConvertError

Represents errors that can occur when converting values from Godot.

Dictionary

Godot’s Dictionary type.

DynGd

Smart pointer integrating Rust traits via dyn dispatch.

DynGdMut

Mutably/exclusively bound reference guard for a DynGd smart pointer.

DynGdRef

Shared reference guard for a DynGd smart pointer.

GFile

Open a file for reading or writing.

GString

Godot’s reference counted string type.

Gd

Smart pointer to objects owned by the Godot engine.

GdMut

Mutably/exclusively bound reference guard for a Gd smart pointer.

GdRef

Immutably/shared bound reference guard for a Gd smart pointer.

Input

Godot class Input.

InstanceId

Represents a non-zero instance ID.

IoError

Error that can occur while using gdext IO utilities.

Node

Godot class Node.

Node2D

Godot class Node2D.

Node3D

Godot class Node3D.

NodePath

A pre-parsed scene tree path.

Object

Godot class Object.

OnReady

Ergonomic late-initialization container with ready() support.

PackedByteArray

Implements Godot’s PackedByteArray type, which is a space-efficient array of u8s.

PackedColorArray

Implements Godot’s PackedColorArray type, which is a space-efficient array of Colors.

PackedFloat32Array

Implements Godot’s PackedFloat32Array type, which is a space-efficient array of f32s.

PackedFloat64Array

Implements Godot’s PackedFloat64Array type, which is a space-efficient array of f64s.

PackedInt32Array

Implements Godot’s PackedInt32Array type, which is a space-efficient array of i32s.

PackedInt64Array

Implements Godot’s PackedInt64Array type, which is a space-efficient array of i64s.

PackedScene

Godot class PackedScene.

PackedStringArray

Implements Godot’s PackedStringArray type, which is a space-efficient array of GStrings.

PackedVector2Array

Implements Godot’s PackedVector2Array type, which is a space-efficient array of Vector2s.

PackedVector3Array

Implements Godot’s PackedVector3Array type, which is a space-efficient array of Vector3s.

PackedVector4Array

Implements Godot’s PackedVector4Array type, which is a space-efficient array of Vector4s.

Plane

3D plane in Hessian normal form.

Projection

A 4x4 matrix used for 3D projective transformations.

Quaternion

Unit quaternion to represent 3D rotations.

Rect2

2D axis-aligned bounding box.

Rect2i

2D axis-aligned integer bounding box.

RefCounted

Godot class RefCounted.

Resource

Godot class Resource.

SceneTree

Godot class SceneTree.

Signal

A Signal represents a signal of an Object instance in Godot.

StringName

A string optimized for unique names.

Transform2D

Affine 2D transform (2x3 matrix).

Transform3D

Affine 3D transform (3x4 matrix).

Variant

Godot variant type, able to store a variety of different types.

VariantOperator

Godot enum name: Variant.Operator.

VariantType

Godot enum name: Variant.Type.

Vector2

Vector used for 2D math using floating point coordinates.

Vector3

Vector used for 3D math using floating point coordinates.

Vector4

Vector used for 4D math using floating point coordinates.

Vector2i

Vector used for 2D math using integer coordinates.

Vector3i

Vector used for 3D math using integer coordinates.

Vector4i

Vector used for 4D math using integer coordinates.

Enums

ColorChannelOrder

Defines how individual color channels are laid out in memory.

EulerOrder

This enum is exhaustive; you should not expect future Godot versions to add new enumerators.

ProjectionEye

The eye to create a projection for, when creating a projection adjusted for head-mounted displays.

ProjectionPlane

A projection’s clipping plane.

Rid

A RID (“resource ID”) is an opaque handle that refers to a Godot Resource.

Side

This enum is exhaustive; you should not expect future Godot versions to add new enumerators.

Vector2Axis

Enumerates the axes in a Vector2.

Vector3Axis

Enumerates the axes in a Vector3.

Vector4Axis

Enumerates the axes in a Vector4.

Traits

AsDyn

Trait that defines a T -> dyn Trait relation for use in DynGd.

Export

Trait implemented for types that can be used as #[export] fields.

ExtensionLibrary

Defines the entry point for a GDExtension Rust library.

FromGodot

Defines the canonical conversion from Godot for a type.

GodotClass

Makes T eligible to be managed by Godot and stored in Gd<T> pointers.

GodotConvert

Indicates that a type can be passed to/from Godot, either directly or through an intermediate “via” type.

IAudioStreamPlayer

Virtual methods for class AudioStreamPlayer.

ICamera2D

Virtual methods for class Camera2D.

ICamera3D

Virtual methods for class Camera3D.

INode

Virtual methods for class Node.

INode2D

Virtual methods for class Node2D.

INode3D

Virtual methods for class Node3D.

IObject

Virtual methods for class Object.

IPackedScene

Virtual methods for class PackedScene.

IRefCounted

Virtual methods for class RefCounted.

IResource

Virtual methods for class Resource.

ISceneTree

Virtual methods for class SceneTree.

Inherits

Non-strict inheritance relationship in the Godot class hierarchy.

RealConv

Convenience conversion between real and f32/f64.

RustCallable

Represents a custom callable object defined in Rust.

ToGodot

Defines the canonical conversion to Godot for a type.

Var

Trait implemented for types that can be used as #[var] fields.

Functions

load

⚠️ Loads a resource from the filesystem located at path, panicking on error.

save

⚠️ Saves a Resource-inheriting object into the file located at path.

try_load

Loads a resource from the filesystem located at path.

try_save

Saves a Resource-inheriting object into the file located at path.

Type Aliases

InitLevel

Stage of the Godot initialization process.

VariantArray

A Godot Array without an assigned type.

real

Floating point type used for many structs and functions in Godot.

Attribute Macros

gdextension

Proc-macro attribute to be used in combination with the ExtensionLibrary trait.

godot_api

Proc-macro attribute to be used with impl blocks of #[derive(GodotClass)] structs.

godot_dyn

Generates a Class -> dyn Trait upcasting relation.

Derive Macros

Export

Derive macro for Export on enums.

GodotClass

Derive macro for GodotClass on structs.

GodotConvert

Derive macro for GodotConvert on structs.

Var

Derive macro for Var on enums.