//- // ========================================================================== // 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. // // ========================================================================== //+ /* This example demonstrates the FreePointTriad and Distance manipulators in the API. This example uses three classes to accomplish this task: First, a context command (moveManipContext) is provided to create instances of the context. Next, a custom selection context (MoveManipContext) is created to manage the rotation manipulator. Finally, the rotation manipulator is provided as a custom node class. Loading and unloading: ---------------------- The move manipulator context and tool button can be created with the following mel commands: moveManipContext; setParent Shelf1; toolButton -cl toolCluster -t moveManipContext1 -i1 "moveToolManip.xpm" moveManip; If the preceding commands were used to create the manipulator context, the following commands can destroy it: deleteUI moveManipContext1; deleteUI moveManip; If the plugin is loaded and unloaded frequently (eg. during testing), it is useful to make these command sequences into shelf buttons. How to use: ----------- Once the tool button has been created using the script above, select the tool button then click on an object. The move manipulator should appear at the center of the selected object and a distance manipulator should appear at the origin. Use the move manipulator to move the object, and the distance manipulator to control the scaling in Y direction. */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include // Manipulators #include #include class moveManip : public MPxManipContainer { public: moveManip(); virtual ~moveManip(); static void * creator(); static MStatus initialize(); virtual MStatus createChildren(); virtual MStatus connectToDependNode(const MObject &node); virtual void draw(M3dView &view, const MDagPath &path, M3dView::DisplayStyle style, M3dView::DisplayStatus status); MDagPath fDistanceManip; MDagPath fFreePointManip; public: static MTypeId id; }; MTypeId moveManip::id( 0x8001d ); moveManip::moveManip() { // The constructor must not call createChildren for user-defined // manipulators. } moveManip::~moveManip() { } void *moveManip::creator() { return new moveManip(); } MStatus moveManip::initialize() { MStatus stat; stat = MPxManipContainer::initialize(); return stat; } MStatus moveManip::createChildren() { MStatus stat = MStatus::kSuccess; fDistanceManip = addDistanceManip("distanceManip", "distance"); // The distance manip will extend in the y-direction. // MFnDistanceManip distanceManipFn(fDistanceManip); MPoint startPoint(0.0, 0.0, 0.0); MVector direction(0.0, 1.0, 0.0); distanceManipFn.setStartPoint(startPoint); distanceManipFn.setDirection(direction); fFreePointManip = addFreePointTriadManip("pointManip", "freePoint"); return stat; } MStatus moveManip::connectToDependNode(const MObject &node) { MStatus stat; // // This routine connects the distance manip to the scaleY plug on the node // and connects the translate plug to the position plug on the freePoint // manipulator. // MFnDependencyNode nodeFn(node); MPlug syPlug = nodeFn.findPlug("scaleY", &stat); MPlug tPlug = nodeFn.findPlug("translate", &stat); MFnDistanceManip distanceManipFn(fDistanceManip); distanceManipFn.connectToDistancePlug(syPlug); MFnFreePointTriadManip freePointManipFn(fFreePointManip); freePointManipFn.connectToPointPlug(tPlug); // // Manipulator transformations can be set by using methods on the base // class MFnTransform. To display the manipulator at a constant offset // from its natural position, change the value of the offset vector below. // MVector offset(0.0, 0.0, 0.0); freePointManipFn.setTranslation(offset, MSpace::kTransform); finishAddingManips(); MPxManipContainer::connectToDependNode(node); return stat; } void moveManip::draw(M3dView & view, const MDagPath & path, M3dView::DisplayStyle style, M3dView::DisplayStatus status) { // // Demonstrate how drawing can be overriden for manip containers - draw the // string "Stretch Me!" at the origin. // MPxManipContainer::draw(view, path, style, status); view.beginGL(); MPoint textPos(0, 0, 0); char str[100]; sprintf(str, "Stretch Me!"); MString distanceText(str); view.drawText(distanceText, textPos, M3dView::kLeft); view.endGL(); } ///////////////////////////////////////////////////////////// // // MoveManipContext // // This class is a simple context for supporting a move manipulator. // ///////////////////////////////////////////////////////////// class MoveManipContext : public MPxSelectionContext { public: MoveManipContext(); virtual void toolOnSetup(MEvent &event); virtual void toolOffCleanup(); // Callback issued when selection list changes static void updateManipulators(void * data); private: MCallbackId id1; }; MoveManipContext::MoveManipContext() { MString str("Plugin move Manipulator"); setTitleString(str); } void MoveManipContext::toolOnSetup(MEvent &) { MString str("Move the object using the manipulator"); setHelpString(str); updateManipulators(this); MStatus status; id1 = MModelMessage::addCallback(MModelMessage::kActiveListModified, updateManipulators, this, &status); if (!status) { MGlobal::displayError("Model addCallback failed"); } } void MoveManipContext::toolOffCleanup() { MStatus status; status = MModelMessage::removeCallback(id1); if (!status) { MGlobal::displayError("Model remove callback failed"); } MPxContext::toolOffCleanup(); } void MoveManipContext::updateManipulators(void * data) { MStatus stat = MStatus::kSuccess; MoveManipContext * ctxPtr = (MoveManipContext *) data; ctxPtr->deleteManipulators(); MSelectionList list; stat = MGlobal::getActiveSelectionList(list); MItSelectionList iter(list, MFn::kInvalid, &stat); if (MS::kSuccess == stat) { for (; !iter.isDone(); iter.next()) { // Make sure the selection list item is a depend node and has the // required plugs before manipulating it. // MObject dependNode; iter.getDependNode(dependNode); if (dependNode.isNull() || !dependNode.hasFn(MFn::kDependencyNode)) { MGlobal::displayWarning("Object in selection list is not " "a depend node."); continue; } MFnDependencyNode dependNodeFn(dependNode); MPlug rPlug = dependNodeFn.findPlug("translate", &stat); MPlug sPlug = dependNodeFn.findPlug("scaleY", &stat); if (rPlug.isNull() || sPlug.isNull()) { MGlobal::displayWarning("Object cannot be manipulated: " + dependNodeFn.name()); continue; } // Add manipulator to the selected object // MString manipName ("moveManip"); MObject manipObject; moveManip* manipulator = (moveManip *) moveManip::newManipulator(manipName, manipObject); if (NULL != manipulator) { // Add the manipulator // ctxPtr->addManipulator(manipObject); // Connect the manipulator to the object in the selection list. // if (!manipulator->connectToDependNode(dependNode)) { MGlobal::displayWarning("Error connecting manipulator to" " object: " + dependNodeFn.name()); } } } } } ///////////////////////////////////////////////////////////// // // moveManipContext // // This is the command that will be used to create instances // of our context. // ///////////////////////////////////////////////////////////// class moveManipContext : public MPxContextCommand { public: moveManipContext() {}; virtual MPxContext * makeObj(); public: static void* creator(); }; MPxContext *moveManipContext::makeObj() { return new MoveManipContext(); } void *moveManipContext::creator() { return new moveManipContext; } /////////////////////////////////////////////////////////////////////// // // The following routines are used to register/unregister // the context and manipulator // /////////////////////////////////////////////////////////////////////// MStatus initializePlugin(MObject obj) { MStatus status; MFnPlugin plugin(obj, PLUGIN_COMPANY, "3.0", "Any"); status = plugin.registerContextCommand("moveManipContext", &moveManipContext::creator); if (!status) { MGlobal::displayError("Error registering moveManipContext command"); return status; } status = plugin.registerNode("moveManip", moveManip::id, &moveManip::creator, &moveManip::initialize, MPxNode::kManipContainer); if (!status) { MGlobal::displayError("Error registering moveManip node"); return status; } return status; } MStatus uninitializePlugin(MObject obj) { MStatus status; MFnPlugin plugin(obj); status = plugin.deregisterContextCommand("moveManipContext"); if (!status) { MGlobal::displayError("Error deregistering moveManipContext command"); return status; } status = plugin.deregisterNode(moveManip::id); if (!status) { MGlobal::displayError("Error deregistering moveManip node"); return status; } return status; }