#include
<MPxModelEditorCommand.h>
List of
all members.
Detailed Description
Base class for editor creation commands.
MPxModelEditorCommand
is the base class for user defined model editor commands. This
command gives all of the flags and options of the modelEditor
command in addition to any user defined flags or behaviours. When
registering this command, use the
MFnPlugin::MFnPlugin::registerModelEditorCommand() method. A
MPx3dModelView is also required to be used with
MPxModelEditorCommand
and is specified when the MPxModelEditorCommand
is registered.
Constructor & Destructor Documentation
MPxModelEditorCommand::MPxModelEditorCommand |
( |
|
) |
|
MPxModelEditorCommand::~MPxModelEditorCommand |
( |
|
) |
[virtual] |
Member Function Documentation
MStatus
MPxModelEditorCommand::doEditFlags |
( |
|
) |
[virtual] |
This method is called when the command is called in edit mode.
This method should be overridden by panel commands to determine
which edit flags are set in conjunction with the argument parser
for this command. The argument parser for this command can be
obtained by calling the parser method. If the command is called
with both the edit flag and the query flag, then the query flag
will be ignored.
If the command returns MS::kUnknownParameter,
the flag is processed by the parent class.
- Returns:
-
MStatus
MPxModelEditorCommand::doQueryFlags |
( |
|
) |
[virtual] |
This method is called when the command is called in query mode.
This method should be overridden by panel commands to determine
which query flags are set in conjunction with the argument parser
for this command. The argument parser for this command can be
obtained by calling the parser method. If the command is called
with both the edit flag and the query flag, then the query flag
will be ignored.
If the command returns MS::kUnknownParameter,
the flag is processed by the parent class.
- Returns:
-
MStatus
MPxModelEditorCommand::appendSyntax |
( |
|
) |
[virtual] |
This method should be overridden to append syntax to the panel
command. The syntax object can be obtained by calling the syntax
method. The following flags cannot be used as user-defined flags as
they are reserved for edit and query: "-e", "-edit", "-q",
"-query".
- Returns:
-
bool
MPxModelEditorCommand::skipFlagForCreate |
( |
const MString & |
longFlag |
) |
[virtual] |
Returns true if the passed long flag name should be skipped
during the creation portion of the command.
- Parameters:
-
[in] |
longFlag |
The string containing the long flag name. |
- Returns:
- Return true if the flag shoiuld be skipped during
creation.
- Status Codes:
-
MStatus
MPxModelEditorCommand::setResult |
( |
bool |
result |
) |
|
This method should be called when the result of the panel
command is a boolean.
- Parameters:
-
[in] |
result |
the boolean result |
- Returns:
-
MStatus
MPxModelEditorCommand::setResult |
( |
int |
result |
) |
|
This method should be called when the result of the panel
command is an integer.
- Parameters:
-
[in] |
result |
the integer result |
- Returns:
-
MStatus
MPxModelEditorCommand::setResult |
( |
double |
result |
) |
|
This method should be called when the result of the panel
command is a double.
- Parameters:
-
[in] |
result |
the double result |
- Returns:
-
This method should be called when the result of the panel
command is a string.
- Parameters:
-
[in] |
result |
the string result |
- Returns:
-
This method should be called when the result of the panel
command is a string array.
- Parameters:
-
[in] |
result |
the string array result |
- Returns:
-
This method should be called when the result of the panel
command is a double array.
- Parameters:
-
[in] |
result |
the double array result |
- Returns:
-
This method should be called when the result of the panel
command is an integer array.
- Parameters:
-
[in] |
result |
the integer array result |
- Returns:
-
MString
MPxModelEditorCommand::editorCommandName |
( |
|
) |
const [virtual] |
Returns the name of editor command.
The user should override this method to return the name of their
model editor command. This method is called when the model editor
is being created and is used to be able to associate this command's
name with that model editor.
Currently this association is used by playblast to call the
appropriate plugin model editor command to provide information for
the (-cameraSetup) flag. An override for this method and an
override for the
doQueryFlags() method must be provided to support multiple
camera rendering via playblast.
Refer the the documentation on the modelEditor command for
further information about the -cameraSetup flag.
- Returns:
- The name of the editor command
MString
MPxModelEditorCommand::editorMenuScriptName |
( |
|
) |
const [virtual] |
Returns the name of the script that should get executed to
construct the menu for the editor. The script should take a string
argument that holds the name of the created editor.
If no script is passed, the created editor will not have a
menu.
- Returns:
- The name of the script
This method is called when the modelEditor is being created and
it can be overriden to allow the user to handle the allocation of
the modelView directly. Also, as this method exists on MPxModelEditorCommand,
the user has direct access to the command line flags in create mode
for the command (an example use would be to detect that a
-quadbuffer flag was passed on creating the view, and you could
then bring up the panel with quadbuffering enabled).
- Parameters:
-
[out] |
ReturnStatus |
return status |
- Status Codes:
-
- Returns:
-
- NULL - unable to create the modelView for this
command.
- pointer to modelView - modelView successfully
created.
Returns a pointer to the MPx3dModelView created by this command. If the
MPx3dModelView was not created, NULL may be
returned.
- Parameters:
-
|
ReturnStatus |
return status |
- Status Codes:
-
- Returns:
- Pointer to the created MPx3dModelView
MSyntax
MPxModelEditorCommand::syntax |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const [protected] |
USE _syntax() IN SCRIPT.
This method returns the syntax object of this panel command. The
syntax object can be appended to in an overridden version of the
appendSyntax method.
- Parameters:
-
[out] |
ReturnStatus |
return status |
- Returns:
- The syntax object
- Status Codes:
-
MArgParser
MPxModelEditorCommand::parser |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const [protected] |
USE _parser() IN SCRIPT.
This method returns the argument parser of this panel command.
The argument parser can be used in the overridden versions of
doEditFlags and doQueryFlags to determine which flags are set.
- Parameters:
-
[out] |
ReturnStatus |
return status |
- Returns:
- The argument parser
- Status Codes:
-