Matrix4 class Reference

Public Methods

Matrix4 (void)

identity constructor. More...

Matrix4 (float f)

const elements constructor. More...

Matrix4 (const float *m)

construct from float array. More...

Matrix4 (const Matrix4 &m)

copy constructor. More...

~Matrix4 (void)

destructor. More...

void multpoint3d (const float[3], float[3]) const

multiplies a 3D point (first arg) by the Matrix, returns in second arg. More...

void multpointarray_3d (int numpts, const float *, float *) const

multiplies a 3D point array (2nd arg) by the Matrix, returns in 3rd arg. More...

void multnorm3d (const float[3], float[3]) const

multiplies a 3D norm (first arg) by the Matrix, returns in second arg. More...

void multplaneeq3d (const float[3], float[3]) const

multiplies a 3D texture plane equation by the Matrix. More...

void multpoint4d (const float[4], float[4]) const

multiplies a 4D point (first arg) by the Matrix, returns in second arg. More...

void identity (void)

clears the matrix (resets it to identity). More...

void constant (float)

sets the matrix so all items are the given constant value. More...

int inverse (void)

inverts the matrix, that is, the inverse of the rotation, the inverse of the scaling, and the opposite of the translation vector. returns 0 if there were no problems, -1 if the matrix is singular. More...

void transpose (void)

transposes the matrix. More...

void loadmatrix (const Matrix4 &m)

replaces this matrix with the given one. More...

Matrix4 & operator= (const Matrix4 &m)

void multmatrix (const Matrix4 &)

premultiply the matrix by the given matrix, this->other * this. More...

void rot (float, char)

performs a left-handed rotation around an axis (char == 'x', 'y', or 'z'). More...

void rotate_axis (const float axis[3], float angle)

apply a rotation around the given vector; angle in radians. More...

void transvec (float x, float y, float z)

apply a rotation such that 'x' is brought along the given vector. More...

void transvecinv (float x, float y, float z)

apply a rotation such that the given vector is brought along 'x'. More...

void translate (float, float, float)

performs a translation. More...

void translate (float d[3])

void scale (float, float, float)

performs scaling. More...

void scale (float f)

void window (float, float, float, float, float, float)

sets this matrix to represent a window perspective. More...

void ortho (float, float, float, float, float, float)

sets this matrix to a 3D orthographic matrix. More...

void ortho2 (float, float, float, float)

sets this matrix to a 2D orthographic matrix. More...

void lookat (float, float, float, float, float, float, short)

This subroutine defines a viewing transformation with the eye at point (vx,vy,vz) looking at the point (px,py,pz). Twist is the right-hand rotation about this line. The resultant matrix is multiplied with the top of the transformation stack and then replaces it. Precisely, lookat does: lookat=trans(-vx,-vy,-vz)*rotate(theta,y)*rotate(phi,x)*rotate(-twist,z). More...

Public Attributes

float mat [16]

the matrix itself. More...

Matrix4::Matrix4 ( void ) [inline]

identity constructor.

Definition at line 28 of file Matrix4.h.

References identity.

Matrix4::Matrix4 ( float f ) [inline]

const elements constructor.

Definition at line 29 of file Matrix4.h.

References constant.

Matrix4::Matrix4 ( const float * m )

construct from float array.

Definition at line 30 of file Matrix4.C.

References mat.

Matrix4::Matrix4 ( const Matrix4 & m ) [inline]

copy constructor.

Definition at line 31 of file Matrix4.h.

References loadmatrix.

Matrix4::~Matrix4 ( void ) [inline]

destructor.

Definition at line 32 of file Matrix4.h.

void Matrix4::constant ( float )

sets the matrix so all items are the given constant value.

Definition at line 128 of file Matrix4.C.

References mat.

Referenced by lookat, Matrix4, ortho, ortho2, and window.

void Matrix4::identity ( void )

clears the matrix (resets it to identity).

Definition at line 118 of file Matrix4.C.

References mat.

Referenced by SpaceballTracker::do_start, MobileTracker::do_start, dodecahedron, Timestep::get_transform_from_cell, Matrix4, measure_pbc_neighbors, Displayable::recalc_mat, VRJugglerDisplayDevice::render, FreeVRDisplayDevice::render, CaveDisplayDevice::render, Displayable::reset_transformation, SensorConfig::SensorConfig, OpenGLRenderer::set_persp, Displayable::set_rot, OpenGLRenderer::setup_initial_opengl_state, POV3DisplayDevice::trimesh_c4n3v3, POV3DisplayDevice::trimesh_c4u_n3b_v3f, POV3DisplayDevice::tristrip, SpaceballTracker::update, VRPNTracker::update, FreeVRTracker::update, CaveTracker::update, MobileTracker::update, and VMDTracker::VMDTracker.

