C++ API Reference
MDrawRequest Class Reference

This class encapsulates all the information needed to fulfill a request to draw an object or part of an object. More...

#include <MDrawRequest.h>

Public Member Functions

 MDrawRequest ()
 Constructor.
 
 MDrawRequest (const MDrawRequest &in)
 Copy constructor. More...
 
 ~MDrawRequest ()
 Destructor.
 
M3dView view () const
 Returns the view where drawing will be done.
 
void setView (M3dView &)
 Sets the view where drawing will be done.
 
const MDagPath multiPath () const
 Returns the path to the object to be drawn.
 
void setMultiPath (const MDagPath &)
 Sets the path to the object to be drawn.
 
MObject component () const
 An optional component. More...
 
void setComponent (MObject &)
 Set a component to be drawn. More...
 
MDrawData drawData () const
 Returns the object specific draw data.
 
void setDrawData (MDrawData &)
 Set the object specific draw data. More...
 
M3dView::DisplayStatus displayStatus () const
 Return the state of object (active, dormant, etc.).
 
void setDisplayStatus (M3dView::DisplayStatus)
 Set the state of object (active, dormant, etc.). More...
 
bool displayCulling () const
 Returns the state of the culling flag for the object.
 
void setDisplayCulling (bool)
 Sets the state of the culling flag for the object. More...
 
bool displayCullOpposite () const
 Returns the state of the culling flag for the object.
 
void setDisplayCullOpposite (bool)
 Sets the state of the culling flag for the object. More...
 
M3dView::DisplayStyle displayStyle () const
 Returns how the object should be drawn (wireframe, shaded, etc.).
 
void setDisplayStyle (M3dView::DisplayStyle)
 Sets how the object should be drawn (wireframe, shaded, etc.). More...
 
int color (M3dView::ColorTable table) const
 Returns the wireframe display color. More...
 
void setColor (int, M3dView::ColorTable table)
 Sets the wireframe display color. More...
 
MColor color () const
 Returns the RGBA wireframe display color. More...
 
void setColor (const MColor &color)
 Sets the RGBA wireframe display color. More...
 
MMaterial material () const
 Returns the shaded material.
 
void setMaterial (MMaterial &)
 Returns the shaded material. More...
 
bool isTransparent () const
 Returns the transparency state of the object.
 
void setIsTransparent (bool)
 Sets the transparency state of the object. More...
 
bool drawLast () const
 Returns the order in which this object will be drawn.
 
void setDrawLast (bool)
 Specifies the order in which this object will be drawn. More...
 
int token () const
 Returns the user-defined draw token for this request. More...
 
void setToken (int)
 Set the user-defined draw token for this request. More...
 
const MMatrixmatrix () const
 Returns the draw matrix. More...
 
void setMatrix (const MMatrix &)
 Set the draw matrix. More...
 
MDrawRequestoperator= (const MDrawRequest &other)
 Assignment operator. More...
 

Static Public Member Functions

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

Detailed Description

This class encapsulates all the information needed to fulfill a request to draw an object or part of an object.

This class is used by the draw methods of MPxSurfaceShapeUI derived objects.

The draw request should be created in the overridden MPxSurfaceShapeUI::getDrawRequests method. Once created the appropriate "set" methods of this class should be used to define what is being requested. Then the request should be placed on the draw reqeust queue using MDrawRequestQueue::add.

When your request gets processed by maya, your overriden MPxSurfaceShape::draw method will get called with your request. Use the query methods of this class to determine what to draw.

You create a draw request using the method MDrawInfo::getPrototype. A draw request automatically picks up certain information (listed below) upon its creation. So you don't have to set any of this information unless you want to change it.

Information automatically set by MDrawInfo::getPrototype :

  • path path to object to be drawn
  • view view to draw in
  • matrix world matrix for object
  • display appearance how object should be drawn
  • display status active, dormant etc.

The draw token is an integer value which you can use to specify what is to be drawn. This is object specific and so you should define an enum with the information you require to decide what is being drawn in your MPxSurfaceShapeUI::draw method.

Here is an example of draw token values for a polygonal mesh object as defined in an MPxSurfaceShapeUI derived class.

