Initial commit

Torque/SDK/lib/mayasdk6/include/maya/MRenderCallback.h

@@ -0,0 +1,101 @@
+
+#ifndef _MRenderCallback
+#define _MRenderCallback
+
+//
+//-
+// ==========================================================================
+// Copyright  (C)  Alias Systems,  a division  of  Silicon Graphics  Limited.
+// All rights  reserved.  These coded  instructions,  statements and computer
+// programs  contain  unpublished information  proprietary to  Alias Systems,
+// a  division  of  Silicon  Graphics  Limited,  which  is  protected by  the
+// Canadian  and  US federal copyright law and  may not be disclosed to third
+// parties or  copied  or  duplicated,  in  whole  or in part,  without prior
+// written  consent  of Alias Systems, a division of Silicon Graphics Limited
+// ==========================================================================
+//+
+//
+// CLASS:    MRenderCallback
+//
+// *****************************************************************************
+//
+// CLASS DESCRIPTION (MRenderCallback)
+//
+// This class is used to register callbacks to gain access to Maya's
+// rendering information during software rendering.  You can modify Maya's
+// shadow maps, RGB pixmap, and depth map to composite your own rendering
+// effects into Maya's rendering.
+//
+// To register callbacks, inherit from this class and override
+// renderCallback(), shadowCastCallback(), or postProcessCallback(). Any
+// number of these methods can be overridden by the callback. Then
+// register the callbacks by calling the addCallback() method.
+//
+// Each of the callback method gets passed a MRenderData which contains
+// the information.  MRenderData also provides utility methods for
+// converting between world space and screen space.  In the case of
+// shadowCastCallback, MRenderShadowData is provided and it also has
+// utility methods for converting between world space and shadow map
+// space.
+//
+// If there are callbacks registered, prior to shadow maps being written out,
+// shadowCastCallback() will be invoked with light information and a pointer
+// to the shadow map passed in. Then immediately after software rendering
+// completes, renderCallback() will be invoked with the rendering's dimension
+// info and image passed in.  Lastly, during post-processing, postProcessCallback()
+// will be invoked with the rendering's dimension and pointers to the rgb pixmap
+// and depthmap passed in.
+//
+// If multiple callbacks need to be registered, the order of invocation
+// can be set by adding each callback with a priority number, 0 being the
+// highest priority.
+//
+// *****************************************************************************
+
+#if defined __cplusplus
+
+#ifdef _WIN32
+#pragma warning(disable: 4522)
+#endif // _WIN32
+
+
+
+class MRenderShadowData;
+class MRenderData;
+
+/// Rendering Callbacks (OpenMayaRender)
+/**
+*/
+class OPENMAYARENDER_EXPORT MRenderCallback {
+public:
+	///
+                    MRenderCallback();
+	///
+	virtual			~MRenderCallback();
+
+    // Methods to override, return true on success
+	///
+    virtual bool    shadowCastCallback(const MRenderShadowData& data);
+	///
+    virtual bool    renderCallback(const MRenderData& data);
+	///
+    virtual bool    postProcessCallback(const MRenderData& data);
+
+	///
+    static void     addCallback(MRenderCallback*, int priority = 0);
+	///
+    static void     removeCallback(MRenderCallback*);
+
+private:
+    const void*     internalData;
+};
+
+#ifdef _WIN32
+#pragma warning(default: 4522)
+#endif // _WIN32
+
+// *****************************************************************************
+
+#endif /* __cplusplus */
+#endif /* _MRenderCallback */
+