Struct maplibre::render::camera::Camera

pub struct Camera {
    pub position: Point3<f64>,
    pub yaw: Rad<f64>,
    pub pitch: Rad<f64>,
    pub width: f64,
    pub height: f64,
}

Fields

position: Point3<f64>

yaw: Rad<f64>

pitch: Rad<f64>

width: f64

height: f64

Implementations

impl Camera

pub fn new<V: Into<Point3<f64>>, Y: Into<Rad<f64>>, P: Into<Rad<f64>>>(
    position: V,
    yaw: Y,
    pitch: P,
    width: u32,
    height: u32
) -> Self

pub fn resize(&mut self, width: u32, height: u32)

fn calc_matrix(&self) -> Matrix4<f64>

pub fn calc_view_proj(&self, perspective: &Perspective) -> ViewProjection

fn clip_to_window_transform(&self) -> Matrix4<f64>

A transform which can be used to transfrom between clip and window space. Adopted from here (Direct3D).

fn clip_to_window(&self, clip: &Vector4<f64>) -> Vector4<f64>

Transforms coordinates in clip space to window coordinates.

Adopted from here (Direct3D).

fn clip_to_window_vulkan(&self, clip: &Vector4<f64>) -> Vector3<f64>

Alternative implementation to clip_to_window. Transforms coordinates in clip space to window coordinates.

Adopted from here and here (Vulkan).

fn window_to_world(
    &self,
    window: &Vector3<f64>,
    inverted_view_proj: &InvertedViewProjection
) -> Vector3<f64>

Order of transformations reversed: https://computergraphics.stackexchange.com/questions/6087/screen-space-coordinates-to-eye-space-conversion/6093 w is lost.

OpenGL explanation: https://www.khronos.org/opengl/wiki/Compute_eye_space_from_window_space#From_window_to_ndc

fn window_to_world_nalgebra(
    window: &Vector3<f64>,
    inverted_view_proj: &InvertedViewProjection,
    width: f64,
    height: f64
) -> Vector3<f64>

Alternative implementation to window_to_world

Adopted from here.

pub fn window_to_world_at_ground(
    &self,
    window: &Vector2<f64>,
    inverted_view_proj: &InvertedViewProjection
) -> Option<Vector3<f64>>

Gets the world coordinates for the specified window coordinates on the z=0 plane.

pub fn view_region_bounding_box(
    &self,
    inverted_view_proj: &InvertedViewProjection
) -> Option<Aabb2<f64>>

Calculates an Aabb2 bounding box which contains at least the visible area on the z=0 plane. One can think of it as being the bounding box of the geometry which forms the intersection between the viewing frustum and the z=0 plane.

This implementation works in the world 3D space. It casts rays from the corners of the window to calculate intersections points with the z=0 plane. Then a bounding box is calculated.

Note: It is possible that no such bounding box exists. This is the case if the z=0 plane is not in view.

pub fn view_region_bounding_box_ndc(
    &self,
    perspective: &Perspective
) -> Option<Aabb2<f64>>

An alternative implementation for view_bounding_box.

This implementation works in the NDC space. We are creating a plane in the world 3D space. Then we are transforming it to the NDC space. In NDC space it is easy to calculate the intersection points between an Aabb3 and a plane. The resulting Aabb2 is returned.

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 Debug for Camera

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

Formats the value using the given formatter.

impl SignificantlyDifferent<Camera> for Camera

type Epsilon = f64

fn ne(&self, other: &Self, epsilon: Self::Epsilon) -> bool

This method tests for self and other values to be significantly different