pub struct Matrix {}
Fields
xx: f32
yx: f32
zx: f32
wx: f32
xy: f32
yy: f32
zy: f32
wy: f32
xz: f32
yz: f32
zz: f32
wz: f32
xw: f32
yw: f32
zw: f32
ww: f32
Implementations
sourceimpl Matrix
impl Matrix
sourcepub fn frustum(
&mut self,
left: f32,
right: f32,
bottom: f32,
top: f32,
z_near: f32,
z_far: f32
)
pub fn frustum(
&mut self,
left: f32,
right: f32,
bottom: f32,
top: f32,
z_near: f32,
z_far: f32
)
Multiplies self
by the given frustum perspective matrix.
left
X position of the left clipping plane where it intersects the near clipping plane
right
X position of the right clipping plane where it intersects the near clipping plane
bottom
Y position of the bottom clipping plane where it intersects the near clipping plane
top
Y position of the top clipping plane where it intersects the near clipping plane
z_near
The distance to the near clipping plane (Must be positive)
z_far
The distance to the far clipping plane (Must be positive)
sourcepub fn inverse(&self) -> (bool, Matrix)
pub fn inverse(&self) -> (bool, Matrix)
Gets the inverse transform of a given matrix and uses it to initialize
a new Matrix
.
Although the first parameter is annotated as const to indicate
that the transform it represents isn’t modified this fn may
technically save a copy of the inverse transform within the given
Matrix
so that subsequent requests for the inverse transform may
avoid costly inversion calculations.
inverse
The destination for a 4x4 inverse transformation matrix
Returns
true
if the inverse was successfully calculated or false
for degenerate transformations that can’t be inverted (in this case the
inverse
matrix will simply be initialized with the identity matrix)
sourcepub fn init_from_array(&mut self, array: &[f32])
pub fn init_from_array(&mut self, array: &[f32])
sourcepub fn init_from_euler(&mut self, euler: &Euler)
pub fn init_from_euler(&mut self, euler: &Euler)
sourcepub fn init_from_quaternion(&mut self, quaternion: &Quaternion)
pub fn init_from_quaternion(&mut self, quaternion: &Quaternion)
sourcepub fn init_identity(&mut self)
pub fn init_identity(&mut self)
Resets matrix to the identity matrix:
.xx=1; .xy=0; .xz=0; .xw=0;
.yx=0; .yy=1; .yz=0; .yw=0;
.zx=0; .zy=0; .zz=1; .zw=0;
.wx=0; .wy=0; .wz=0; .ww=1;
sourcepub fn init_translation(&mut self, tx: f32, ty: f32, tz: f32)
pub fn init_translation(&mut self, tx: f32, ty: f32, tz: f32)
sourcepub fn is_identity(&self) -> bool
pub fn is_identity(&self) -> bool
Determines if the given matrix is an identity matrix.
Returns
true
if self
is an identity matrix else false
sourcepub fn look_at(
&mut self,
eye_position_x: f32,
eye_position_y: f32,
eye_position_z: f32,
object_x: f32,
object_y: f32,
object_z: f32,
world_up_x: f32,
world_up_y: f32,
world_up_z: f32
)
pub fn look_at(
&mut self,
eye_position_x: f32,
eye_position_y: f32,
eye_position_z: f32,
object_x: f32,
object_y: f32,
object_z: f32,
world_up_x: f32,
world_up_y: f32,
world_up_z: f32
)
Applies a view transform self
that positions the camera at
the coordinate (eye_position_x
, eye_position_y
, eye_position_z
)
looking towards an object at the coordinate (object_x
, object_y
,
object_z
). The top of the camera is aligned to the given world up
vector, which is normally simply (0, 1, 0) to map up to the
positive direction of the y axis.
Because there is a lot of missleading documentation online for gluLookAt regarding the up vector we want to try and be a bit clearer here.
The up vector should simply be relative to your world coordinates and does not need to change as you move the eye and object positions. Many online sources may claim that the up vector needs to be perpendicular to the vector between the eye and object position (partly because the man page is somewhat missleading) but that is not necessary for this function.
You should never look directly along the world-up vector.
It is assumed you are using a typical projection matrix where your origin maps to the center of your viewport.
Almost always when you use this fn it should be the first transform applied to a new modelview transform
eye_position_x
The X coordinate to look from
eye_position_y
The Y coordinate to look from
eye_position_z
The Z coordinate to look from
object_x
The X coordinate of the object to look at
object_y
The Y coordinate of the object to look at
object_z
The Z coordinate of the object to look at
world_up_x
The X component of the world’s up direction vector
world_up_y
The Y component of the world’s up direction vector
world_up_z
The Z component of the world’s up direction vector
sourcepub fn orthographic(
&mut self,
x_1: f32,
y_1: f32,
x_2: f32,
y_2: f32,
near: f32,
far: f32
)
pub fn orthographic(
&mut self,
x_1: f32,
y_1: f32,
x_2: f32,
y_2: f32,
near: f32,
far: f32
)
Multiplies self
by a parallel projection matrix.
x_1
The x coordinate for the first vertical clipping plane
y_1
The y coordinate for the first horizontal clipping plane
x_2
The x coordinate for the second vertical clipping plane
y_2
The y coordinate for the second horizontal clipping plane
near
The distance to the near clipping plane (will be negative if the plane is behind the viewer)
far
The distance to the far clipping plane (will be negative if the plane is behind the viewer)
sourcepub fn perspective(&mut self, fov_y: f32, aspect: f32, z_near: f32, z_far: f32)
pub fn perspective(&mut self, fov_y: f32, aspect: f32, z_near: f32, z_far: f32)
Multiplies self
by the described perspective matrix
You should be careful not to have to great a z_far
/ z_near
ratio since that will reduce the effectiveness of depth testing
since there wont be enough precision to identify the depth of
objects near to each other.
fov_y
Vertical field of view angle in degrees.
aspect
The (width over height) aspect ratio for display
z_near
The distance to the near clipping plane (Must be positive, and must not be 0)
z_far
The distance to the far clipping plane (Must be positive)
pub fn project_points(
&self,
n_components: i32,
stride_in: usize,
points_in: &[u8],
stride_out: usize,
points_out: &[u8],
n_points: i32
)
sourcepub fn rotate_euler(&mut self, euler: &Euler)
pub fn rotate_euler(&mut self, euler: &Euler)
Multiplies self
with a rotation transformation described by the
given Euler
.
euler
A euler describing a rotation
sourcepub fn rotate_quaternion(&mut self, quaternion: &Quaternion)
pub fn rotate_quaternion(&mut self, quaternion: &Quaternion)
Multiplies self
with a rotation transformation described by the
given Quaternion
.
quaternion
A quaternion describing a rotation
pub fn transform_points(
&self,
n_components: i32,
stride_in: usize,
points_in: &[u8],
stride_out: usize,
points_out: &[u8],
n_points: i32
)
sourcepub fn transpose(&mut self)
pub fn transpose(&mut self)
Replaces self
with its transpose. Ie, every element (i,j) in the
new matrix is taken from element (j,i) in the old matrix.
sourcepub fn view_2d_in_frustum(
&mut self,
left: f32,
right: f32,
bottom: f32,
top: f32,
z_near: f32,
z_2d: f32,
width_2d: f32,
height_2d: f32
)
pub fn view_2d_in_frustum(
&mut self,
left: f32,
right: f32,
bottom: f32,
top: f32,
z_near: f32,
z_2d: f32,
width_2d: f32,
height_2d: f32
)
Multiplies self
by a view transform that maps the 2D coordinates
(0,0) top left and (width_2d
,height_2d
) bottom right the full viewport
size. Geometry at a depth of 0 will now lie on this 2D plane.
Note: this doesn’t multiply the matrix by any projection matrix,
but it assumes you have a perspective projection as defined by
passing the corresponding arguments to Matrix::frustum
.
Toolkits such as Clutter that mix 2D and 3D drawing can use this to create a 2D coordinate system within a 3D perspective projected view frustum.
left
coord of left vertical clipping plane
right
coord of right vertical clipping plane
bottom
coord of bottom horizontal clipping plane
top
coord of top horizontal clipping plane
z_near
The distance to the near clip plane. Never pass 0 and always pass a positive number.
z_2d
The distance to the 2D plane. (Should always be positive and
be between z_near
and the z_far value that was passed to
Matrix::frustum
)
width_2d
The width of the 2D coordinate system
height_2d
The height of the 2D coordinate system
sourcepub fn view_2d_in_perspective(
&mut self,
fov_y: f32,
aspect: f32,
z_near: f32,
z_2d: f32,
width_2d: f32,
height_2d: f32
)
pub fn view_2d_in_perspective(
&mut self,
fov_y: f32,
aspect: f32,
z_near: f32,
z_2d: f32,
width_2d: f32,
height_2d: f32
)
Multiplies self
by a view transform that maps the 2D coordinates
(0,0) top left and (width_2d
,height_2d
) bottom right the full viewport
size. Geometry at a depth of 0 will now lie on this 2D plane.
Note: this doesn’t multiply the matrix by any projection matrix,
but it assumes you have a perspective projection as defined by
passing the corresponding arguments to Matrix::perspective
.
Toolkits such as Clutter that mix 2D and 3D drawing can use this to create a 2D coordinate system within a 3D perspective projected view frustum.
fov_y
A field of view angle for the Y axis
aspect
The ratio of width to height determining the field of view angle for the x axis.
z_near
The distance to the near clip plane. Never pass 0 and always pass a positive number.
z_2d
The distance to the 2D plane. (Should always be positive and
be between z_near
and the z_far value that was passed to
Matrix::frustum
)
width_2d
The width of the 2D coordinate system
height_2d
The height of the 2D coordinate system
Trait Implementations
sourceimpl PartialOrd<Matrix> for Matrix
impl PartialOrd<Matrix> for Matrix
sourcefn partial_cmp(&self, other: &Matrix) -> Option<Ordering>
fn partial_cmp(&self, other: &Matrix) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl Eq for Matrix
Auto Trait Implementations
impl RefUnwindSafe for Matrix
impl Send for Matrix
impl Sync for Matrix
impl Unpin for Matrix
impl UnwindSafe for Matrix
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T> Clamp<T> for T where
T: PartialOrd<T>,
impl<T> Clamp<T> for T where
T: PartialOrd<T>,
fn clamped(self, min: T, max: T) -> T
impl<'a, T, C, M> Inspect<'a, C, &'a C, M> for T
impl<'a, T, C, M> Inspect<'a, C, &'a C, M> for T
impl<'a, T, C, M> Inspect<'a, C, &'a mut C, M> for T
impl<'a, T, C, M> Inspect<'a, C, &'a mut C, M> for T
impl<Fr, To> IntoColor<To> for Fr where
To: FromColor<Fr>,
impl<Fr, To> IntoColor<To> for Fr where
To: FromColor<Fr>,
fn into_color(self) -> To
fn into_color(self) -> To
Convert into color
impl<T> Pointable for T
impl<T> Pointable for T
impl<T> SetParameter for T
impl<T> SetParameter for T
fn set<T>(&mut self, value: T) -> <T as Parameter<Self>>::Result where
T: Parameter<Self>,
fn set<T>(&mut self, value: T) -> <T as Parameter<Self>>::Result where
T: Parameter<Self>,
Sets value
as a parameter of self
.