#ifndef _MDGMessage #define _MDGMessage // //- // ========================================================================== // Copyright (C) 1995 - 2006 Autodesk, Inc., and/or its licensors. All // rights reserved. // // The coded instructions, statements, computer programs, and/or related // material (collectively the "Data") in these files contain unpublished // information proprietary to Autodesk, Inc. ("Autodesk") and/or its // licensors, which is protected by U.S. and Canadian federal copyright law // and by international treaties. // // The Data may not be disclosed or distributed to third parties or be // copied or duplicated, in whole or in part, without the prior written // consent of Autodesk. // // The copyright notices in the Software and this entire statement, // including the above license grant, this restriction and the following // disclaimer, must be included in all copies of the Software, in whole // or in part, and all derivative works of the Software, unless such copies // or derivative works are solely in the form of machine-executable object // code generated by a source language processor. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. // AUTODESK DOES NOT MAKE AND HEREBY DISCLAIMS ANY EXPRESS OR IMPLIED // WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF // NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, // OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO // EVENT WILL AUTODESK AND/OR ITS LICENSORS BE LIABLE FOR ANY LOST // REVENUES, DATA, OR PROFITS, OR SPECIAL, DIRECT, INDIRECT, OR // CONSEQUENTIAL DAMAGES, EVEN IF AUTODESK AND/OR ITS LICENSORS HAS // BEEN ADVISED OF THE POSSIBILITY OR PROBABILITY OF SUCH DAMAGES. // ========================================================================== //+ // // CLASS: MDGMessage // // ***************************************************************************** // // CLASS DESCRIPTION (MDGMessage) // // This class is used to register callbacks for dependency graph messages. // There are 4 add callback methods which will add callbacks for the // following messages // Time change // Node Added // Node Removed // Connection made or broken // // A filter can be specified for node added/removed messages. The default // node type is "dependNode" which matches all nodes. // Each method returns an id which is used to remove the callback. // // To remove a callback use MMessage::removeCallback. // All callbacks that are registered by a plug-in must be removed by that // plug-in when it is unloaded. Failure to do so will result in a fatal error. // // ***************************************************************************** #if defined __cplusplus // ***************************************************************************** // INCLUDED HEADER FILES #include #include // ***************************************************************************** // DECLARATIONS class MTime; class MObject; class MPlug; #define kDefaultNodeType "dependNode" // ***************************************************************************** // CLASS DECLARATION (MDGMessage) /// Dependency graph messages. (OpenMaya) (OpenMaya.py) /** */ #if defined(_WIN32) #pragma warning(disable: 4522) #endif // _WIN32 class OPENMAYA_EXPORT MDGMessage : public MMessage { public: /// TimeChange callback static MCallbackId addTimeChangeCallback( MMessage::MTimeFunction func, void * clientData = NULL, MStatus * ReturnStatus = NULL ); /// ForceUpdate callback static MCallbackId addForceUpdateCallback( MMessage::MTimeFunction func, void * clientData = NULL, MStatus * ReturnStatus = NULL ); /// NodeAdded callback static MCallbackId addNodeAddedCallback( MMessage::MNodeFunction func, const MString& nodeType = kDefaultNodeType, void * clientData = NULL, MStatus * ReturnStatus = NULL ); /// NodeRemoved callback static MCallbackId addNodeRemovedCallback( MMessage::MNodeFunction func, const MString& nodeType = kDefaultNodeType, void * clientData = NULL, MStatus * ReturnStatus = NULL ); /// Connection callback static MCallbackId addConnectionCallback( MMessage::MPlugFunction func, void * clientData = NULL, MStatus * ReturnStatus = NULL ); private: static const char* className(); }; #if defined(_WIN32) #pragma warning(default: 4522) #endif // _WIN32 // ***************************************************************************** #endif /* __cplusplus */ #endif /* _MDGMessage */