Struct gdnative_bindings_lily::InterpolatedCamera

pub struct InterpolatedCamera { /* fields omitted */ }

core class InterpolatedCamera inherits Camera (unsafe).

Official documentation

See the documentation of this class in the Godot engine’s official documentation. The method descriptions are generated from it and typically contain code samples in GDScript, not Rust.

Memory management

Non reference counted objects such as the ones of this type are usually owned by the engine.

InterpolatedCamera is a reference-only type. Persistent references can only exist in the unsafe Ref<InterpolatedCamera> form.

In the cases where Rust code owns an object of this type, for example if the object was just created on the Rust side and not passed to the engine yet, ownership should be either given to the engine or the object must be manually destroyed using Ref::free, or Ref::queue_free if it is a Node.

Class hierarchy

InterpolatedCamera inherits methods from:

• Camera
• Spatial
• Node
• Object

Safety

All types in the Godot API have “interior mutability” in Rust parlance. To enforce that the official thread-safety guidelines are followed, the typestate pattern is used in the Ref and TRef smart pointers, and the Instance API. The typestate Access in these types tracks whether the access is unique, shared, or exclusive to the current thread. For more information, see the type-level documentation on Ref.

Implementations

impl InterpolatedCamera

pub fn new() -> Ref<Self, Unique>

Creates a new instance of this object.

Because this type is not reference counted, the lifetime of the returned object is not automatically managed.

Immediately after creation, the object is owned by the caller, and can be passed to the engine (in which case the engine will be responsible for destroying the object) or destroyed manually using Ref::free, or preferably Ref::queue_free if it is a Node.

pub fn speed(&self) -> f64

How quickly the camera moves toward its target. Higher values will result in tighter camera motion.

pub fn target_path(&self) -> NodePath

The target’s NodePath.

pub fn is_interpolation_enabled(&self) -> bool

If true, and a target is set, the camera will move automatically.

pub fn set_interpolation_enabled(&self, target_path: bool)

If true, and a target is set, the camera will move automatically.

pub fn set_speed(&self, speed: f64)

How quickly the camera moves toward its target. Higher values will result in tighter camera motion.

pub fn set_target(&self, target: impl AsArg<Object>)

Sets the node to move toward and orient with.

pub fn set_target_path(&self, target_path: impl Into<NodePath>)

The target’s NodePath.

Methods from Deref<Target = Camera>

pub const DOPPLER_TRACKING_DISABLED: i64

pub const DOPPLER_TRACKING_IDLE_STEP: i64

pub const DOPPLER_TRACKING_PHYSICS_STEP: i64

pub const KEEP_HEIGHT: i64

pub const KEEP_WIDTH: i64

pub const PROJECTION_FRUSTUM: i64

pub const PROJECTION_ORTHOGONAL: i64

pub const PROJECTION_PERSPECTIVE: i64

pub fn clear_current(&self, enable_next: bool)

If this is the current camera, remove it from being current. If enable_next is true, request to make the next camera current, if any.

Default Arguments

• enable_next - true

pub fn get_camera_rid(&self) -> Rid

Returns the camera’s RID from the VisualServer.

pub fn get_camera_transform(&self) -> Transform

Gets the camera transform. Subclassed cameras such as InterpolatedCamera may provide different transforms than the Node transform.

pub fn cull_mask(&self) -> i64

The culling mask that describes which 3D render layers are rendered by this camera.

pub fn get_cull_mask_bit(&self, layer: i64) -> bool

Returns true if the given layer in the [member cull_mask] is enabled, false otherwise.

pub fn doppler_tracking(&self) -> DopplerTracking

If not [constant DOPPLER_TRACKING_DISABLED], this camera will simulate the [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] for objects changed in particular _process methods. See [enum DopplerTracking] for possible values.

pub fn environment(&self) -> Option<Ref<Environment, Shared>>

The Environment to use for this camera.

pub fn fov(&self) -> f64

The camera’s field of view angle (in degrees). Only applicable in perspective mode. Since [member keep_aspect] locks one axis, fov sets the other axis’ field of view angle.

pub fn get_frustum(&self) -> VariantArray