int Matrix4::inverse ( void )

inverts the matrix, that is, the inverse of the rotation, the inverse of the scaling, and the opposite of the translation vector. returns 0 if there were no problems, -1 if the matrix is singular.

Definition at line 136 of file Matrix4.C.

References mat, and MATSWAP.

Referenced by Tool::dograb, PickModeForce::get_force, get_transform_to_orthonormal_cell, measure_pbc_neighbors, myfit3, PickModeMove::pick_molecule_move, vmd_measure_inverse, and VolumetricData::voxel_coord_from_cartesian_coord.

void Matrix4::loadmatrix ( const Matrix4 & m )

replaces this matrix with the given one.

Definition at line 220 of file Matrix4.C.

References mat.

Referenced by Matrix4, measure_pbc_neighbors, operator=, VMDTracker::orientation, VRJugglerTracker::update, SpaceballTracker::update, and MobileTracker::update.

void Matrix4::lookat ( float ,

float ,

short

)

This subroutine defines a viewing transformation with the eye at point (vx,vy,vz) looking at the point (px,py,pz). Twist is the right-hand rotation about this line. The resultant matrix is multiplied with the top of the transformation stack and then replaces it. Precisely, lookat does: lookat=trans(-vx,-vy,-vz)*rotate(theta,y)*rotate(phi,x)*rotate(-twist,z).

Definition at line 364 of file Matrix4.C.

References constant, mat, multmatrix, rot, and translate.

void Matrix4::multmatrix ( const Matrix4 & )

premultiply the matrix by the given matrix, this->other * this.

Definition at line 225 of file Matrix4.C.

References mat.

Referenced by Displayable::add_rot, convert_endpoints_to_matrix, RotateTool::do_event, Tool::dograb, DisplayDevice::find_pbc_images, get_transform_to_orthonormal_cell, lookat, measure_fit, measure_pbc_neighbors, myfit3, VMDTracker::orientation, RotateTool::orientation, Displayable::recalc_mat, VRJugglerDisplayDevice::render, FreeVRDisplayDevice::render, CaveDisplayDevice::render, rot, scale, OpenGLRenderer::set_persp, translate, SpaceballTracker::update, and MobileTracker::update.

void Matrix4::multnorm3d ( const float[3],

float [3]

) const

multiplies a 3D norm (first arg) by the Matrix, returns in second arg.

Definition at line 72 of file Matrix4.C.

References mat.

Referenced by multplaneeq3d, OptiXRenderer::render_to_videostream, OptiXRenderer::ring_array_color, HMDMgr::rot_basis_quat, HMDMgr::rot_point_quat, OSPRayRenderer::tricolor_list, OSPRay2Renderer::tricolor_list, OptiXRenderer::tricolor_list, ANARIRender::tricolor_list, POV3DisplayDevice::trimesh_c4n3v3, OSPRayRenderer::trimesh_c4n3v3, OSPRay2Renderer::trimesh_c4n3v3, OptiXRenderer::trimesh_c4n3v3, ANARIRender::trimesh_c4n3v3, POV3DisplayDevice::trimesh_c4u_n3b_v3f, OSPRayRenderer::trimesh_c4u_n3b_v3f, OSPRay2Renderer::trimesh_c4u_n3b_v3f, OptiXRenderer::trimesh_c4u_n3b_v3f, ANARIRender::trimesh_c4u_n3b_v3f, OSPRayRenderer::trimesh_c4u_n3f_v3f, OSPRay2Renderer::trimesh_c4u_n3f_v3f, OptiXRenderer::trimesh_c4u_n3f_v3f, ANARIRender::trimesh_c4u_n3f_v3f, OSPRayRenderer::trimesh_n3b_v3f, OSPRay2Renderer::trimesh_n3b_v3f, OptiXRenderer::trimesh_n3b_v3f, ANARIRender::trimesh_n3b_v3f, OSPRayRenderer::trimesh_n3f_v3f, OSPRay2Renderer::trimesh_n3f_v3f, OptiXRenderer::trimesh_n3f_v3f, ANARIRender::trimesh_n3f_v3f, POV3DisplayDevice::tristrip, OSPRayRenderer::tristrip, OSPRay2Renderer::tristrip, OptiXRenderer::tristrip, LibTachyonDisplayDevice::tristrip, and ANARIRender::tristrip.

void Matrix4::multplaneeq3d ( const float[3],

float [3]

) const

multiplies a 3D texture plane equation by the Matrix.

Definition at line 89 of file Matrix4.C.

References multnorm3d.

void Matrix4::multpoint3d ( const float[3],

float [3]

) const

multiplies a 3D point (first arg) by the Matrix, returns in second arg.

