MRenderingInfo Class Reference
[OpenMayaRender - API module for rendering]

#include <MRenderingInfo.h>

Collaboration diagram for MRenderingInfo:

Collaboration graph
[legend]

List of all members.


Detailed Description

Information to perform rendering into a hardware render target.

MRenderingInfo is a class which holds information about rendering into hardware render targets.

Examples:

D3DResourceManager.h, D3DViewportRenderer.cpp, D3DViewportRenderer.h, OpenGLViewportRenderer.cpp, and OpenGLViewportRenderer.h.


Public Member Functions

unsigned int originX () const
 Origin (x) of region to render to in pixels.
unsigned int originY () const
 Origin (y) of region to render to in pixels.
unsigned int width () const
 Width of region to render in pixels.
unsigned int height () const
 Height of region to render in pixels.
MViewportRenderer::RenderingAPI renderingAPI () const
 Native target rendering API.
float renderingVersion () const
 Native target rendering version.
const MDagPathcameraPath () const
 Current camera being used to render with.
const MRenderTargetrenderTarget () const
 Current render target.
const MMatrixviewMatrix () const
 Current view matrix.
const MMatrixprojectionMatrix () const
 Current projection matrix.

Friends

class MViewportRenderer
class MHardwareRenderer

Member Function Documentation

unsigned int MRenderingInfo::originX (  )  const

Origin (x) of region to render to in pixels.

Return the x coordinate in pixels of the origin of the region to render.

Returns:
X value.

unsigned int MRenderingInfo::originY (  )  const

Origin (y) of region to render to in pixels.

Return the y coordinate in pixels of the origin of the region to render.

Returns:
Y value.

unsigned int MRenderingInfo::width (  )  const

Width of region to render in pixels.

Return the width in pixels of the region to render.

Returns:
Width value.

unsigned int MRenderingInfo::height (  )  const

Height of region to render in pixels.

Return the width in pixels of the region to render

Returns:
Height value.

MViewportRenderer::RenderingAPI MRenderingInfo::renderingAPI (  )  const

Native target rendering API.

Return the native rendering API used for a render target. See MViewportRender::RenderingAPI for a list of possible api values that can be returned.

Returns:
Rendering API.
Examples:

float MRenderingInfo::renderingVersion (  )  const

Native target rendering version.

Return the native rendering API version used for a render target.

Returns:
Rendering version.

const MDagPath & MRenderingInfo::cameraPath (  )  const

Current camera being used to render with.

Return the dag path of the current camera being used for rendering. Information about the camera itself can be extracted via MFnCamera.

Returns:
Dag path to camera.
Examples:

const MRenderTarget & MRenderingInfo::renderTarget (  )  const

Current render target.

Return the current render target being used for rendering.

Returns:
Reference to render target.
Examples:

const MMatrix & MRenderingInfo::viewMatrix (  )  const

Current view matrix.

Return the current view matrix being used for rendering.

Returns:
View matrix.
Examples:

const MMatrix & MRenderingInfo::projectionMatrix (  )  const

Current projection matrix.

Return the current projection matrix being used for rendering. The projection matrix will be appropriate regardless of whether the caller is rendering into a OpenGL or a DirectX context, as each drawing API interprets projection matrices differently.

Returns:
Dag path to camera.
Examples:


Autodesk® Maya® 2009 © 1997-2008 Autodesk, Inc. All rights reserved. Generated with doxygen 1.5.6