docs/html/matrix4_8h_source.html

 /*

-  This file is part of the MinGfx Project.

-

-  Copyright (c) 2017,2018 Regents of the University of Minnesota.

-  All Rights Reserved.

-

-  Original Author(s) of this File:

-     Dan Keefe, 2017, University of Minnesota

-

-  Author(s) of Significant Updates/Modifications to the File:

-     ...

-  */

-

- #ifndef SRC_MATRIX4_H_

- #define SRC_MATRIX4_H_

-

- #include <iostream>

-

- #include "point3.h"

- #include "vector3.h"

- #include "ray.h"

-

-

- namespace mingfx {

-

-

- class Matrix4 {

- public:

-

-     Matrix4();

-

-     Matrix4(const float* a);

-

-     Matrix4(const std::vector<float> &a);

-

-     Matrix4(const Matrix4& m2);

-

-     virtual ~Matrix4();

-

-     bool operator==(const Matrix4& m2) const;

-

-     bool operator!=(const Matrix4& m2) const;

-

-     Matrix4& operator=(const Matrix4& m2);

-

-

-     const float * value_ptr() const;

-

-     float operator[](const int i) const;

-

-     float& operator[](const int i);

-

-     float operator()(const int row, const int col) const;

-

-     float& operator()(const int row, const int col);

-

-

-     Vector3 ColumnToVector3(int c) const;

-

-     Point3 ColumnToPoint3(int c) const;

-

-     std::vector<float> ToVector() const;

-

-

-     // --- Static Constructors for Special Matrices ---

-

-     static Matrix4 FromRowMajorElements(

-         const float r1c1, const float r1c2, const float r1c3, const float r1c4,

-         const float r2c1, const float r2c2, const float r2c3, const float r2c4,

-         const float r3c1, const float r3c2, const float r3c3, const float r3c4,

-         const float r4c1, const float r4c2, const float r4c3, const float r4c4

-     );

-

-     // --- Model Transformations ---

-

-     static Matrix4 Scale(const Vector3 &v);

-

-     static Matrix4 Translation(const Vector3 &v);

-

-     static Matrix4 RotationX(const float radians);

-

-     static Matrix4 RotationY(const float radians);

-

-     static Matrix4 RotationZ(const float radians);

-

-     static Matrix4 Rotation(const Point3 &p, const Vector3 &v, const float a);

-

-     static Matrix4 Align(const Point3 &a_p, const Vector3 &a_v1, const Vector3 &a_v2,

-                          const Point3 &b_p, const Vector3 &b_v1, const Vector3 &b_v2);

-

-

-     // --- View Matrices ---

-

-     static Matrix4 LookAt(Point3 eye, Point3 target, Vector3 up);

-

-     // --- Projection Matrices ---

-

-     static Matrix4 Perspective(float fov_y_in_degrees, float aspect_ratio, float near_plane_dist, float far_plane_dist);

-

-     static Matrix4 Frustum(float left, float right, float bottom, float top, float near_plane_dist, float far_plane_dist);

-

-     // --- Inverse, Transposeand Other General Matrix Functions ---

-

-     Matrix4 Inverse() const;

-

-     Matrix4 Orthonormal() const;

-

-     Matrix4 Transpose() const;

-

-     float SubDeterminant(int exclude_row, int exclude_col) const;

-

-     Matrix4 Cofactor() const;

-

-     float Determinant() const;

-

-

-

- private:

-     float m[16];

- };

-

-

-

- // ---------- Operator Overloads for Working with Points, Vectors, & Matrices ----------

-

-

- // --- Matrix multiplication for Points, Vectors, & Matrices ---

-

- Matrix4 operator*(const Matrix4& m, const float& s);

-

- Matrix4 operator*(const float& s, const Matrix4& m);

-

- Point3 operator*(const Matrix4& m, const Point3& p);

-

- Vector3 operator*(const Matrix4& m, const Vector3& v);

-

- Matrix4 operator*(const Matrix4& m1, const Matrix4& m2);

-

-

-

- Ray operator*(const Matrix4& m, const Ray& r);

-

- // --- Stream operators ---

-

- std::ostream & operator<< ( std::ostream &os, const Matrix4 &m);

- std::istream & operator>> ( std::istream &is, Matrix4 &m);

-

-

- } // end namespace

-

- #endif

-mingfx::Matrix4
A 4x4 transformation matrix stored internally as an array of floats in column-major order so as to be...
Definition: matrix4.h:50

-mingfx::Matrix4::Determinant
float Determinant() const
Returns the determinant of the 4x4 matrix.

-mingfx::Matrix4::Scale
static Matrix4 Scale(const Vector3 &v)
Returns the scale matrix described by the vector.

