pointOnSubdNode/pointOnSubdNode.h
 
 
 
pointOnSubdNode/pointOnSubdNode.h
#ifndef _pointOnSubdNode
#define _pointOnSubdNode
//
//-
// ==========================================================================
// Copyright 1995,2006,2008 Autodesk, Inc. All rights reserved.
//
// Use of this software is subject to the terms of the Autodesk
// license agreement provided at the time of installation or download,
// or which otherwise accompanies this software in either electronic
// or hard copy form.
// ==========================================================================
//+

// 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 <maya/MPxNode.h>
#include <maya/MFnNumericAttribute.h>
#include <maya/MTypeId.h> 

 
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