Struct ambient_api::core::camera::concepts::OrthographicCamera

pub struct OrthographicCamera {

    pub local_to_world: Mat4,
    pub near: f32,
    pub projection: Mat4,
    pub projection_view: Mat4,
    pub active_camera: f32,
    pub inv_local_to_world: Mat4,
    pub orthographic: (),
    pub orthographic_left: f32,
    pub orthographic_right: f32,
    pub orthographic_top: f32,
    pub orthographic_bottom: f32,
    pub far: f32,
    pub optional: OrthographicCameraOptional,
}

Orthographic Camera: An orthographic camera.

Extends: ambient_core::camera::Camera

Required:

• local_to_world: Transformation from the entity’s local space to worldspace.
• near: The near plane of this camera, measured in meters.
• projection: The projection matrix of this camera. This can be driven by other components, including perspective and perspective_infinite_reverse.
• projection_view: The composition of the projection and view (inverse-local-to-world) matrices.
• active_camera: The camera with the highest active_camera value will be used for rendering. Cameras are also filtered by the user_id. If there’s no user_id, the camera is considered global and potentially applies to all users (if its active_camera value is high enough).
• inv_local_to_world: Converts a world position to a local position. This is automatically updated.
• orthographic: If attached, this camera will use a standard orthographic projection matrix. Ensure that the orthographic_ components are set, including left, right, topandbottom, as well as nearandfar`.
• orthographic_left: The left bound for this orthographic camera.
• orthographic_right: The right bound for this orthographic camera.
• orthographic_top: The top bound for this orthographic camera.
• orthographic_bottom: The bottom bound for this orthographic camera.
• far: The far plane of this camera, measured in meters.

Optional:

• translation: The translation/position of this entity.
• rotation: The rotation of this entity.
• scale: The scale of this entity.
• main_scene: Either the main or UI scene must be specified for this camera to be used.
• ui_scene: Either the main or UI scene must be specified for this camera to be used.
• user_id: If set, this camera will only be used for the specified user.

Fields

local_to_world: Mat4

Component: ambient_core::transform::local_to_world

Suggested value: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ])

Component description: Transformation from the entity’s local space to worldspace.

near: f32

Component: ambient_core::camera::near

Suggested value: -1f32

Component description: The near plane of this camera, measured in meters.

projection: Mat4

Component: ambient_core::camera::projection

Suggested value: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ])

Component description: The projection matrix of this camera. This can be driven by other components, including perspective and perspective_infinite_reverse.

projection_view: Mat4

Component: ambient_core::camera::projection_view

Suggested value: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ])

Component description: The composition of the projection and view (inverse-local-to-world) matrices.

active_camera: f32

Component: ambient_core::camera::active_camera

Suggested value: 0f32

Component description: The camera with the highest active_camera value will be used for rendering. Cameras are also filtered by the user_id. If there’s no user_id, the camera is considered global and potentially applies to all users (if its active_camera value is high enough).

inv_local_to_world: Mat4

Component: ambient_core::transform::inv_local_to_world

Suggested value: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ])

Component description: Converts a world position to a local position. This is automatically updated.

orthographic: ()

Component: ambient_core::camera::orthographic

Suggested value: ()

Component description: If attached, this camera will use a standard orthographic projection matrix. Ensure that the orthographic_ components are set, including left, right, topandbottom, as well as nearandfar`.

orthographic_left: f32

Component: ambient_core::camera::orthographic_left

Suggested value: -1f32

Component description: The left bound for this orthographic camera.

orthographic_right: f32

Component: ambient_core::camera::orthographic_right

Suggested value: 1f32

Component description: The right bound for this orthographic camera.

orthographic_top: f32

Component: ambient_core::camera::orthographic_top

Suggested value: 1f32

Component description: The top bound for this orthographic camera.

orthographic_bottom: f32

Component: ambient_core::camera::orthographic_bottom

Suggested value: -1f32

Component description: The bottom bound for this orthographic camera.

far: f32

Component: ambient_core::camera::far

Suggested value: 1f32

Component description: The far plane of this camera, measured in meters.

optional: OrthographicCameraOptional

Optional components.

Trait Implementations

impl Clone for OrthographicCamera

fn clone(&self) -> OrthographicCamera

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Concept for OrthographicCamera

fn make(self) -> Entity

Creates an entity with the components defined by this concept.

fn get_spawned(id: EntityId) -> Option<OrthographicCamera>

If the entity with id exists and has the components defined by this concept, returns this concept with all of the values of the components in the entity.

fn get_unspawned(entity: &Entity) -> Option<OrthographicCamera>

If the entity has the components defined by this concept, returns this concept with all of the values of the components in the entity.

fn contained_by_spawned(id: EntityId) -> bool

Returns true if id exists and contains the components defined by this concept.

fn contained_by_unspawned(entity: &Entity) -> bool

Returns true if contains the components defined by this concept.

fn spawn(self) -> EntityId

where Self: Sized,

Spawns this concept into the world. If you want to modify state before spawning, use make instead.

impl ConceptComponents for OrthographicCamera

type Required = (Component<Mat4>, Component<f32>, Component<Mat4>, Component<Mat4>, Component<f32>, Component<Mat4>, Component<()>, Component<f32>, Component<f32>, Component<f32>, Component<f32>, Component<f32>)

A tuple of the required components for this concept.

type Optional = (Component<Vec3>, Component<Quat>, Component<Vec3>, Component<()>, Component<()>, Component<String>)

A tuple of the optional components for this concept.

fn required() -> <OrthographicCamera as ConceptComponents>::Required

Returns a tuple of the required components for this concept.

fn optional() -> <OrthographicCamera as ConceptComponents>::Optional

Returns a tuple of the optional components for this concept.

fn from_required_data( required: <<OrthographicCamera as ConceptComponents>::Required as ComponentsTuple>::Data ) -> OrthographicCamera

Converts a tuple of data back to a concept.

fn as_query() -> ConceptQuery<Self>

where Self: Sized,

Creates a ConceptQuery that can be passed into queries.

impl ConceptSuggested for OrthographicCamera

fn suggested() -> OrthographicCamera

local_to_world: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ]),
near: -1f32,
projection: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ]),
projection_view: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ]),
active_camera: 0f32,
inv_local_to_world: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ]),
orthographic: (),
orthographic_left: -1f32,
orthographic_right: 1f32,
orthographic_top: 1f32,
orthographic_bottom: -1f32,
far: 1f32,

impl Debug for OrthographicCamera

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OrthographicCamera

fn deserialize<__D>( __deserializer: __D ) -> Result<OrthographicCamera, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OrthographicCamera

fn eq(&self, other: &OrthographicCamera) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for OrthographicCamera

fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OrthographicCamera