-mingfx::Matrix4::Matrix4
Matrix4(const float *a)
Constructs a matrix given from an array of 16 floats in OpenGL matrix format (i.e....

-mingfx::Matrix4::Matrix4
Matrix4(const std::vector< float > &a)
Constructs a matrix given from a vector of 16 floats in OpenGL matrix format (i.e....

-mingfx::Matrix4::Cofactor
Matrix4 Cofactor() const
Returns the cofactor matrix.

-mingfx::Matrix4::Perspective
static Matrix4 Perspective(float fov_y_in_degrees, float aspect_ratio, float near_plane_dist, float far_plane_dist)
Returns a perspective projection matrix equivalent to the one gluPerspective creates.

-mingfx::Matrix4::value_ptr
const float * value_ptr() const
Returns a pointer to the raw data array used to store the matrix. This is a 1D array of 16-elements s...

-mingfx::Matrix4::SubDeterminant
float SubDeterminant(int exclude_row, int exclude_col) const
Returns the determinant of the 3x3 matrix formed by excluding the specified row and column from the 4...

-mingfx::Matrix4::LookAt
static Matrix4 LookAt(Point3 eye, Point3 target, Vector3 up)
Returns a view matrix that centers the camera at the 'eye' position and orients it to look at the des...

-mingfx::Matrix4::operator()
float & operator()(const int row, const int col)
Access an individual element of the array using the syntax: Matrix4 mat; mat(1,2) = 1....

-mingfx::Matrix4::RotationX
static Matrix4 RotationX(const float radians)
Returns the rotation matrix about the x axis by the specified angle.

-mingfx::Matrix4::Matrix4
Matrix4(const Matrix4 &m2)
Copy constructor.

-mingfx::Matrix4::RotationZ
static Matrix4 RotationZ(const float radians)
Returns the rotation matrix about the z axis by the specified angle.

-mingfx::Matrix4::ToVector
std::vector< float > ToVector() const

-mingfx::Matrix4::Matrix4
Matrix4()
The default constructor creates an identity matrix:

-mingfx::Matrix4::ColumnToVector3
Vector3 ColumnToVector3(int c) const
Returns the c-th column of the matrix as a Vector type, e.g.,: Vector3 xAxis = mat....

-mingfx::Matrix4::~Matrix4
virtual ~Matrix4()
Destructor.

-mingfx::Matrix4::Frustum
static Matrix4 Frustum(float left, float right, float bottom, float top, float near_plane_dist, float far_plane_dist)
Returns a projection matrix equivalent the one glFrustum creates.

-mingfx::Matrix4::Orthonormal
Matrix4 Orthonormal() const
Returns an orthonormal version of the matrix, i.e., guarantees that the rotational component of the m...

-mingfx::Matrix4::operator=
Matrix4 & operator=(const Matrix4 &m2)
Matrix assignment operator.

-mingfx::Matrix4::operator==
bool operator==(const Matrix4 &m2) const
Check for "equality", taking floating point imprecision into account.

-mingfx::Matrix4::operator()
float operator()(const int row, const int col) const
Access an individual element of the array using the syntax: Matrix4 mat; float row1col2 = mat(1,...

-mingfx::Matrix4::operator!=
bool operator!=(const Matrix4 &m2) const
Check for "inequality", taking floating point imprecision into account.

-mingfx::Matrix4::Inverse
Matrix4 Inverse() const
Returns the inverse of the 4x4 matrix if it is nonsingular. If it is singular, then returns the ident...

-mingfx::Matrix4::operator[]
float operator[](const int i) const
Accesses the ith element of the raw data array used to store the matrix. This is a 1D array of 16-ele...

-mingfx::Matrix4::Rotation
static Matrix4 Rotation(const Point3 &p, const Vector3 &v, const float a)
Returns the rotation matrix around the vector v placed at point p, rotate by angle a.

-mingfx::Matrix4::FromRowMajorElements
static Matrix4 FromRowMajorElements(const float r1c1, const float r1c2, const float r1c3, const float r1c4, const float r2c1, const float r2c2, const float r2c3, const float r2c4, const float r3c1, const float r3c2, const float r3c3, const float r3c4, const float r4c1, const float r4c2, const float r4c3, const float r4c4)
Returns a matrix constructed from individual elements passed in row major order so that the matrix lo...

-mingfx::Matrix4::Align
static Matrix4 Align(const Point3 &a_p, const Vector3 &a_v1, const Vector3 &a_v2, const Point3 &b_p, const Vector3 &b_v1, const Vector3 &b_v2)
Creates a transformation matrix that maps a coordinate space, a, defined one point,...

-mingfx::Matrix4::Translation
static Matrix4 Translation(const Vector3 &v)
Returns the translation matrix described by the vector.

-mingfx::Matrix4::ColumnToPoint3
Point3 ColumnToPoint3(int c) const
Returns the c-th column of the matrix as a Vector type, e.g.,: Point3 pos = mat.getColumnAsPoint3(3);...

-mingfx::Matrix4::RotationY
static Matrix4 RotationY(const float radians)
Returns the rotation matrix about the y axis by the specified angle.

-mingfx::Matrix4::operator[]
float & operator[](const int i)
Accesses the ith element of the raw data array used to store the matrix. This is a 1D array of 16-ele...

-mingfx::Matrix4::Transpose
Matrix4 Transpose() const
Returns the transpose of the matrix.

-mingfx::Point3
A 3D Point with floating point coordinates, used for storing vertices and all sorts of other 3D graph...
Definition: point3.h:52

-mingfx::Ray
Stores the mathematical object of a ray that begins at an origin (a 3D point) and points in a directi...
Definition: ray.h:54

-mingfx::Vector3
A 3D Vector with floating point coordinates, used for storing normals and all sorts of other 3D graph...
Definition: vector3.h:62

-mingfx
Namespace for the MinGfx Toolkit.
Definition: aabb.h:21

-mingfx::operator<<
std::ostream & operator<<(std::ostream &os, const Color &c)

-mingfx::operator>>
std::istream & operator>>(std::istream &is, Color &c)

-mingfx::operator*
Matrix4 operator*(const Matrix4 &m, const float &s)
Multiply matrix and scalar, returns the new matrix.

-point3.h

-ray.h

-vector3.h

-