// =========================================================================== // Copyright 2018 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. // =========================================================================== // // // Creation Date: 24 April 1997 // // Description: // This script provides an option box dialog for the pointConstraint command. // // Input Arguments: // boolean showOptionBox true - show the option box dialog // false - just execute the command // // // Procedure Name: // setOptionVars // // Description: // Initialize the option values. // // Input Arguments: // Whether to set the options to default values. // // Return Value: // None. // proc setOptionVars(int $forceFactorySettings) { // weight // if ($forceFactorySettings || !`optionVar -exists pointConstraintWeight`) { optionVar -floatValue pointConstraintWeight 1.0; } // offset values // if ($forceFactorySettings || !`optionVar -exists ptConstOffsetX`) { optionVar -floatValue ptConstOffsetX 0.0; } if ($forceFactorySettings || !`optionVar -exists ptConstOffsetY`) { optionVar -floatValue ptConstOffsetY 0.0; } if ($forceFactorySettings || !`optionVar -exists ptConstOffsetZ`) { optionVar -floatValue ptConstOffsetZ 0.0; } // maintain existing offset // if ($forceFactorySettings || !`optionVar -exists ptConstMaintainOffset`) { optionVar -intValue ptConstMaintainOffset 0; } // constraint axes // if ($forceFactorySettings || !`optionVar -exists pointConstraintAxisX`) { optionVar -intValue pointConstraintAxisX true; } if ($forceFactorySettings || !`optionVar -exists pointConstraintAxisY`) { optionVar -intValue pointConstraintAxisY true; } if ($forceFactorySettings || !`optionVar -exists pointConstraintAxisZ`) { optionVar -intValue pointConstraintAxisZ true; } // AnimLayer if ($forceFactorySettings || !`optionVar -exists constraintAnimLayer`) { optionVar -stringValue constraintAnimLayer ""; } if ($forceFactorySettings || !`optionVar -exists putAnimLayerToOverride`) { optionVar -intValue putAnimLayerToOverride true; } } // // Procedure Name: // pointConstraintSetup // // Description: // Update the state of the option box UI to reflect the option values. // // Input Arguments: // parent - Top level parent layout of the option box UI. // Required so that UI object names can be // successfully resolved. // // forceFactorySettings - Whether the option values should be set to // default values. // // Return Value: // None. // global proc pointConstraintSetup(string $parent, int $forceFactorySettings) { // Retrieve the option settings // setOptionVars($forceFactorySettings); setParent $parent; // Query the optionVar's and set the values into the controls. // weight // floatSliderGrp -edit -value `optionVar -query pointConstraintWeight` pointConstraintWeight; // Offset values // float $tx = `optionVar -query ptConstOffsetX`; float $ty = `optionVar -query ptConstOffsetY`; float $tz = `optionVar -query ptConstOffsetZ`; if (`optionVar -query ptConstMaintainOffset`) { checkBoxGrp -edit -value1 1 pointConstraintMaintainWidget; floatFieldGrp -edit -enable 0 offsetField; } else { checkBoxGrp -edit -value1 0 pointConstraintMaintainWidget; floatFieldGrp -edit -enable 1 offsetField; } floatFieldGrp -e -v1 $tx -v2 $ty -v3 $tz offsetField; // AnimLayer string $animLayer = `optionVar -query constraintAnimLayer`; optionMenuGrp -edit -select 1 pointConstraintAnimLayerWidget; if( size( $animLayer ) > 0 ) { if( size( `ls $animLayer` ) > 0 ) { if( `objectType $animLayer` == "animLayer" ) { optionMenuGrp -edit -value $animLayer pointConstraintAnimLayerWidget; } } } int $overrideAnimLayer = `optionVar -query putAnimLayerToOverride`; checkBoxGrp -edit -value1 $overrideAnimLayer pointConstraintOverrideAnimLayer; // Axis values // int $axisX = `optionVar -query pointConstraintAxisX`; int $axisY = `optionVar -query pointConstraintAxisY`; int $axisZ = `optionVar -query pointConstraintAxisZ`; // if all axes are on, select the all box and dim the individual axes if ($axisX && $axisY && $axisZ) { checkBoxGrp -edit -value1 true axesAll; checkBoxGrp -edit -value1 false -value2 false -value3 false axesXYZ; } // otherwise just select those boxes corresponding to 'on' axes else { checkBoxGrp -edit -value1 false axesAll; checkBoxGrp -edit -value1 $axisX -value2 $axisY -value3 $axisZ axesXYZ; } } // // Procedure Name: // pointConstraintCallback // // Description: // Update the option values with the current state of the option box UI. // // Input Arguments: // parent - Top level parent layout of the option box UI. Required so // that UI object names can be successfully resolved. // // doIt - Whether the command should execute. // // Return Value: // None. // global proc pointConstraintCallback(string $parent, int $doIt) { setParent $parent; // Set the optionVar's from the control values, and then // perform the command. // weight // optionVar -floatValue pointConstraintWeight `floatSliderGrp -query -value pointConstraintWeight`; // maintain offset // optionVar -intValue ptConstMaintainOffset `checkBoxGrp -query -value1 pointConstraintMaintainWidget`; // Offset values // optionVar -floatValue ptConstOffsetX `floatFieldGrp -query -v1 offsetField`; optionVar -floatValue ptConstOffsetY `floatFieldGrp -query -v2 offsetField`; optionVar -floatValue ptConstOffsetZ `floatFieldGrp -query -v3 offsetField`; // AnimLayer if( `optionMenuGrp -query -select pointConstraintAnimLayerWidget` > 1 ) { optionVar -stringValue constraintAnimLayer `optionMenuGrp -query -value pointConstraintAnimLayerWidget`; } else { // First Item Selected, None // Save an empty field in the fconfig file optionVar -stringValue constraintAnimLayer ""; } optionVar -intValue putAnimLayerToOverride `checkBoxGrp -q -value1 pointConstraintOverrideAnimLayer`; // Axis values // // Either the 'All' box is checked (and so all axes are on) ... if ( `checkBoxGrp -query -value1 axesAll` ) { optionVar -intValue pointConstraintAxisX true; optionVar -intValue pointConstraintAxisY true; optionVar -intValue pointConstraintAxisZ true; } else { // ... Or only those axes specifically selected are on optionVar -intValue pointConstraintAxisX `checkBoxGrp -query -value1 axesXYZ`; optionVar -intValue pointConstraintAxisY `checkBoxGrp -query -value2 axesXYZ`; optionVar -intValue pointConstraintAxisZ `checkBoxGrp -query -value3 axesXYZ`; } if ($doIt) { performPointConstraint 0; addToRecentCommandQueue "performPointConstraint 0" "PointConstraint"; } } // // Procedure Name: // pointConstraintOptions // // Description: // Construct the option box UI. Involves accessing the standard option // box and customizing the UI accordingly. // // Input Arguments: // None. // // Return Value: // None. // proc pointConstraintOptions() { // Name of the command for this option box. // string $commandName = "pointConstraint"; // Build the option box actions. // string $callback = ($commandName + "Callback"); string $setup = ($commandName + "Setup"); // Get the option box. // string $layout = getOptionBox(); setParent $layout; // Pass the command name to the option box. // setOptionBoxCommandName($commandName); // Activate the default UI template. // setUITemplate -pushTemplate DefaultTemplate; // Turn on the wait cursor. // waitCursor -state 1; tabLayout -scr true -tv false; string $parent = `columnLayout -adjustableColumn 1`; checkBoxGrp -label (uiRes("m_performPointConstraint.kMaintainOffset")) -label1 " " -annotation (uiRes("m_performPointConstraint.kMaintainOffsetAnnot")) -numberOfCheckBoxes 1 -cc ("floatFieldGrp -edit -enable (! #1) offsetField;") pointConstraintMaintainWidget; floatFieldGrp -label (uiRes("m_performPointConstraint.kOffset")) -numberOfFields 3 offsetField; // AnimLayer field string $lLayers[] = `ls -type animLayer`; optionMenuGrp -label (uiRes("m_performPointConstraint.kAnimLayer")) pointConstraintAnimLayerWidget; menuItem -label (uiRes("m_performPointConstraint.kNone")); for ($layer in $lLayers) { menuItem -label $layer; } checkBoxGrp -label (uiRes("m_performPointConstraint.kSetAnimLayerToOverride")) -annotation (uiRes("m_performPointConstraint.kSetAnimLayerToOverrideAnnot")) -numberOfCheckBoxes 1 pointConstraintOverrideAnimLayer; separator; // Constraint Axes Selection Boxes // // The 'axesAll' checkBoxGrp and the 'axesXYZ' checkBoxGrp are linked // such that when 'axesAll' is selected, all the 'axesXYZ' boxes are // unselected. And when any 'axesXYZ' box is selected the 'axesAll' // box is deselected. checkBoxGrp -numberOfCheckBoxes 1 -label (uiRes("m_performPointConstraint.kConstraintAxes")) -label1 (uiRes("m_performPointConstraint.kAll")) -onCommand ("checkBoxGrp -edit " + "-value1 false " + "-value2 false " + "-value3 false " + "axesXYZ") axesAll; checkBoxGrp -numberOfCheckBoxes 3 -label1 (uiRes("m_performPointConstraint.kX")) -label2 (uiRes("m_performPointConstraint.kY")) -label3 (uiRes("m_performPointConstraint.kZ")) -onCommand ("checkBoxGrp -edit " + "-value1 false " + "axesAll;") axesXYZ; separator; floatSliderGrp -label (uiRes("m_performPointConstraint.kWeight")) -field true -min 0.0 -max 1.0 pointConstraintWeight; // Turn off the wait cursor. // waitCursor -state 0; // Deactivate the default UI template. // setUITemplate -popTemplate; // 'Apply' button. // string $applyBtn = getOptionBoxApplyBtn(); button -edit -label (uiRes("m_performPointConstraint.kAddButton")) -command ($callback + " " + $parent + " " + 1) $applyBtn; // 'Save' button. // string $saveBtn = getOptionBoxSaveBtn(); button -edit -command ($callback + " " + $parent + " " + 0 + "; hideOptionBox") $saveBtn; // 'Reset' button. // string $resetBtn = getOptionBoxResetBtn(); button -edit -command ($setup + " " + $parent + " " + 1) $resetBtn; // Set the option box title. // setOptionBoxTitle (uiRes("m_performPointConstraint.kPointConstraintOptions")); // Customize the 'Help' menu item text. // setOptionBoxHelpTag( "Point" ); // Set the current values of the option box. // eval (($setup + " " + $parent + " " + 0)); // Show the option box. // showOptionBox(); } // // Procedure Name: // pointConstraintHelp // // Description: // Return a short description about this command. // // Input Arguments: // None. // // Return Value: // string. // proc string pointConstraintHelp() { // ******** Example // " Command: Extrude - create a surface using extrusion.\n" + // "Selection: curves and isoparms." return " Command: pointConstraint - \n" + "Selection: "; } // // Procedure Name: // assembleCmd // // Description: // Construct the command that will apply the option box values. // // Input Arguments: // None. // // Return Value: // None. // proc string assembleCmd() { string $cmd; setOptionVars(false); int $maintainOffset = `optionVar -query ptConstMaintainOffset`; float $tx = `optionVar -query ptConstOffsetX`; float $ty = `optionVar -query ptConstOffsetY`; float $tz = `optionVar -query ptConstOffsetZ`; // Axis values // // The axis values are inverted so that they represent // which axes to *skip* as opposed to which axes are on. int $axisX = !`optionVar -query pointConstraintAxisX`; int $axisY = !`optionVar -query pointConstraintAxisY`; int $axisZ = !`optionVar -query pointConstraintAxisZ`; float $weight = `optionVar -query pointConstraintWeight`; // AnimLayer string $animLayer = `optionVar -query constraintAnimLayer`; int $overrideAnimLayer = `optionVar -query putAnimLayerToOverride`; $cmd = "doCreatePointConstraintArgList 1 { " + "\"" + $maintainOffset + "\"" + ",\"" + $tx + "\"" + ",\"" + $ty + "\"" + ",\"" + $tz + "\"" + ",\"" + $axisX + "\"" + ",\"" + $axisY + "\"" + ",\"" + $axisZ + "\"" + ",\"" + $weight + "\"" + ",\"" + $animLayer + "\"" + ",\"" + $overrideAnimLayer + "\"" + " };"; return $cmd; } // // Procedure Name: // performPointConstraint // // Description: // Perform the pointConstraint command using the corresponding // option values. This procedure will also show the option box // window if necessary as well as construct the command string // that will invoke the pointConstraint command with the current // option box values. // // Input Arguments: // 0 - Execute the command. // 1 - Show the option box dialog. // 2 - Return the command. // // Return Value: // None. // global proc string performPointConstraint(int $action) { string $cmd = ""; switch ($action) { // Execute the command. // case 0: // Retrieve the option settings // setOptionVars(false); // Get the command. // $cmd = `assembleCmd`; // Execute the command with the option settings. // evalEcho($cmd); break; // Show the option box. // case 1: pointConstraintOptions; break; // Return the command string. // case 2: // Retrieve the option settings. // setOptionVars (false); // Get the command. // $cmd = `assembleCmd`; break; } return $cmd; }