// Draw Tokens
//
enum {
kDrawVertices, // component token
kDrawWireframe,
kDrawWireframeOnShaded,
kDrawSmoothShaded,
kDrawFlatShaded,
kLastToken
};

This method is obsolete. [from before Maya 2016]

Deprecated:
Use MHWRender::MRenderItem and MHWRender::MPxGeometryOverride instead for Viewport 2.0 support.
Examples:
gpuCache/gpuCacheShapeNode.cpp, and gpuCache/gpuCacheShapeNode.h.

Constructor & Destructor Documentation

MDrawRequest ( const MDrawRequest other)

Copy constructor.

Parameters
[in]othervalue to copy

Member Function Documentation

MObject component ( ) const

An optional component.

If set draw the components that are specified, otherwise draw all components of this type for the object.

void setComponent ( MObject comp)

Set a component to be drawn.

Parameters
[in]compcomponent to be drawn
void setDrawData ( MDrawData data)

Set the object specific draw data.

Parameters
[in]datadraw data
Examples:
gpuCache/gpuCacheShapeNode.cpp.
void setDisplayStatus ( M3dView::DisplayStatus  status)

Set the state of object (active, dormant, etc.).

Parameters
[in]statusdisplay status
void setDisplayCulling ( bool  value)

Sets the state of the culling flag for the object.

Parameters
[in]valueculling value to be set
void setDisplayCullOpposite ( bool  value)

Sets the state of the culling flag for the object.

Parameters
[in]valueculling value to be set
void setDisplayStyle ( M3dView::DisplayStyle  style)

Sets how the object should be drawn (wireframe, shaded, etc.).

Parameters
[in]styledisplay style to set
Examples:
gpuCache/gpuCacheShapeNode.cpp.
int color ( M3dView::ColorTable  table) const

Returns the wireframe display color.

The color table specifies which of the 4 color planes to use. This table can be active, dormant, template, or background.

Parameters
[in]tablecolor table
void setColor ( int  value,
M3dView::ColorTable  table 
)

Sets the wireframe display color.

The color table specifies which of the 4 color planes to use. This table can be active, dormant, template, or background.

Parameters
[in]valueindex into the color table
[in]tablecolor table
Examples:
gpuCache/gpuCacheShapeNode.cpp.
MColor color ( ) const

Returns the RGBA wireframe display color.

Returns
The RGBA wireframe color
void setColor ( const MColor color)

Sets the RGBA wireframe display color.

Parameters
[in]colorThe RGBA wireframe color
void setMaterial ( MMaterial material)

Returns the shaded material.

Parameters
[in]materialthe material to set
Examples:
gpuCache/gpuCacheShapeNode.cpp.
void setIsTransparent ( bool  value)

Sets the transparency state of the object.

Parameters
[in]valuethe transparency value
Examples:
gpuCache/gpuCacheShapeNode.cpp.
void setDrawLast ( bool  value)

Specifies the order in which this object will be drawn.

Parameters
[in]valuedraw last flag
int token ( ) const

Returns the user-defined draw token for this request.

The token is used to identify a particular part of an object to draw. It is also used to distinguish draw requests generated by derived UI objects from those generated by base classes. It some cases, it provides a way of indicating that a component should be displayed without creating a component MObject.

Examples:
gpuCache/gpuCacheShapeNode.cpp.
void setToken ( int  value)

Set the user-defined draw token for this request.

The token is used to identify a particular part of an object to draw. It is also used to distinguish draw requests generated by derived UI objects from those generated by base classes. It some cases, it provides a way of indicating that a component should be displayed without creating a component MObject.

Examples:
gpuCache/gpuCacheShapeNode.cpp.
const MMatrix & matrix ( ) const

Returns the draw matrix.

This is typically the world matrix of the object, filled in by MDrawInfo::getPrototype(). Commonly this will be equal to multiPath().inclusiveMatrix() but in some circumstances will be a modified matrix, for example, when animation ghosts are being drawn.

Returns
The matrix associated with this draw request.
void setMatrix ( const MMatrix value)

Set the draw matrix.

Parameters
[in]valueThe matrix to set.
MDrawRequest & operator= ( const MDrawRequest other)

Assignment operator.

Parameters
[in]otherMDrawRequest object to copy from.
const char * className ( )
static

Returns the name of this class.

Returns
Name of this class.

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