MVector Class Reference

#include <MVector.h>

Class Description

A vector math class for vectors of doubles.

This class provides access to Maya's internal vector math library allowing vectors to be handled easily, and in a manner compatible with internal Maya data structures.

All methods that query the vector are threadsafe, all methods that modify the vector are not threadsafe.

Examples:

Public Types
enum	Axis { kXaxis, kYaxis, kZaxis, kWaxis }
	Axes. More...

Public Member Functions
	MVector ()
	The default class constructor. More...
	MVector (const MVector &)
	The copy constructor. More...
	MVector (const MFloatVector &)
	Class constructor. More...
	MVector (const MPoint &)
	Class constructor. More...
	MVector (const MFloatPoint &)
	Class constructor. More...
	MVector (double xx, double yy, double zz=0.0)
	Class constructor. More...
	MVector (const double d[3])
	Class constructor. More...
	MVector (const float f[3])
	Class constructor. More...
	~MVector ()
	Class destructor.
MVector &	operator= (const MVector &src)
	The assignment operator. More...
double	operator() (unsigned int i) const
	The index operator. More...
double	operator[] (unsigned int i) const
	The index operator. More...
MVector	operator^ (const MVector &right) const
	The cross product operator. More...
double	operator* (const MVector &right) const
	The dot product operator. More...
MVector &	operator/= (double scalar)
	The in place division operator. More...
MVector	operator/ (double scalar) const
	The division operator. More...
MVector &	operator*= (int scalar)
	The in place multiplication operator. More...
MVector &	operator*= (short scalar)
	The in place multiplication operator. More...
MVector &	operator*= (unsigned int scalar)
	The in place multiplication operator. More...
MVector &	operator*= (unsigned short scalar)
	The in place multiplication operator. More...
MVector &	operator*= (float scalar)
	The in place multiplication operator. More...
MVector &	operator*= (double scalar)
	The in place multiplication operator. More...
MVector	operator* (int scalar) const
	The multiplication operator. More...
MVector	operator* (short scalar) const
	The multiplication operator. More...
MVector	operator* (unsigned int scalar) const
	The multiplication operator. More...
MVector	operator* (unsigned short scalar) const
	The multiplication operator. More...
MVector	operator* (float scalar) const
	The multiplication operator. More...
MVector	operator* (double scalar) const
	The multiplication operator. More...
MVector	operator+ (const MVector &other) const
	The vector addition operator. More...
MVector &	operator+= (const MVector &other)
	The in place vector addition operator. More...
MVector	operator- () const
	The unary minus operator. More...
MVector &	operator-= (const MVector &other)
	The in place vector subtraction operator. More...
MVector	operator- (const MVector &other) const
	The vector subtraction operator. More...
MVector	operator* (const MMatrix &) const
	The matrix multiplication operator.
MVector &	operator*= (const MMatrix &)
	The in place matrix multiplication operator.
bool	operator!= (const MVector &other) const
	The vector inequality operator. More...
bool	operator== (const MVector &other) const
	The vector equality operator. More...
MVector	rotateBy (double x, double y, double z, double w) const
	Returns the vector that represents the rotation of this vector by the given quaternion. More...
MVector	rotateBy (const double rotXYZ[3], MTransformationMatrix::RotationOrder order) const
	Returns the vector that represents the rotation of this vector by the given XYZ rotational values, applied according to the given rotation order. More...
MVector	rotateBy (MVector::Axis axis, const double angle) const
	Returns the vector that represents the rotation of this vector by the given angle about the given axis. More...
MVector	rotateBy (const MQuaternion &) const
	Returns the vector that represents the rotation of this vector by the given quaternion. More...
MVector	rotateBy (const MEulerRotation &) const
	Returns the vector that represents the rotation of this vector by the given euler rotation. More...
MQuaternion	rotateTo (const MVector &) const
	Returns the quaternion that represents the rotation of this vector into the other vector about their mutually perpendicular axis. More...