Definition at line 35 of file Matrix4.C.

References mat.

Referenced by compute_pbcminmax, OSPRayRenderer::cylinder_array, OSPRay2Renderer::cylinder_array, OptiXRenderer::cylinder_array, ANARIRender::cylinder_array, OSPRayRenderer::cylinder_array_color, OSPRay2Renderer::cylinder_array_color, OptiXRenderer::cylinder_array_color, ANARIRender::cylinder_array_color, PinchTool::do_event, GrabTool::do_event, dodecahedron, Tool::dograb, PickModeForce::get_force, measure_fit, measure_move, measure_pbc_neighbors, multpointarray_3d, myfit3, normal_atom_coord, GeometryMol::normal_atom_coord, PickModeCenter::pick_molecule_end, PickModeMove::pick_molecule_move, Stage::pick_move, Axes::pick_move, OptiXRenderer::render_to_videostream, OptiXRenderer::ring_array_color, Scene::rotate_light, OSPRayRenderer::sphere_array, OSPRay2Renderer::sphere_array, OptiXRenderer::sphere_array, ANARIRender::sphere_array, OSPRayRenderer::sphere_array_color, OSPRay2Renderer::sphere_array_color, OptiXRenderer::sphere_array_color, ANARIRender::sphere_array_color, Tool::target, text_cmd_mol, trans_overlap, OSPRayRenderer::tricolor_list, OSPRay2Renderer::tricolor_list, OptiXRenderer::tricolor_list, ANARIRender::tricolor_list, POV3DisplayDevice::trimesh_c4n3v3, OSPRayRenderer::trimesh_c4n3v3, OSPRay2Renderer::trimesh_c4n3v3, OptiXRenderer::trimesh_c4n3v3, ANARIRender::trimesh_c4n3v3, POV3DisplayDevice::trimesh_c4u_n3b_v3f, OSPRayRenderer::trimesh_c4u_n3b_v3f, OSPRay2Renderer::trimesh_c4u_n3b_v3f, OptiXRenderer::trimesh_c4u_n3b_v3f, ANARIRender::trimesh_c4u_n3b_v3f, OSPRayRenderer::trimesh_c4u_n3f_v3f, OSPRay2Renderer::trimesh_c4u_n3f_v3f, OptiXRenderer::trimesh_c4u_n3f_v3f, ANARIRender::trimesh_c4u_n3f_v3f, OSPRayRenderer::trimesh_n3b_v3f, OSPRay2Renderer::trimesh_n3b_v3f, OptiXRenderer::trimesh_n3b_v3f, ANARIRender::trimesh_n3b_v3f, OSPRayRenderer::trimesh_n3f_v3f, OSPRay2Renderer::trimesh_n3f_v3f, OptiXRenderer::trimesh_n3f_v3f, ANARIRender::trimesh_n3f_v3f, OptiXRenderer::trimesh_v3f, POV3DisplayDevice::tristrip, OSPRayRenderer::tristrip, OSPRay2Renderer::tristrip, OptiXRenderer::tristrip, LibTachyonDisplayDevice::tristrip, ANARIRender::tristrip, Tool::tug, VRJugglerTracker::update, and VolumetricData::voxel_coord_from_cartesian_coord.

void Matrix4::multpoint4d ( const float[4],

float [4]

) const

multiplies a 4D point (first arg) by the Matrix, returns in second arg.

Definition at line 109 of file Matrix4.C.

References mat.

Referenced by Displayable::change_center, and text_cmd_mol.

void Matrix4::multpointarray_3d ( int numpts,

const float * ,

float *

) const

multiplies a 3D point array (2nd arg) by the Matrix, returns in 3rd arg.

Definition at line 60 of file Matrix4.C.

References multpoint3d.

Matrix4& Matrix4::operator= ( const Matrix4 & m ) [inline]

Definition at line 67 of file Matrix4.h.

References loadmatrix.

void Matrix4::ortho ( float ,

float ,

float

)

sets this matrix to a 3D orthographic matrix.

Definition at line 331 of file Matrix4.C.

References constant, and mat.

void Matrix4::ortho2 ( float ,

float ,

float

)

sets this matrix to a 2D orthographic matrix.

Definition at line 346 of file Matrix4.C.

References constant, and mat.

void Matrix4::rot ( float ,

char

)

performs a left-handed rotation around an axis (char == 'x', 'y', or 'z').

Definition at line 241 of file Matrix4.C.

References DEGTORAD, mat, and multmatrix.

Referenced by Displayable::add_rot, convert_endpoints_to_matrix, dodecahedron, lookat, myfit3, rotate_axis, Scene::rotate_light, Displayable::set_rot, transvec, transvec, transvecinv, transvecinv, VRJugglerTracker::update, SpaceballTracker::update, FreeVRTracker::update, CaveTracker::update, and MobileTracker::update.

