//- // ========================================================================== // 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. // // ========================================================================== //+ // Description: // Demonstrates how to create your own custom image plane based on // Maya's internal image plane classes. This allows API users to // override the default Maya image plane behavior. This class works // like typical API nodes in that it can have a compute method and // can contain static attributes added by the API user. This // example class overrides the default image plane behavior and // allows users to add transparency to an image plane using the // transparency attribute on the node. Note, this code also // illustrates how to use MImage to control the floating point // depth buffer. When useDepthMap is set to true, depth is added // is added to the image such that half of the iamge is at the near // clip plane and the remaining half is at the far clip plane. // // Note, once the image plane node has been created it you must // attached it to the camera shape that is displaying the node. // Image planes are attached to cameras via the imagePlane message // attribute on the camera shape. To attach this example image // plane you should connect the image plane's message attribute to // the cameraShapes imagePlane attribute. Note, the imagePlane // attribute is a multi attribute and can hold references to // multiple image planes. // // For example, // string $imageP = `createNode customImagePlane` // connectAttr -f ($imageP + ".message") "perspShape.imagePlane[0]" // #include #include #include #include #include #include #include #include class customImagePlane : public MPxImagePlane { public: customImagePlane(); virtual MStatus loadImageMap( const MString &fileName, int frame, MImage &image ); virtual bool getInternalValueInContext( const MPlug&, MDataHandle&, MDGContext&); virtual bool setInternalValueInContext( const MPlug&, const MDataHandle&, MDGContext&); static void* creator(); static MStatus initialize(); static MTypeId id; // The IFF type id static MObject aTransparency; private: double fTransparency; }; MObject customImagePlane::aTransparency; customImagePlane::customImagePlane() : fTransparency( 0.0 ) { } bool customImagePlane::getInternalValueInContext( const MPlug &plug, MDataHandle &handle, MDGContext& context ) { if ( plug == aTransparency ) { handle.set( fTransparency ); return true; } return MPxImagePlane::getInternalValueInContext( plug, handle, context ); } bool customImagePlane::setInternalValueInContext( const MPlug &plug, const MDataHandle &handle, MDGContext &context) { if ( plug == aTransparency ) { fTransparency = handle.asDouble(); setImageDirty(); return true; } return MPxImagePlane::setInternalValueInContext( plug, handle, context ); } MStatus customImagePlane::loadImageMap( const MString &fileName, int frame, MImage &image ) { image.readFromFile(fileName); unsigned int width, height; image.getSize(width, height); unsigned int size = width * height; unsigned char *pixels = image.pixels(); unsigned int i; for ( i = 0; i < size; i ++, pixels += 4 ) { pixels[3] = (unsigned char)(pixels[3] * (1.0 - fTransparency)); } MPlug depthMap( thisMObject(), useDepthMap ); bool value; depthMap.getValue( value ); if ( value ) { float *buffer = new float[width*height]; unsigned int c, j; for ( c = i = 0; i < height; i ++ ) { for ( j = 0; j < width; j ++, c++ ) { if ( i > height/2 ) { buffer[c] = -1.0f; } else { buffer[c] = 0.0f; } } } image.setDepthMap( buffer, width, height ); delete [] buffer; } return MStatus::kSuccess; } MTypeId customImagePlane::id( 0x1A19 ); void* customImagePlane::creator() { return new customImagePlane; } MStatus customImagePlane::initialize() { MFnNumericAttribute nAttr; aTransparency = nAttr.create( "transparency", "tp", MFnNumericData::kDouble, 0 ); nAttr.setStorable(true); nAttr.setInternal(true); nAttr.setMin(0.0); nAttr.setMax(1.0); nAttr.setDefault(0.0); nAttr.setKeyable(true); addAttribute( aTransparency ); return MStatus::kSuccess; } // These methods load and unload the plugin, registerNode registers the // new node type with maya // MStatus initializePlugin( MObject obj ) { MStatus status; MFnPlugin plugin( obj, PLUGIN_COMPANY, "7.0", "Any"); status = plugin.registerNode( "customImagePlane", customImagePlane::id, customImagePlane::creator, customImagePlane::initialize, MPxNode::kImagePlaneNode ); if (!status) { status.perror("registerNode"); return( status ); } return( status ); } MStatus uninitializePlugin( MObject obj) { MStatus status; MFnPlugin plugin( obj ); status = plugin.deregisterNode( customImagePlane::id ); if (!status) { status.perror("deregisterNode"); return( status ); } return( status ); }