MStatus	get (double[3]) const
	Extracts the x, y, and z components of the vector and places them in elements 0, 1, and 2 of the double array passed. More...
double	length () const
	Return the length of the vector.
MVector	normal () const
	Return a normalized copy of this vector.
MStatus	normalize ()
	Performs an in place normalization of the vector. More...
double	angle (const MVector &other) const
	Returns the angle in radians between the vector and the one passed as an argument. More...
bool	isEquivalent (const MVector &other, double tolerance=MVector_kTol) const
	Returns true if the vector and the one passed as an argument are equal to each other within the specified tolerance. More...
bool	isParallel (const MVector &other, double tolerance=MVector_kTol) const
	Returns true if the current vector and the one passed as an argument are parallel to each other within the specified tolerance. More...
MVector	transformAsNormal (const MMatrix &matrix) const
	This method treats the vector as a normal vector and returns a transformed copy of the vector. More...
double &	operator() (unsigned int i)
	NO SCRIPT SUPPORT. More...
double &	operator[] (unsigned int i)
	NO SCRIPT SUPPORT. More...

Public Attributes
double	x
	The x component of the vector.
double	y
	The y component of the vector.
double	z
	The z component of the vector.

Static Public Attributes
static const MVector	zero
	The null vector.
static const MVector	one
	The vector <1,1,1>
static const MVector	xAxis
	Unit vector in the positive x direction.
static const MVector	yAxis
	Unit vector in the positive y direction.
static const MVector	zAxis
	Unit vector in the positive z direction.
static const MVector	xNegAxis
	Unit vector in the negative z direction.
static const MVector	yNegAxis
	Unit vector in the negative z direction.
static const MVector	zNegAxis
	Unit vector in the negative z direction.

Friends
OPENMAYA_EXPORT MVector	operator* (const MMatrix &, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (int, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (short, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (unsigned int, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (unsigned short, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (float, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT MVector	operator* (double, const MVector &)
	NO SCRIPT SUPPORT. More...
OPENMAYA_EXPORT std::ostream &	operator<< (std::ostream &os, const MVector &v)
	NO SCRIPT SUPPORT. More...

Member Enumeration Documentation

enum Axis

Axes.

Enumerator
kXaxis
kYaxis
kZaxis
kWaxis

Constructor & Destructor Documentation

MVector ( )

inline

The default class constructor.

Creates a null vector.

MVector ( const MVector &  src )

inline

The copy constructor.

Create a new vector and initialize it to the same values as the given vector.

Parameters

[in]

src

the vector object to copy

MVector ( const MFloatVector &  src )

inline

Class constructor.

Create a new vector and initialize it to the same values as the given MFloatVector.

Parameters

[in]

src

the vector object to copy

MVector ( const MPoint &  src )

inline

Class constructor.

Create a new vector and initialize it to the same x, y, z values as the given MPoint.

Parameters

[in]

src

the point object to copy

MVector ( const MFloatPoint &  src )

inline

Class constructor.

Create a new vector and initialize it to the same x, y, z values as the given point.

Parameters

[in]

src

the point object to copy

MVector ( double  xx, double  yy, double  zz = 0.0  )

inline

Class constructor.

Initializes the vector with the explicit x, y and z values provided as arguments.

Parameters

[in]	xx	the x component of the vector
[in]	yy	the y component of the vector
[in]	zz	the z component of the vector. Defaults to 0.0.

MVector ( const double  d[3] )

inline

Class constructor.

Initializes the vector with the explicit x, y and z values provided in the given double array.

Parameters

[in]

d

the 3 element array containing the initial x, y, and z values

MVector ( const float  f[3] )

inline

Class constructor.

Initializes the vector with the explicit x, y and z values provided in the given float array.

Parameters

[in]

f

the 3 element array containing the initial x, y, and z values

Member Function Documentation

MVector & operator= ( const MVector &  src )

inline

The assignment operator.

Allows assignment between MVectors.

Parameters

[in]

src

Vector to copy from.

double operator() ( unsigned int  i ) const

inline

The index operator.

If its argument is 0 it will return the x component of the vector. If its argument is 1 it will return the y component of the vector. Otherwise it will return the z component of the vector.

Parameters

[in]

i

value indicating which component to return

double operator[] ( unsigned int  i ) const

inline

The index operator.

If its argument is 0 it will return the x component of the vector. If its argument is 1 it will return the y component of the vector. Otherwise it will return the z component of the vector.

Parameters

[in]

i

value indicating which component to return

MVector operator^ ( const MVector &  right ) const

inline

The cross product operator.

Parameters

[in]

right

Vector to take the cross product with.

double operator* ( const MVector &  right ) const

inline

The dot product operator.

Parameters

[in]

right

Vector to take the dot product with.

MVector & operator/= ( double  scalar )

inline

The in place division operator.

Parameters

[in]

scalar

Division factor.

MVector operator/ ( double  scalar ) const

inline

The division operator.

Parameters

[in]

scalar

Division factor.

MVector & operator*= ( int  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector & operator*= ( short  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector & operator*= ( unsigned int  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector & operator*= ( unsigned short  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector & operator*= ( float  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector & operator*= ( double  scalar )

inline

The in place multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( int  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( short  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( unsigned int  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( unsigned short  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( float  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator* ( double  scalar ) const

inline

The multiplication operator.

Parameters

[in]

scalar

Scale factor.

MVector operator+ ( const MVector &  other ) const

inline

The vector addition operator.

Parameters

[in]

other

Vector to add.

MVector & operator+= ( const MVector &  other )

inline

The in place vector addition operator.

Parameters

[in]

other

Vector to add.

MVector operator- ( ) const

inline

The unary minus operator.

Negates the value of each of the x, y, and z components of the vector.

MVector & operator-= ( const MVector &  other )

inline

The in place vector subtraction operator.

Parameters

[in]

other

Vector to subtract.

MVector operator- ( const MVector &  other ) const

inline

The vector subtraction operator.

Parameters

[in]

other

Vector to substract.

bool operator!= ( const MVector &  other ) const

inline

The vector inequality operator.

This returns false if all three of the x, y, and z components are identical.

Parameters

[in]

other

The vector to compare to.

Returns

Bool false if the vectors are identical and true otherwise.

bool operator== ( const MVector &  other ) const

inline

The vector equality operator.

This returns true if all three of the x, y, and z components are identical.

Parameters

[in]

other

The vector to compare to.

Returns

Bool true if the vectors are identical and false otherwise.

MVector rotateBy	(	double	x,
		double	y,
		double	z,
		double	w
	)		const

Returns the vector that represents the rotation of this vector by the given quaternion.

Parameters

[in]	x	The x component of the quaternion.
[in]	y	The y component of the quaternion.
[in]	z	The z component of the quaternion.
[in]	w	The w component of the quaternion.

Returns

The resulting vector.

Examples:

MVector rotateBy	(	const double	rotXYZ[3],
		MTransformationMatrix::RotationOrder	order
	)		const

Returns the vector that represents the rotation of this vector by the given XYZ rotational values, applied according to the given rotation order.

Parameters

[in]	rotXYZ	Array containing the X, Y, and Z axis rotations, respectively.
[in]	order	Order in which to apply the XYZ components of the rotation.

Returns

The resulting vector.

MVector rotateBy	(	MVector::Axis	axis,
		const double	angle
	)		const

Returns the vector that represents the rotation of this vector by the given angle about the given axis.

Parameters

[in]	axis	The axis to rotate about.
[in]	angle	The rotation angle about the axis.

Returns

The resulting vector.

MVector rotateBy

(

const MQuaternion &

q

)

const

Returns the vector that represents the rotation of this vector by the given quaternion.

Parameters

[in]

q

The quaternion rotation by which the vector will be rotated to produce the resulting vector.

Returns

The resulting vector.

MVector rotateBy

(

const MEulerRotation &

e

)

const

Returns the vector that represents the rotation of this vector by the given euler rotation.

Parameters

[in]

e

The euler rotation by which the vector will be rotated to produce the resulting vector.

Returns

The resulting vector.

MQuaternion rotateTo

(

const MVector &

other

)

const

Returns the quaternion that represents the rotation of this vector into the other vector about their mutually perpendicular axis.

Parameters

[in]

other

The other vector into which this vector will be rotated to produce the resulting quaternion rotation.

Returns

The resulting quaternion.

MStatus get ( double  dest[3] ) const

inline

Extracts the x, y, and z components of the vector and places them in elements 0, 1, and 2 of the double array passed.

Parameters

[out]

dest

the array of 3 doubles into which the results are placed.

Returns

MS::kSuccess if dest is a non-zero pointer and MS::kFailure otherwise.

Examples:

MStatus normalize ( )

inline

Performs an in place normalization of the vector.

Returns

Always returns MS::kSuccess.

Examples:

double angle

(

const MVector &

other

)

const

Returns the angle in radians between the vector and the one passed as an argument.

Parameters

[in]

other

the vector from which to compute the angle.

Returns

The angle in radians

Examples:

bool isEquivalent ( const MVector &  other, double  tol = MVector_kTol  ) const

inline

Returns true if the vector and the one passed as an argument are equal to each other within the specified tolerance.

Parameters

[in]	other	The vector to compare to.
[in]	tol	The tolerance to use during the comparison.

Returns

Bool true if the vectors are equivalent and false otherwise.

Examples:

bool isParallel	(	const MVector &	other,
		double	tol = MVector_kTol
	)		const

Returns true if the current vector and the one passed as an argument are parallel to each other within the specified tolerance.

Parameters

[in]	other	the vector to compare to
[in]	tol	the tolerance to use during the comparison

Returns

true if the vectors are parallel and false otherwise

MVector transformAsNormal

(

const MMatrix &

matrix

)

const

This method treats the vector as a normal vector and returns a transformed copy of the vector.

Normal vectors are not transformed in the same way as position vectors or points. If this vector is treated as a normal vector then it needs to be transformed by post multiplying it by the inverse tanspose of the transformation matrix. This method will apply the proper transformation to the vector as if it were a normal.

Parameters

[in]

matrix

the transformation matrix

Returns

The resulting transformed vector

double & operator() ( unsigned int  i )

inline

NO SCRIPT SUPPORT.

The index operator.

If its argument is 0 it will return the x component of the vector. If its argument is 1 it will return the y component of the vector. Otherwise it will return the z component of the vector.

Parameters

[in]

i

value indicating which component to return

double & operator[] ( unsigned int  i )

inline

NO SCRIPT SUPPORT.

The index operator.

If its argument is 0 it will return the x component of the vector. If its argument is 1 it will return the y component of the vector. Otherwise it will return the z component of the vector.

Parameters

[in]

i

value indicating which component to return

Friends And Related Function Documentation

OPENMAYA_EXPORT MVector operator* ( const MMatrix &  left, const MVector &  right  )

friend

NO SCRIPT SUPPORT.

An MVector is the result.

Parameters

[in]	left	the matrix on the left
[in]	right	the vector on the right

Returns

The MVector resulting from the multiplication

OPENMAYA_EXPORT MVector operator* ( int  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT MVector operator* ( short  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT MVector operator* ( unsigned int  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT MVector operator* ( unsigned short  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT MVector operator* ( float  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT MVector operator* ( double  scalar, const MVector &  other  )

friend

NO SCRIPT SUPPORT.

Parameters

[in]	scalar	Scale factor.
[in]	other	Vector to scale.

Returns

The scales vector.

OPENMAYA_EXPORT std::ostream& operator<< ( std::ostream &  os, const MVector &  v  )

friend

NO SCRIPT SUPPORT.

The format used is [x, y, z].

Parameters

[in]	os	the ostream to print to
[in]	v	the MVector whose value is to be printed

Returns

The ostream reference, os, provided as the first parameter.

---

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

• MVector.h
• MVector.cpp