void Matrix4::rotate_axis ( const float axis[3],

float angle

)

apply a rotation around the given vector; angle in radians.

Definition at line 273 of file Matrix4.C.

References RADTODEG, rot, transvec, and transvecinv.

Referenced by do_density_rotate, do_rotate, dodecahedron, obj_transabout, OptiXRenderer::render_to_videostream, Symmetry::score_axis, Symmetry::score_plane, and Symmetry::score_rotary_reflection.

void Matrix4::scale ( float f ) [inline]

Definition at line 90 of file Matrix4.h.

References scale.

void Matrix4::scale ( float ,

float ,

float

)

performs scaling.

Definition at line 307 of file Matrix4.C.

References mat, multmatrix, and z.

Referenced by Displayable::change_center, molinfo_get, Displayable::recalc_mat, scale, Symmetry::score_inversion, Symmetry::score_plane, Symmetry::score_rotary_reflection, FileRenderer::super_scale, POV3DisplayDevice::trimesh_c4n3v3, POV3DisplayDevice::trimesh_c4u_n3b_v3f, and POV3DisplayDevice::tristrip.

void Matrix4::translate ( float d[3] ) [inline]

Definition at line 86 of file Matrix4.h.

References translate.

void Matrix4::translate ( float ,

float ,

float

)

performs a translation.

Definition at line 298 of file Matrix4.C.

References mat, multmatrix, and z.

Referenced by convert_endpoints_to_matrix, get_transform_to_orthonormal_cell, Timestep::get_transforms, lookat, measure_fit, molinfo_get, myfit2, myfit3, Displayable::recalc_mat, Symmetry::score_axis, Symmetry::score_inversion, Symmetry::score_plane, Symmetry::score_rotary_reflection, Tool::target, and translate.

void Matrix4::transpose ( void )

transposes the matrix.

Definition at line 207 of file Matrix4.C.

References mat.

Referenced by Tool::tug.

void Matrix4::transvec ( float x,

float y,

float z

)

apply a rotation such that 'x' is brought along the given vector.

Definition at line 280 of file Matrix4.C.

References length, RADTODEG, rot, and z.

Referenced by obj_transvec, and rotate_axis.

void Matrix4::transvecinv ( float x,

float y,

float z

)

apply a rotation such that the given vector is brought along 'x'.

Definition at line 289 of file Matrix4.C.

References length, RADTODEG, rot, and z.

Referenced by obj_transvecinv, and rotate_axis.

void Matrix4::window ( float ,

float ,

float

)

sets this matrix to represent a window perspective.

Definition at line 316 of file Matrix4.C.

References constant, and mat.

float Matrix4::mat[16]

the matrix itself.

Definition at line 33 of file Matrix4.h.

Referenced by atomselect_move, compute_pbcminmax, constant, CmdRotMat::create_text, OSPRayDisplayDevice::cylinder, OSPRay2DisplayDevice::cylinder, OptiXDisplayDevice::cylinder, do_density_rotate, RotateTool::do_event, PrintTool::do_event, Tool::dograb, Timestep::get_transform_from_cell, M_VRJapp::getWandRotMat, handle_vrpn_tracker, identity, inverse, VrmlDisplayDevice::load, OpenGLRenderer::loadmatrix, loadmatrix, lookat, Matrix4, measure_fit, measure_move, measure_pbc2onc, measure_pbc_neighbors, molinfo_get, molinfo_set, OpenGLRenderer::multmatrix, multmatrix, multnorm3d, multpoint3d, multpoint4d, obj_transabout, obj_transvec, obj_transvecinv, ortho, ortho2, print_Matrix4, py_fit, py_get_rotation, py_move, PSDisplayDevice::render, FileRenderer::render, rot, HMDMgr::rot_basis_quat, HMDMgr::rot_point_quat, scale, FileRenderer::scale_factor, OptiXDisplayDevice::sphere, text_cmd_mol, text_cmd_tool, trans_from_rotate, translate, transpose, OSPRayDisplayDevice::triangle, OSPRay2DisplayDevice::triangle, OptiXDisplayDevice::triangle, ANARIDisplayDevice::triangle, POV3DisplayDevice::trimesh_c4n3v3, POV3DisplayDevice::trimesh_c4u_n3b_v3f, POV3DisplayDevice::tristrip, vmd_measure_fit, vmd_measure_inverse, vmd_measure_pbc2onc_transform, vmd_measure_pbc_neighbors, vmd_measure_symmetry, vmd_measure_trans_overlap, vmd_volmap_ils, and window.

The documentation for this class was generated from the following files:

Matrix4 Class Reference

Public Methods

Public Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation