#ifndef _pointOnSubdNode #define _pointOnSubdNode // //- // ========================================================================== // 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 is provided for use exclusively by You. You have the right // to use, modify, and incorporate this Data into other products for // purposes authorized by the Autodesk software license agreement, // without fee. // // 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. // // ========================================================================== //+ // File: pointOnSubdNode.h // // Dependency Graph Node: pointOnSubd // // pointOnSubdNode // // Produces dependency graph node pointOnSubd // // This node is a simple example of how to query subdivision surface as an // input to a dependency node. This node takes a subdivision surface and a // parameter point on subdivision surface and outputs the position and the // normal of the surface at that point. // // One of the inputs for this node is called "subd". Subdivision surface // shape nodes ("subdiv") have two compatible output attributes that you // can use as inputs for pointOnSubd node - outSubdiv and worldSubdiv. // // Another four numerical inputs are needed to specify the parameter point // on the subdivision surface. The two integer values ("faceFirst" and // "faceSecond") specify a face. These two values are the same ones that // you see as a part of the selection description when you select a // subdivision surface face. The two floating point values ("uValue" and // "vValue") specify the position within that face. // // A boolean attribute "relative" specifies if the "uValue" and "vValue" // are given in the 0-1 range ("relative" is true) or in the U-V range of // the specified subdivision surface face ("relative" is false). // // To run this example, create a subdivision surface (converting from a // polygon, for example), create another piece of geometry (NURBS cone, for // example) and group the subdivision surface and the other geometry. Your // other geometry should be oriented Y-up. Now, select the other geometry, // followed by a single face on the subdivision surface. A face at any // level is available. With both of those items selected, type: // // connectObjectToPointOnSubd // // and the object will "stick" the the middle of the subdivision surface // face. You can position it elsewhere using the attribute editor for the // newly created pointOnSubd node and changing the U and V parameters. // // An actual MEL running example is provided in the // "connectObjectToPointOnSubd.mel" script file. You need to cut and // paste into the script editor and run it. #include #include #include class pointOnSubd : public MPxNode { public: pointOnSubd(); virtual ~pointOnSubd(); virtual MStatus compute( const MPlug& plug, MDataBlock& data ); static void* creator(); static MStatus initialize(); public: // There needs to be a MObject handle declared for each attribute that // the node will have. These handles are needed for getting and setting // the values later. // static MObject aSubd; static MObject aFaceFirst; static MObject aFaceSecond; static MObject aRelativeUV; static MObject aU; static MObject aV; static MObject aPoint; static MObject aPointX; static MObject aPointY; static MObject aPointZ; static MObject aNormal; static MObject aNormalX; static MObject aNormalY; static MObject aNormalZ; // The typeid is a unique 32bit indentifier that describes this node. // It is used to save and retrieve nodes of this type from the binary // file format. If it is not unique, it will cause file IO problems. // static MTypeId id; }; #endif