356 lines
11 KiB
C++
Executable File
356 lines
11 KiB
C++
Executable File
#ifndef _MDagMessage
|
|
#define _MDagMessage
|
|
//
|
|
//-
|
|
// ==========================================================================
|
|
// Copyright (C) 1995 - 2005 Alias Systems Corp. 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 Alias Systems Corp. ("Alias") and/or its
|
|
// licensors, which is protected by Canadian and US 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
|
|
// Alias.
|
|
//
|
|
// THE DATA IS PROVIDED "AS IS". ALIAS HEREBY DISCLAIMS ALL WARRANTIES RELATING
|
|
// TO THE DATA, INCLUDING, WITHOUT LIMITATION, ANY AND ALL EXPRESS OR IMPLIED
|
|
// WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND/OR FITNESS FOR A
|
|
// PARTICULAR PURPOSE. IN NO EVENT SHALL ALIAS BE LIABLE FOR ANY DAMAGES
|
|
// WHATSOEVER, WHETHER DIRECT, INDIRECT, SPECIAL, OR PUNITIVE, WHETHER IN AN
|
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, OR IN EQUITY,
|
|
// ARISING OUT OF ACCESS TO, USE OF, OR RELIANCE UPON THE DATA.
|
|
// ==========================================================================
|
|
//+
|
|
//
|
|
// CLASS: MDagMessage
|
|
//
|
|
// *****************************************************************************
|
|
//
|
|
// CLASS DESCRIPTION (MDagMessage)
|
|
//
|
|
// This class is used to register callbacks for Dag 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 <maya/MMessage.h>
|
|
#include <maya/MString.h>
|
|
|
|
// *****************************************************************************
|
|
|
|
// DECLARATIONS
|
|
|
|
// *****************************************************************************
|
|
|
|
// CLASS DECLARATION (MDagMessage)
|
|
|
|
class MDagPath;
|
|
|
|
/// Dependency graph messages
|
|
/**
|
|
*/
|
|
#ifdef _WIN32
|
|
#pragma warning(disable: 4522)
|
|
#endif // _WIN32
|
|
|
|
class OPENMAYA_EXPORT MDagMessage : public MMessage
|
|
{
|
|
public:
|
|
/// The type of DAG changed messages that have occurred
|
|
enum DagMessage {
|
|
/// an invalid message was used.
|
|
kInvalidMsg = -1,
|
|
/// a dummy enum used for looping through the message types
|
|
kParentAdded,
|
|
/// a parent was removed from a DAG node
|
|
kParentRemoved,
|
|
/// a child was added to a DAG node
|
|
kChildAdded,
|
|
/// a child was removed from a DAG node
|
|
kChildRemoved,
|
|
/// a child of a DAG node was reordered
|
|
kChildReordered,
|
|
/// a DAG node was instanced
|
|
kInstanceAdded,
|
|
/// a DAG node instance was removed
|
|
kInstanceRemoved
|
|
};
|
|
|
|
public:
|
|
|
|
|
|
// Parent added callback for all nodes
|
|
///
|
|
static MCallbackId addParentAddedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Parent added callback for a specified node
|
|
///
|
|
static MCallbackId addParentAddedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Parent removed callback for all nodes
|
|
///
|
|
static MCallbackId addParentRemovedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Parent removed callback for a specified node
|
|
///
|
|
static MCallbackId addParentRemovedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child added callback for all nodes
|
|
///
|
|
static MCallbackId addChildAddedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child added callback for a specified node
|
|
///
|
|
static MCallbackId addChildAddedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child removed callback for all nodes
|
|
///
|
|
static MCallbackId addChildRemovedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child removed callback for a specified node
|
|
///
|
|
static MCallbackId addChildRemovedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child reordered callback for all nodes
|
|
///
|
|
static MCallbackId addChildReorderedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Child reordered callback for a specified node
|
|
///
|
|
static MCallbackId addChildReorderedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Any Dag change callback for all nodes
|
|
///
|
|
static MCallbackId addDagCallback(
|
|
DagMessage msgType,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Any Dag change callback for a specified node
|
|
///
|
|
static MCallbackId addDagCallback(
|
|
MDagPath &dagPath,
|
|
DagMessage msgType,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Any DAG change callback with the DagMessage for all nodes
|
|
///
|
|
static MCallbackId addDagCallback(
|
|
DagMessage msgType,
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void *clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Any Dag change callback with the DagMessage for a specified node
|
|
///
|
|
static MCallbackId addDagCallback(
|
|
MDagPath &dagPath,
|
|
DagMessage msgType,
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Adds a Dag change callback for all known Dag change messages for
|
|
// all nodes.
|
|
///
|
|
static MCallbackId addAllDagChangesCallback(
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Adds a Dag change callback for all known Dag change messages for
|
|
// the specified node.
|
|
///
|
|
static MCallbackId addAllDagChangesCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
|
|
|
|
// Adds a Dag change callback for the instancing of
|
|
// all the nodes in the DAG
|
|
///
|
|
static MCallbackId addInstanceAddedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
|
|
// Adds a Dag change callback for the instancing of
|
|
// the specified node.
|
|
///
|
|
static MCallbackId addInstanceAddedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Adds a Dag change callback for the instance removed/deleted of
|
|
// all the nodes in the DAG
|
|
///
|
|
static MCallbackId addInstanceRemovedCallback(
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
// Adds a Dag change callback for the instance removed of
|
|
// the specified node.
|
|
///
|
|
static MCallbackId addInstanceRemovedCallback(
|
|
MDagPath &dagPath,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
|
|
|
|
private:
|
|
static MCallbackId addDagCallback(
|
|
MDagPath *dagPath,
|
|
DagMessage msgType,
|
|
void (*func)( MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
|
|
static MCallbackId addDagCallback(
|
|
MDagPath *dagPath,
|
|
DagMessage msgType,
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
static MCallbackId addAllDagChangesCallback(
|
|
MDagPath *dagPath,
|
|
void (*func)( DagMessage msgType,
|
|
MDagPath &child,
|
|
MDagPath &parent,
|
|
void * clientData ),
|
|
void * clientData = NULL,
|
|
MStatus * ReturnStatus = NULL );
|
|
|
|
static const char* className();
|
|
};
|
|
|
|
#ifdef _WIN32
|
|
#pragma warning(default: 4522)
|
|
#endif // _WIN32
|
|
|
|
// *****************************************************************************
|
|
|
|
#endif /* __cplusplus */
|
|
#endif /* _MDagMessage */
|