Mat4F

Description

struct Tinman.Core.Math.Vectors.Mat4F

Derived from: IMatOps<Mat4F, Vec4F, float32>
IMat4Ops<Vec4F, Vec3F, float32>
IConfigurableTrait

A 4x4 matrix with 64-bit floating-point precision.

/                      \
|  M11  M12  M13  M14  |
|  M21  M22  M23  M24  |
|  M31  M32  M33  M34  |
|  M41  M42  M43  M44  |
\                      /

See also: Mat.Config4

Public / Constants

Identity

public static readonly attribute Identity → (Mat4F)

The identity matrix.

Zero

public static readonly attribute Zero → (Mat4F)

The zero matrix.

Public / Constructors

FromColumns

[Pure]
public static method FromColumns → (4)

col1 ⁱⁿ : Vec4F: The first column vector.
col2 ⁱⁿ : Vec4F: The second column vector.
col3 ⁱⁿ : Vec4F: The third column vector.
col4 ⁱⁿ : Vec4F: The fourth column vector.
returns → Mat4F: The matrix.

Creates a new instance of Mat4F.

FromRows

[Pure]
public static method FromRows → (4)

row1 ⁱⁿ : Vec4F: The first row vector.
row2 ⁱⁿ : Vec4F: The second row vector.
row3 ⁱⁿ : Vec4F: The third row vector.
row4 ⁱⁿ : Vec4F: The fourth row vector.
returns → Mat4F: The matrix.

Creates a new instance of Mat4F.

LookAt

[Pure]
public static method LookAt → (4)

origin ⁱⁿ : Vec3F: The origin position.
target ⁱⁿ : Vec3F: The look-at position.
up ⁱⁿ : Vec3F: The up-direction vector.
rightHanded ⁱⁿ : bool: true to create a right-handed coordinate system,
false to create a left-handed one.
returns → Mat4F: The transformation matrix.

Creates a look-at transformation matrix.

Mat4F

public constructor Mat4F → (16)

m11 ⁱⁿ : float32: Matrix component in first row, first column.
m12 ⁱⁿ : float32: Matrix component in first row, second column.
m13 ⁱⁿ : float32: Matrix component in first row, third column.
m14 ⁱⁿ : float32: Matrix component in first row, fourth column.
m21 ⁱⁿ : float32: Matrix component in second row, first column.
m22 ⁱⁿ : float32: Matrix component in second row, second column.
m23 ⁱⁿ : float32: Matrix component in second row, third column.
m24 ⁱⁿ : float32: Matrix component in second row, fourth column.
m31 ⁱⁿ : float32: Matrix component in third row, first column.
m32 ⁱⁿ : float32: Matrix component in third row, second column.
m33 ⁱⁿ : float32: Matrix component in third row, third column.
m34 ⁱⁿ : float32: Matrix component in third row, fourth column.
m41 ^opt : float32 = 0: Matrix component in fourth row, first column.
m42 ^opt : float32 = 0: Matrix component in fourth row, second column.
m43 ^opt : float32 = 0: Matrix component in fourth row, third column.
m44 ^opt : float32 = 1: Matrix component in fourth row, fourth column.

Creates a new instance of Mat4F.

Orthographic

[Pure]
public static method Orthographic → (7)

left ⁱⁿ : float32: The X-coordinate to map to -1.
right ⁱⁿ : float32: The X-coordinate to map to +1.
top ⁱⁿ : float32: The Y-coordinate to map to -1.
bottom ⁱⁿ : float32: The Y-coordinate to map to +1.
zNear ⁱⁿ : float32: The Z-coordinate to map to 0 resp. -1.
zFar ⁱⁿ : float32: The Z-coordinate to map to +1.
nearAtZero ⁱⁿ : bool: true to map zNear ⁱⁿ to 0,
false to map zNear ⁱⁿ to -1.
returns → Mat4F: The projection matrix.

Creates an orthographic projection matrix.

PerspectiveFov

[Pure]
public static method PerspectiveFov → (6)

fov ⁱⁿ : float32: The field-of-view along the viewport Y-axis, in radians.
aspect ⁱⁿ : float32: The viewport aspect ratio (width divided by height).
n ⁱⁿ : float32: Near clipping plane Z-value (will be mapped to 0 resp. -1 in clip-space; see nearAtZero ⁱⁿ for details).
f ⁱⁿ : float32: Far clipping plane Z-value (will be mapped to 1 in clip-space).
nearAtZero ⁱⁿ : bool: When true, the near clipping plane will be mapped to 0 in clip-space (e.g. Direct3D); when false it will be mapped to -1 (e.g. OpenGL).
rightHanded ⁱⁿ : bool: Create projection matrix for a right-handed (true) or left-handed (false) coordinate system?
returns → Mat4F: The projection matrix.

Creates a perspective projection matrix.

Rotate

_2 overloads

[Pure]
public static method Rotate¹ → (2)

axis ⁱⁿ : Vec3F: Unit-length rotation axis vector.
angle ⁱⁿ : float32: The rotation angle, in radians.
returns → Mat4F: The resulting matrix.

Returns a rotation matrix (counter-clockwise around the given axis for right-handed coordinate system when viewing from positive half-space).

[Pure]
public static method Rotate² → (4)

x ⁱⁿ : float32: X-component of unit-length rotation axis vector.
y ⁱⁿ : float32: Y-component of unit-length rotation axis vector.
z ⁱⁿ : float32: Z-component of unit-length rotation axis vector.
angle ⁱⁿ : float32: The rotation angle, in radians.
returns → Mat4F: The resulting matrix.

