Set and retrieve animation time values in various unit systems. More...

#include <MTime.h>

Public Member Functions
	OPENMAYA_ENUM (Unit, kInvalid, kHours, kMinutes, kSeconds, kMilliseconds, kGames, k15FPS=kGames, kFilm, k24FPS=kFilm, kPALFrame, k25FPS=kPALFrame, kNTSCFrame, k30FPS=kNTSCFrame, kShowScan, k48FPS=kShowScan, kPALField, k50FPS=kPALField, kNTSCField, k60FPS=kNTSCField, k2FPS, k3FPS, k4FPS, k5FPS, k6FPS, k8FPS, k10FPS, k12FPS, k16FPS, k20FPS, k40FPS, k75FPS, k80FPS, k100FPS, k120FPS, k125FPS, k150FPS, k200FPS, k240FPS, k250FPS, k300FPS, k375FPS, k400FPS, k500FPS, k600FPS, k750FPS, k1200FPS, k1500FPS, k2000FPS, k3000FPS, k6000FPS, k23_976FPS, k29_97FPS, k29_97DF, k47_952FPS, k59_94FPS, k44100FPS, k48000FPS, k90FPS, kUserDef, kLast)
	Time units.

	MTime ()
	Default class constructor. More...

	MTime (const MTime &)
	Copy Constructor. More...

	~MTime ()
	The class destructor.

Unit	unit () const
	Returns the current units in effect for this instance. More...

double	value () const
	Returns the current time value in the units that are currently in effect for this instance. More...

MStatus	setUnit (Unit new_unit)
	Set the current units in effect on this MTime instance. More...

MStatus	setValue (double new_value)
	Set the current time value in the current units for this instance. More...

double	as (Unit other_unit) const
	Returns the current time value in the given units. More...

double	asUnits (Unit other_unit) const
	Returns the current time value in the given units. More...

MTime &	operator= (const MTime &rhs)
	Assignment operator. More...

bool	operator== (const MTime &rhs) const
	Equality operator. More...

bool	operator!= (const MTime &rhs) const
	InEquality operator. More...

bool	operator<= (const MTime &rhs) const
	Less than or equal to operator. More...

bool	operator>= (const MTime &rhs) const
	Greater than or equal to operator. More...

bool	operator< (const MTime &rhs) const
	Less than operator. More...

bool	operator> (const MTime &rhs) const
	Greater than operator. More...

MTime	operator+ (const MTime &rhs) const
	Addition with another MTime. More...

MTime &	operator+= (const MTime &rhs)
	In-place addition with another MTime. More...

MTime	operator+ (double rhs) const
	Addition with a double. More...

MTime &	operator+= (double rhs)
	In-place addition with a double. More...

MTime	operator- (const MTime &rhs) const
	Subtraction of another MTime. More...

MTime &	operator-= (const MTime &rhs)
	In-place subtraction of another MTime. More...

MTime	operator- (double rhs) const
	Subtraction of a double. More...

MTime &	operator-= (double rhs)
	In-place Subtraction of a double. More...

MTime	operator* (double rhs) const
	Multiplication by a scalar operator. More...

MTime &	operator*= (double rhs)
	In place multiplication by a scalar operator. More...

MTime	operator/ (double rhs) const
	Division by a scalar operator. More...

MTime &	operator/= (double rhs)
	In place division by a scalar operator. More...

MTime &	operator++ ()
	NO SCRIPT SUPPORT. More...

MTime &	operator++ (int)
	NO SCRIPT SUPPORT. More...

MTime &	operator-- ()
	NO SCRIPT SUPPORT. More...

MTime &	operator-- (int)
	NO SCRIPT SUPPORT. More...

Static Public Member Functions
static Unit	uiUnit ()
	Returns the Working Units (or UI units) chosen in the settings of the prefs window. More...

static MStatus	setUIUnit (Unit new_unit)
	Set the unit system to be used by the user in the UI. More...

static const char *	className ()
	Returns the name of this class. More...

static MTick	ticksPerSecond ()
	Returns the number of ticks per second, the smallest unit of time available. More...

Friends
OPENMAYA_EXPORT std::ostream &	operator<< (std::ostream &os, const MTime &t)
	NO SCRIPT SUPPORT. More...

