MSwatchRenderBase Class Reference
[OpenMayaRender - API module for rendering]

#include <MSwatchRenderBase.h>

Inheritance diagram for MSwatchRenderBase:

[legend]

Collaboration diagram for MSwatchRenderBase:

[legend]

List of all members.

---

Detailed Description

Swatch Render Base class.

A class providing an interface through which a plugin can implement a class to provide custom rendered images for swatches which are displayed in hypershade and the Attribute Editor.

By deriving from this class and implementing the doIteration function, swatches for nodes (having the required classification) can be custom rendered by the plugin.

The derived class needs to be registered with Maya using the interface provided by MSwatchRenderRegister. Please refer to documentation of MSwatchRenderRegister for more details.

To indicate that swatch for a certain node type will be generated by the plugin the classfication string of the node needs to contain the following string : "swatch/<swatch generator name>" The swatch generator name string should match the name used to register the swatch generator class.

Public Member Functions
	MSwatchRenderBase (MObject obj, MObject renderObj, int res)
	constructor
virtual	~MSwatchRenderBase ()
	destructor
virtual bool	doIteration ()
MObject	swatchNode () const
	returns the node for which the swatch is required to be generated
MObject	node () const
	returns the node used to compute the swatch
int	resolution () const
	returns the expected resolution of the swatch image
MImage &	image ()
	returns the swatch image

---

Constructor & Destructor Documentation

MSwatchRenderBase::MSwatchRenderBase	(	MObject	obj,
		MObject	renderObj,
		int	res
	)

constructor

Class constructor. Saves the Node object and image resolution in members for future use.

Parameters:

[in]	obj	The node object for which the swatch needs to be generated.
[in]	res	The expected resolution of the swatch image.

MSwatchRenderBase::~MSwatchRenderBase

(

)

[virtual]

destructor

Class destructor.

---

Member Function Documentation

bool MSwatchRenderBase::doIteration

(

)

[virtual]

Method called to do swatch image generation, derived classes needs to implement this.

Method called from the MSwatchRenderRegister for generation of swatch image. The doIteration function is called repeatedly (during idle events) until it returns true. Using this swatch image can be generated in stages.

This method should be overriden in derived classes which can compute the swatches in several steps.

Returns:

False as long as the swatch comutation is not completed.

Reimplemented in MHWShaderSwatchGenerator.

MObject MSwatchRenderBase::swatchNode

(

)

const [inline]

returns the node for which the swatch is required to be generated

This method returns the node for which the swatch is required to be generated.

MObject MSwatchRenderBase::node

(

)

const [inline]

returns the node used to compute the swatch

This method returns the node that is used to compute the swatch.

int MSwatchRenderBase::resolution

(

)

const [inline]

returns the expected resolution of the swatch image

This method returns the expected resolution of the swatch

MImage & MSwatchRenderBase::image

(

)

[inline]

returns the swatch image

This method returns the the render swatch as an image.