Returns a rotation matrix (counter-clockwise around the given axis for right-handed coordinate system when viewing from positive half-space).

RotateX

[Pure]
public static method RotateX → (1)

angle ⁱⁿ : float32: The rotation angle, in radians.
returns → Mat4F: The resulting matrix.

Returns a rotation matrix (counter-clockwise around X-axis for right-handed coordinate system when viewing from positive half-space).

RotateY

[Pure]
public static method RotateY → (1)

angle ⁱⁿ : float32: The rotation angle, in radians.
returns → Mat4F: The resulting matrix.

Returns a rotation matrix (counter-clockwise around Y-axis for right-handed coordinate system when viewing from positive half-space).

RotateZ

[Pure]
public static method RotateZ → (1)

angle ⁱⁿ : float32: The rotation angle, in radians.
returns → Mat4F: The resulting matrix.

Returns a rotation matrix (counter-clockwise around Z-axis for right-handed coordinate system when viewing from positive half-space).

Scale

_3 overloads

[Pure]
public static method Scale¹ → (1)

f ⁱⁿ : float32: The scale factor.
returns → Mat4F: The resulting matrix.

Returns a 3D scaling matrix.

[Pure]
public static method Scale² → (1)

f ⁱⁿ : Vec4F: The scale factors.
returns → Mat4F: The resulting matrix.

Returns a 4D scaling matrix.

[Pure]
public static method Scale³ → (4)

fx ⁱⁿ : float32: The scale factor along the X-axis.
fy ⁱⁿ : float32: The scale factor along the Y-axis.
fz ⁱⁿ : float32: The scale factor along the Z-axis.
fw ⁱⁿ : float32: The scale factor along the W-axis.
returns → Mat4F: The resulting matrix.

Returns a 4D scaling matrix.

Translate

_2 overloads

[Pure]
public static method Translate¹ → (1)

v ⁱⁿ : Vec3F: The translation vector.
returns → Mat4F: The translation matrix.

Returns a translation matrix.

[Pure]
public static method Translate² → (3)

x ⁱⁿ : float32: X-component of translation vector.
y ⁱⁿ : float32: Y-component of translation vector.
z ⁱⁿ : float32: Z-component of translation vector.
returns → Mat4F: The translation matrix.

Returns a translation matrix.

Warp

[Pure]
public static method Warp → (6)

a0 ⁱⁿ : Vec3F: First vertex of source triangle.
b0 ⁱⁿ : Vec3F: Second vertex of source triangle.
c0 ⁱⁿ : Vec3F: Third vertex of source triangle.
a1 ⁱⁿ : Vec3F: First vertex of target triangle.
b1 ⁱⁿ : Vec3F: Second vertex of target triangle.
c1 ⁱⁿ : Vec3F: Third vertex of target triangle.
returns → Mat4F: The homogeneous 3D warp matrix.

Computes an invertible 3D homogeneous warp matrix that transforms the given source triangle onto the specified target triangle.

The fourth row of the returned matrix will always be (0,0,0,1), so it is not necessary to perform the homogeneous divide. Also all elements along the main diagonal will be 1.

Public / Attributes

M11

public readonly attribute M11 → (float32)

Matrix component in first row, first column.

M12

public readonly attribute M12 → (float32)

Matrix component in first row, second column.

M13

public readonly attribute M13 → (float32)

Matrix component in first row, third column.

M14

public readonly attribute M14 → (float32)

Matrix component in first row, fourth column.

M21

public readonly attribute M21 → (float32)

Matrix component in second row, first column.

M22

public readonly attribute M22 → (float32)

Matrix component in second row, second column.

M23

public readonly attribute M23 → (float32)

Matrix component in second row, third column.

M24

public readonly attribute M24 → (float32)

Matrix component in second row, fourth column.

M31

public readonly attribute M31 → (float32)

Matrix component in third row, first column.

M32

public readonly attribute M32 → (float32)

Matrix component in third row, second column.

M33

public readonly attribute M33 → (float32)

Matrix component in third row, third column.

M34

public readonly attribute M34 → (float32)

Matrix component in third row, fourth column.

M41

public readonly attribute M41 → (float32)

Matrix component in fourth row, first column.

M42

public readonly attribute M42 → (float32)

Matrix component in fourth row, second column.

M43

public readonly attribute M43 → (float32)

Matrix component in fourth row, third column.

M44

public readonly attribute M44 → (float32)

Matrix component in fourth row, fourth column.

Configuration

Config

public static attribute Config → (get)

value : IConfigurator<Mat4D>: [not-null]
The configurator object.

The configurator object for this type.

See also: Mat.To4D⁸

Serialization

Serializer

public static readonly attribute Serializer → (ITypeSerializer<Mat4F>)

The serialization helper object for values of Mat4F.

Mat4F

Description

Public / Constants

Identity

Zero

Public / Constructors

From​Columns

From​Rows

Look​At

Mat4​F

Orthographic

Perspective​Fov

Rotate

Rotate​X

Rotate​Y

Rotate​Z

Scale

Translate

Warp

Public / Attributes

M11

M12

M13

M14

M21

M22

M23

M24

M31

M32

M33

M34

M41

M42

M43

M44

Configuration

Config

Serialization

Serializer

FromColumns

FromRows

LookAt

Mat4F

PerspectiveFov

RotateX

RotateY

RotateZ