Detailed Description

Set and retrieve animation time values in various unit systems.

The MTime class provides a fundamental type for the Maya API to hold and manipulate animation timing information in various unit systems. All API methods that require or return timing information do so through variables of this type.

If one desires to manipulate time in such a way that integer changes in an MTime instance result in integer changes in the frame displayed by the timeslider, then an MTime instance should be created that uses UI units. This can be done either by using the default constructor, or by passing the return value of the static method uiUnit to the normal constructor. Once such an MTime instance is created, its value will be equivalent to a frame on the timeslider.

It should be noted that while the timeslider displays frames, a seemingly unitless value, Maya internally is operating based on the desired frameRate (one of those specified by the MTime::Unit enum. It is necessary for the API programmer to be aware of this as MTime instances are not unitless and allow the manipulation of time in any desired units.

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/MayaUtility.cpp, AbcExport/AbcExport.cpp, AbcExport/MayaCameraWriter.cpp, AbcExport/MayaPointPrimitiveWriter.cpp, AbcExport/MayaUtility.cpp, AbcImport/AbcImport.cpp, AbcImport/AlembicNode.cpp, AbcImport/CameraHelper.cpp, AbcImport/NodeIteratorVisitorHelper.cpp, AbcImport/util.cpp, animCubeNode/animCubeNode.cpp, animImportExport/animFileUtils.cpp, animInfoCmd/animInfoCmd.cpp, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomAnimLayers.h, atomImportExport/atomFileUtils.cpp, atomImportExport/atomFileUtils.h, atomImportExport/atomImportExport.cpp, atomImportExport/atomImportExport.h, blast2Cmd/blast2Cmd.cpp, captureViewRenderCmd/captureViewRenderCmd.cpp, createClipCmd/createClipCmd.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheCmd.h, gpuCache/gpuCacheGeometry.h, gpuCache/gpuCacheMaterialBakers.cpp, gpuCache/gpuCacheMaterialBakers.h, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, interpPlugins/interpFlat.cpp, interpPlugins/interpFlat.h, interpPlugins/interpHalf.cpp, interpPlugins/interpHalf.h, interpZero/interpZero.cpp, latticeNoise/latticeNoiseNode.cpp, MayaPluginForSpreticle/spReticleLoc.cpp, motionPathCmd/motionPathCmd.cpp, motionTraceCmd/motionTraceCmd.cpp, ownerEmitter/ownerEmitter.cpp, ownerEmitter/ownerEmitter.h, particlePathsCmd/particlePathsCmd.cpp, renderViewInteractiveRenderCmd/renderViewInteractiveRenderCmd.cpp, simpleEmitter/simpleEmitter.cpp, simpleEmitter/simpleEmitter.h, simpleEvaluationDraw/simpleEvaluationDraw.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, simpleFluidEmitter/simpleFluidEmitter.cpp, simpleSimulationNode/simpleSimulationNode.cpp, spiralAnimCurveCmd/spiralAnimCurveCmd.cpp, sweptEmitter/sweptEmitter.cpp, sweptEmitter/sweptEmitter.h, testNsolverNode/testNsolverNode.cpp, testNucleusNode/testNucleusNode.cpp, XmlGeometryCache/XmlGeometryCache.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

Constructor & Destructor Documentation

OPENMAYA_MAJOR_NAMESPACE_OPEN MTime ( )

Default class constructor.

Sets the initial time to 1 (the first frame) in the UI units currently in effect.

MTime ( const MTime & src )

Copy Constructor.

Parameters

[in] src the instance to copy

Member Function Documentation

MTime::Unit unit ( ) const

Returns the current units in effect for this instance.

Returns: An element of the MTime::Unit enum

Examples:: atomImportExport/atomImportExport.cpp.

double value ( ) const

Returns the current time value in the units that are currently in effect for this instance.

Returns: The current time value

Examples:: AbcBullet/AbcBullet.cpp, AbcExport/AbcExport.cpp, animImportExport/animFileUtils.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, dx11Shader/dx11Shader.cpp, MayaPluginForSpreticle/spReticleLoc.cpp, renderViewInteractiveRenderCmd/renderViewInteractiveRenderCmd.cpp, simpleEvaluationDraw/simpleEvaluationDraw.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, testNsolverNode/testNsolverNode.cpp, testNucleusNode/testNucleusNode.cpp, and viewRenderOverrideFrameCache/viewRenderOverrideFrameCache.cpp.

MStatus setUnit ( Unit new_unit )

Set the current units in effect on this MTime instance.

Note that this method only changes the current units in the instance, it does not affect the value. So, calls to the value method before and after a call to setUnit will return the same number, however, the interpretation of that number will be different due to the change in unit systems.

Parameters

[in] newUnit an element of the MTime::Unit enum

Returns: kSuccess if the given unit is valid, kInvalidParameter otherwise

MStatus setValue ( double newValue )

Set the current time value in the current units for this instance.

Parameters

[in] newValue The new time value.

Returns: kSuccess if the value is set successfully, kFailure otherwise

Examples:: AbcImport/util.cpp, XmlGeometryCache/XmlGeometryCache.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

double as ( Unit other_unit ) const

Returns the current time value in the given units.

This does not affect the current units for the instance.

Parameters

[in] newUnit an element of the MTime::Unit enum

Returns: The current time value in the given units

Examples:: AbcBullet/MayaUtility.cpp, AbcExport/MayaCameraWriter.cpp, AbcImport/AlembicNode.cpp, AbcImport/CameraHelper.cpp, animCubeNode/animCubeNode.cpp, animImportExport/animFileUtils.cpp, animInfoCmd/animInfoCmd.cpp, atomImportExport/atomFileUtils.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheDrawOverride.cpp, gpuCache/gpuCacheGeometry.h, gpuCache/gpuCacheMaterialBakers.cpp, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, interpPlugins/interpHalf.cpp, latticeNoise/latticeNoiseNode.cpp, ownerEmitter/ownerEmitter.cpp, simpleEmitter/simpleEmitter.cpp, sweptEmitter/sweptEmitter.cpp, testNsolverNode/testNsolverNode.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

double asUnits ( Unit other_unit ) const

Returns the current time value in the given units.

This does not affect the current units for the instance.

Parameters

[in] newUnit an element of the MTime::Unit enum

Returns: The current time value in the given units

MTime::Unit uiUnit ( )

static

Returns the Working Units (or UI units) chosen in the settings of the prefs window.

Maya's timeslider displays frames in these units.

Returns: An element of the MTime::Unit enum

Examples:: AbcBullet/MayaUtility.cpp, AbcExport/MayaCameraWriter.cpp, AbcExport/MayaUtility.cpp, AbcImport/AbcImport.cpp, AbcImport/AlembicNode.cpp, AbcImport/CameraHelper.cpp, AbcImport/NodeIteratorVisitorHelper.cpp, animExportUtil/animFileExport.cpp, animImportExport/animFileUtils.cpp, animInfoCmd/animInfoCmd.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, and gpuCache/gpuCacheCmd.cpp.

MStatus setUIUnit ( Unit new_unit )

static

Set the unit system to be used by the user in the UI.

After the successful completion of this method, Maya's timeslider will be displaying frames in the specified units.

Parameters

[in] newUnit an element of the MTime::Unit enum

Returns: kSuccess if the given unit is valid, kInvalidParameter otherwise

Examples:: animImportExport/animFileUtils.cpp, atomImportExport/atomFileUtils.cpp, and atomImportExport/atomImportExport.cpp.

MTime & operator= ( const MTime & rhs )

Assignment operator.

Parameters

[in] rhs Right operand.

bool operator== ( const MTime & rhs ) const

Equality operator.

Parameters

[in] rhs Right operand.

bool operator!= ( const MTime & rhs ) const

InEquality operator.

Parameters

[in] rhs Right operand.

bool operator<= ( const MTime & rhs ) const

Less than or equal to operator.

Parameters

[in] rhs Right operand.

bool operator>= ( const MTime & rhs ) const

Greater than or equal to operator.

Parameters

[in] rhs Right operand.

bool operator< ( const MTime & rhs ) const

Less than operator.

Parameters

[in] rhs Right operand.

bool operator> ( const MTime & rhs ) const

Greater than operator.

Parameters

[in] rhs Right operand.

MTime operator+ ( const MTime & rhs ) const

Addition with another MTime.

The value of the MTime on the right is converted to the units of the MTime on the left. The two values are added together and returned in a new MTime. Neither of the operands is changed.

Parameters

[in] rhs Right operand.

MTime & operator+= ( const MTime & rhs )

In-place addition with another MTime.

The value of the MTime on the right is converted to the units of the MTime on the left and added to it, leaving the result in the MTime on the left.

Parameters

[in] rhs Right operand.

MTime operator+ ( double rhs ) const

Addition with a double.

The double is interpreted as a number of frames in the units of the MTime instance to the left of the + operator. Thus, to increase time by five frames in the current units, add 5 to the instance.

The result is returned in a new MTime. The MTime on the left is not modified.

Parameters

[in] rhs Right operand.

MTime & operator+= ( double rhs )

In-place addition with a double.

The double is interpreted as a number of frames in the units of the MTime instance. Thus, to increase time by five frames in the current units, add 5 to the instance.

The result is placed into the MTime on the left.

Parameters

[in] rhs Right operand.

MTime operator- ( const MTime & rhs ) const

Subtraction of another MTime.

The MTime on the right is converted to the units of the MTime on the left and subtracted from the left's value. The result is returned in a new MTime. Neither of the two operands is modified.

Parameters

[in] rhs Right operand.

MTime & operator-= ( const MTime & rhs )

In-place subtraction of another MTime.

The MTime on the right is converted to the units of the MTime on the left and subtracted from it. The result is placed in the MTime on the left.

Parameters

[in] rhs Right operand.

MTime operator- ( double rhs ) const

Subtraction of a double.

The double is interpreted as a number of frames in the units of the MTime instance to the left of the - operator. Thus, to decrease time by five frames in the current units, subtract 5 from the instance.

The result is returned in a new MTime. The MTime on the left is not modified.

Parameters

[in] rhs Right operand.

MTime & operator-= ( double rhs )

In-place Subtraction of a double.

The double is interpreted as a number of frames in the units of the MTime instance. Thus, to decrease time by five frames in the current units, subtract 5 from the instance.

The result is placed into the MTime on the left.

Parameters

[in] rhs Right operand.

MTime operator* ( double rhs ) const

Multiplication by a scalar operator.

Multiply the instance to the left of the * operator by the given double, and assign the result to a new MTime instance.

Parameters

[in] rhs the scalar to multiply by.

MTime & operator*= ( double rhs )

In place multiplication by a scalar operator.

Multiply the current instance by the given double.

Parameters

[in] rhs the scalar to multiply by.

MTime operator/ ( double rhs ) const

Division by a scalar operator.

Divide the instance to the left of the / operator by the given double, and assign the result to a new MTime instance.

Parameters

[in] rhs the scalar to divide by.

MTime & operator/= ( double rhs )

In place division by a scalar operator.

Divide the current instance by the given double.

Parameters

[in] rhs the scalar to multiply by.

MTime & operator++ ( )

NO SCRIPT SUPPORT.

Prefix increment operator.

MTime & operator++ ( int dTime )

NO SCRIPT SUPPORT.

Postfix increment operator.

Parameters

[in] dTime dummy argument to differentiate the prefix and postfix operators.

MTime & operator-- ( )

NO SCRIPT SUPPORT.

Prefix decrement operator.

MTime & operator-- ( int dTime )

NO SCRIPT SUPPORT.

Postfix decrement operator.

Parameters

[in] dTime dummy argument to differentiate the prefix and postfix operators.

const char * className ( )

static

Returns the name of this class.

Returns: The name of this class.

MTime::MTick ticksPerSecond ( )

static

Returns the number of ticks per second, the smallest unit of time available.

Returns: The number of ticks per second.

Examples:: simpleSimulationNode/simpleSimulationNode.cpp.

Friends And Related Function Documentation

OPENMAYA_EXPORT std::ostream& operator<<	(	std::ostream &	os,
		const MTime &	t
	)

friend

NO SCRIPT SUPPORT.

Prints the result of a call to the value() method on the given MTime instance.

Parameters

[in]	os	the ostream to print to
[in]	t	the MTime 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:

MTime.h
MTime.cpp

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation