ClippedCamera

Inherits: Camera < Spatial < Node < Object

A Camera that includes collision.

Description

This node extends Camera to add collisions with Area and/or PhysicsBody nodes. The camera cannot move through colliding objects.

Methods

void

add_exception ( Object node )

void

add_exception_rid ( RID rid )

void

clear_exceptions ( )

float

get_clip_offset ( ) const

bool

get_collision_mask_bit ( int bit ) const

void

remove_exception ( Object node )

void

remove_exception_rid ( RID rid )

void

set_collision_mask_bit ( int bit, bool value )

Enumerations

enum ProcessMode:

  • CLIP_PROCESS_PHYSICS = 0 --- The camera updates with the _physics_process callback.

  • CLIP_PROCESS_IDLE = 1 --- The camera updates with the _process callback.

Property Descriptions

  • bool clip_to_areas

Default

false

Setter

set_clip_to_areas(value)

Getter

is_clip_to_areas_enabled()

If true, the camera stops on contact with Areas.


  • bool clip_to_bodies

Default

true

Setter

set_clip_to_bodies(value)

Getter

is_clip_to_bodies_enabled()

If true, the camera stops on contact with PhysicsBodys.


  • int collision_mask

Default

1

Setter

set_collision_mask(value)

Getter

get_collision_mask()

The camera's collision mask. Only objects in at least one collision layer matching the mask will be detected. See Collision layers and masks in the documentation for more information.


Default

0.0

Setter

set_margin(value)

Getter

get_margin()

The camera's collision margin. The camera can't get closer than this distance to a colliding object.


Default

0

Setter

set_process_mode(value)

Getter

get_process_mode()

The camera's process callback. See ProcessMode.

Method Descriptions

  • void add_exception ( Object node )

Adds a collision exception so the camera does not collide with the specified node.


  • void add_exception_rid ( RID rid )

Adds a collision exception so the camera does not collide with the specified RID.


  • void clear_exceptions ( )

Removes all collision exceptions.


  • float get_clip_offset ( ) const

Returns the distance the camera has been offset due to a collision.


  • bool get_collision_mask_bit ( int bit ) const

Returns true if the specified bit index is on.

Note: Bit indices range from 0-19.


  • void remove_exception ( Object node )

Removes a collision exception with the specified node.


  • void remove_exception_rid ( RID rid )

Removes a collision exception with the specified RID.


  • void set_collision_mask_bit ( int bit, bool value )

Sets the specified bit index to the value.

Note: Bit indices range from 0-19.