Returns the camera’s frustum planes in world-space units as an array of Planes in the following order: near, far, left, top, right, bottom. Not to be confused with [member frustum_offset].

pub fn frustum_offset(&self) -> Vector2

The camera’s frustum offset. This can be changed from the default to create “tilted frustum” effects such as [url=https://zdoom.org/wiki/Y-shearing]Y-shearing[/url].

pub fn h_offset(&self) -> f64

The horizontal (X) offset of the camera viewport.

pub fn keep_aspect_mode(&self) -> KeepAspect

The axis to lock during [member fov]/[member size] adjustments. Can be either [constant KEEP_WIDTH] or [constant KEEP_HEIGHT].

pub fn projection(&self) -> Projection

The camera’s projection mode. In [constant PROJECTION_PERSPECTIVE] mode, objects’ Z distance from the camera’s local space scales their perceived size.

pub fn size(&self) -> f64

The camera’s size measured as 1/2 the width or height. Only applicable in orthogonal mode. Since [member keep_aspect] locks on axis, size sets the other axis’ size length.

pub fn v_offset(&self) -> f64

The vertical (Y) offset of the camera viewport.

pub fn zfar(&self) -> f64

The distance to the far culling boundary for this camera relative to its local Z axis.

pub fn znear(&self) -> f64

The distance to the near culling boundary for this camera relative to its local Z axis.

pub fn is_current(&self) -> bool

If true, the ancestor Viewport is currently using this camera.

pub fn is_position_behind(&self, world_point: Vector3) -> bool

Returns true if the given position is behind the camera. Note: A position which returns false may still be outside the camera’s field of view.

pub fn make_current(&self)

Makes this camera the current camera for the Viewport (see class description). If the camera node is outside the scene tree, it will attempt to become current once it’s added.

pub fn project_local_ray_normal(&self, screen_point: Vector2) -> Vector3

Returns a normal vector from the screen point location directed along the camera. Orthogonal cameras are normalized. Perspective cameras account for perspective, screen width/height, etc.

pub fn project_position(&self, screen_point: Vector2, z_depth: f64) -> Vector3

Returns the 3D point in worldspace that maps to the given 2D coordinate in the Viewport rectangle on a plane that is the given z_depth distance into the scene away from the camera.

pub fn project_ray_normal(&self, screen_point: Vector2) -> Vector3

Returns a normal vector in worldspace, that is the result of projecting a point on the Viewport rectangle by the camera projection. This is useful for casting rays in the form of (origin, normal) for object intersection or picking.

pub fn project_ray_origin(&self, screen_point: Vector2) -> Vector3

Returns a 3D position in worldspace, that is the result of projecting a point on the Viewport rectangle by the camera projection. This is useful for casting rays in the form of (origin, normal) for object intersection or picking.

pub fn set_cull_mask(&self, mask: i64)

The culling mask that describes which 3D render layers are rendered by this camera.

pub fn set_cull_mask_bit(&self, layer: i64, enable: bool)

Enables or disables the given layer in the [member cull_mask].

pub fn set_current(&self, arg0: bool)

If true, the ancestor Viewport is currently using this camera.

pub fn set_doppler_tracking(&self, mode: i64)

If not [constant DOPPLER_TRACKING_DISABLED], this camera will simulate the [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] for objects changed in particular _process methods. See [enum DopplerTracking] for possible values.

pub fn set_environment(&self, env: impl AsArg<Environment>)

The Environment to use for this camera.

pub fn set_fov(&self, arg0: f64)

The camera’s field of view angle (in degrees). Only applicable in perspective mode. Since [member keep_aspect] locks one axis, fov sets the other axis’ field of view angle.

pub fn set_frustum(&self, size: f64, offset: Vector2, z_near: f64, z_far: f64)

Sets the camera projection to frustum mode (see [constant PROJECTION_FRUSTUM]), by specifying a size, an offset, and the z_near and z_far clip planes in world-space units.

pub fn set_frustum_offset(&self, arg0: Vector2)

The camera’s frustum offset. This can be changed from the default to create “tilted frustum” effects such as [url=https://zdoom.org/wiki/Y-shearing]Y-shearing[/url].

pub fn set_h_offset(&self, ofs: f64)

The horizontal (X) offset of the camera viewport.

pub fn set_keep_aspect_mode(&self, mode: i64)

The axis to lock during [member fov]/[member size] adjustments. Can be either [constant KEEP_WIDTH] or [constant KEEP_HEIGHT].

pub fn set_orthogonal(&self, size: f64, z_near: f64, z_far: f64)

Sets the camera projection to orthogonal mode (see [constant PROJECTION_ORTHOGONAL]), by specifying a size, and the z_near and z_far clip planes in world-space units. (As a hint, 2D games often use this projection, with values specified in pixels.)

pub fn set_perspective(&self, fov: f64, z_near: f64, z_far: f64)

Sets the camera projection to perspective mode (see [constant PROJECTION_PERSPECTIVE]), by specifying a fov (field of view) angle in degrees, and the z_near and z_far clip planes in world-space units.

pub fn set_projection(&self, arg0: i64)

The camera’s projection mode. In [constant PROJECTION_PERSPECTIVE] mode, objects’ Z distance from the camera’s local space scales their perceived size.

pub fn set_size(&self, arg0: f64)

The camera’s size measured as 1/2 the width or height. Only applicable in orthogonal mode. Since [member keep_aspect] locks on axis, size sets the other axis’ size length.

pub fn set_v_offset(&self, ofs: f64)

The vertical (Y) offset of the camera viewport.

pub fn set_zfar(&self, arg0: f64)

The distance to the far culling boundary for this camera relative to its local Z axis.

pub fn set_znear(&self, arg0: f64)

The distance to the near culling boundary for this camera relative to its local Z axis.

pub fn unproject_position(&self, world_point: Vector3) -> Vector2

Returns the 2D coordinate in the Viewport rectangle that maps to the given 3D point in worldspace.

Trait Implementations

impl Debug for InterpolatedCamera

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for InterpolatedCamera

type Target = Camera

The resulting type after dereferencing.

fn deref(&self) -> &Camera

Dereferences the value.

impl DerefMut for InterpolatedCamera

fn deref_mut(&mut self) -> &mut Camera

Mutably dereferences the value.

impl GodotObject for InterpolatedCamera

type RefKind = ManuallyManaged

The memory management kind of this type. This modifies the behavior of the Ref smart pointer. See its type-level documentation for more information.

fn class_name() -> &'static str

fn null() -> Null<Self>

Creates an explicitly null reference of Self as a method argument. This makes type inference easier for the compiler compared to Option.

fn new() -> Ref<Self, Unique> where
    Self: Instanciable, 

Creates a new instance of Self using a zero-argument constructor, as a Unique reference.

fn cast<T>(&self) -> Option<&T> where
    T: GodotObject + SubClass<Self>, 

Performs a dynamic reference downcast to target type.

fn upcast<T>(&self) -> &T where
    Self: SubClass<T>,
    T: GodotObject, 

Performs a static reference upcast to a supertype that is guaranteed to be valid.

unsafe fn assume_shared(&self) -> Ref<Self, Shared>

Creates a persistent reference to the same Godot object with shared thread access.

unsafe fn assume_thread_local(&self) -> Ref<Self, ThreadLocal> where
    Self: GodotObject<RefKind = RefCounted>, 

Creates a persistent reference to the same Godot object with thread-local thread access.

unsafe fn assume_unique(&self) -> Ref<Self, Unique>

Creates a persistent reference to the same Godot object with unique access.

unsafe fn try_from_instance_id<'a>(id: i64) -> Option<TRef<'a, Self, Shared>>

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive. See also TRef::try_from_instance_id.

unsafe fn from_instance_id<'a>(id: i64) -> TRef<'a, Self, Shared>

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive, and panics otherwise. This does NOT guarantee that the resulting reference is safe to use.

impl Instanciable for InterpolatedCamera

fn construct() -> Ref<Self, Unique>

impl QueueFree for InterpolatedCamera

unsafe fn godot_queue_free(obj: *mut godot_object)

impl Sealed for InterpolatedCamera

impl SubClass<Camera> for InterpolatedCamera

impl SubClass<Node> for InterpolatedCamera

impl SubClass<Object> for InterpolatedCamera

impl SubClass<Spatial> for InterpolatedCamera