Struct ambient_api_core::core::camera::concepts::Camera

pub struct Camera {
    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 optional: CameraOptional,
}

Camera: Base components for a camera. You will need other components to make a fully-functioning camera.

Extends: ambient_core::transform::Transformable

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.

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: 0.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.

optional: CameraOptional

Optional components.

Trait Implementations

impl Clone for Camera

fn clone(&self) -> Camera

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Concept for Camera

fn make(self) -> Entity

Creates an entity with the components defined by this concept.

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

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<Self>

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 Camera

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

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() -> Self::Required

Returns a tuple of the required components for this concept.

fn optional() -> Self::Optional

Returns a tuple of the optional components for this concept.

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

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 Camera

fn suggested() -> Self

local_to_world: Mat4::from_cols_array(&[1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, 0f32, 0f32, 0f32, 0f32, 1f32, ]),
near: 0.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, ]),

impl Debug for Camera

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Camera

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Camera

fn eq(&self, other: &Camera) -> 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 Camera

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Camera