#ifndef _MPxNode #define _MPxNode // //- // ========================================================================== // 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: MPxNode // // ***************************************************************************** // // CLASS DESCRIPTION (MPxNode) // // MPxNode is the the parent class for user defined // dependency nodes. A dependency node is an object that resides in the // dependency graph. It computes output attributes based on a set of input // attributes. When an input changes, the compute method is called for each // dependent output. // // The dependency graph is made up of nodes that have connections between // their attributes. When an attribute changes, recomputation propagates // through the graph until all affected values have been updated. // // When writing a dependency node, there is a very basic rule that should // be observed. The outputs should be calculated only using the values of // the inputs. All information about the world outside the node should // come from input attributes. If this rule is not observed, then // the results may be unpredictable. // // ***************************************************************************** #if defined __cplusplus // ***************************************************************************** // INCLUDED HEADER FILES #include #include #include #include #include #include #include #include #include // ***************************************************************************** // DECLARATIONS // ***************************************************************************** // CLASS DECLARATION (MPxNode) /// Base class for user defined dependency nodes. (OpenMaya) (OpenMayaMPx.py) /** Create user defined dependency nodes. */ #ifdef _WIN32 #pragma warning(disable: 4522) #endif // _WIN32 class MPlugArray; class OPENMAYA_EXPORT MPxNode { public: /// enum Type { /// kDependNode, /// kLocatorNode, /// kDeformerNode, /// kManipContainer, /// kSurfaceShape, /// kFieldNode, /// kEmitterNode, /// kSpringNode, /// kIkSolverNode, /// kHwShaderNode, /// kTransformNode, /// kObjectSet, /// kFluidEmitterNode, /// kImagePlaneNode, /// kParticleAttributeMapperNode, /// kLast }; /// MPxNode(); /// virtual ~MPxNode(); /// virtual void postConstructor(); /// virtual MStatus compute( const MPlug& plug, MDataBlock& dataBlock ); /// virtual bool getInternalValueInContext( const MPlug& plug, MDataHandle& dataHandle, MDGContext& ctx); /// virtual bool setInternalValueInContext( const MPlug& plug, const MDataHandle& dataHandle, MDGContext& ctx); /// virtual bool getInternalValue( const MPlug& plug, MDataHandle& dataHandle); /// virtual bool setInternalValue( const MPlug& plug, const MDataHandle& dataHandle); /// virtual int internalArrayCount( const MPlug& plug, const MDGContext& ctx) const; /// virtual void copyInternalData( MPxNode* ); /// virtual MStatus legalConnection( const MPlug& plug, const MPlug& otherPlug, bool asSrc, bool& isLegal ) const; /// virtual MStatus legalDisconnection( const MPlug& plug, const MPlug& otherPlug, bool asSrc, bool& isLegal ) const; /// virtual MStatus setDependentsDirty( const MPlug& plug, MPlugArray& plugArray); /// virtual MStatus connectionMade( const MPlug& plug, const MPlug& otherPlug, bool asSrc ); /// virtual MStatus connectionBroken( const MPlug& plug, const MPlug& otherPlug, bool asSrc ); /// virtual bool isPassiveOutput( const MPlug& plug ) const; /// virtual MStatus shouldSave( const MPlug& plug, bool& isSaving ); /// virtual MPlug passThroughToOne( const MPlug& plug ) const; /// virtual bool passThroughToMany( const MPlug& plug, MPlugArray& plugArray ) const; /// MTypeId typeId() const; /// MString typeName() const; /// MString name() const; /// virtual Type type() const; /// virtual bool isAbstractClass () const; /// MObject thisMObject() const; /// static MStatus addAttribute( const MObject & attr ); /// static MStatus inheritAttributesFrom( const MString & parentClassName ); /// static MStatus attributeAffects( const MObject & whenChanges, const MObject & isAffected ); /// MStatus setExistWithoutInConnections( bool flag ); /// bool existWithoutInConnections( MStatus* ReturnStatus = NULL ) const; /// MStatus setExistWithoutOutConnections( bool flag ); /// bool existWithoutOutConnections( MStatus* ReturnStatus = NULL ) const; // SCRIPT USE ONLY MDataBlock _forceCache( MDGContext& ctx=MDGContext::fsNormal ) { return forceCache(ctx); } void _setMPSafe ( bool flag ) { setMPSafe(flag); } // /// message attribute static MObject message; /// is historically interesting attribute static MObject isHistoricallyInteresting; /// caching attribute static MObject caching; /// state attribute static MObject state; protected: /// USE _forceCache() IN SCRIPT MDataBlock forceCache( MDGContext& ctx=MDGContext::fsNormal ); /// USE _setMPSafe() IN SCRIPT void setMPSafe ( bool flag ); /// MStatus setDoNotWrite ( bool flag ); /// bool doNotWrite( MStatus *ReturnStatus = NULL ) const; void* instance; private: static void initialSetup(); static const char* className(); static void* initClass; }; #ifdef _WIN32 #pragma warning(default: 4522) #endif // _WIN32 // ***************************************************************************** #endif /* __cplusplus */ #endif /* _MPxNode */