In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
-newWorkspace(-n) |
|
|
|
This specifies that a new workspace is being created. If a
workspace with this name already exists, the command will
fail. |
|
-openWorkspace(-o) |
|
|
|
Open the workspace. The workspace becomes the current
workspace. |
|
-active(-act) |
|
|
|
This flag is a synonym for -o/openWorkspace. |
|
-saveWorkspace(-s) |
|
|
|
Save the workspace. Workspaces are normally saved when Maya
exits but this flag will make sure that the data is flushed to
disk. |
|
-baseWorkspace(-bw) |
string |
|
|
A workspace may be based on another workspace. This means that
all the settings in the base workspace apply to this workspace
unless they are explicitly overridden. |
|
-listWorkspaces(-lw) |
|
|
|
Returns a list of all the currently defined workspace
names. |
|
-listFullWorkspaces(-lfw) |
|
|
|
Returns a list of the full path names of all the currently
defined workspaces. |
|
-list(-l) |
|
|
|
This option will list the current workspace directory. If a
path is specified for the "workspaceFile" then the contents of that
directory will be listed. Otherwise, the contents of the directory
set with the -dir flag will be listed. |
|
-directory(-dir) |
string |
|
|
This option will set the current workspace directory to the
path specified. When queried it will return the current workspace
directory. This directory is used as an initial directory for the
fileBrowser and is part of the search path used for locating
files. It should not be confused with the current working
directory as used by the pwd and chdir commands. When
the file browser is used, it will set this value to the last
location navigated to. |
|
-create(-cr) |
string |
|
|
Create a new directory. If the directory name is not a full
path name, it will be created as a subdirectory of the "current"
directory set with the -dir flag. |
|
-rootDirectory(-rd) |
|
|
|
Returns the root directory of the workspace. |
|
-objectType(-ot) |
string string |
|
|
This flag is obsolete. All default locations will be added to
the fileRules going forward. |
|
-objectTypeList(-otl) |
|
|
|
This flag is obsolete. This will now return the same results as
fileRuleList going forward. |
|
-objectTypeEntry(-ote) |
string |
|
|
This flag is obsolete. This will now return the same as
fileRuleEntry. |
|
-fileRule(-fr) |
string string |
|
|
Set the default location for a file. The first parameter is the
fileRule name(scenes, images, etc) and the second is the location.
When queried, it returns a list of strings. The elements of the
returned list alternate between fileRule names and the
corresponding location. There is typically one file rule for each
available translator. Environment variables are supported. You can
set multiple path for the file rule by separating them with
semicolons (;) on Windows and colons(:) on MacOSX and Linux. Note
that whitespace at the beginning and end of each item in the
separated sequence is significant and will be included as part of
the path name (which is not usually desired unless the pathname
does actually start or end with spaces). A valid filerule name
cannot contain multiple byte characters. |
|
-fileRuleList(-frl) |
|
|
|
Returns a list of the currently defined file rules. |
|
-fileRuleEntry(-fre) |
string |
|
|
Return the location for the given fileRule. |
|
-removeFileRuleEntry(-rfr) |
string |
|
|
Remove the given file rule from the specified workspace. If the
workspace name is not specified, the given file rule will be
removed from the current workspace. |
|
-renderType(-rt) |
string string |
|
|
This flag is obsolete. All default render types will be added
to fileRules going forward. |
|
-renderTypeList(-rtl) |
|
|
|
This flag is obsolete, use fileRuleList going forward. |
|
-renderTypeEntry(-rte) |
string |
|
|
This flag is obsolete, use fileRuleEntry going forward |
|
-variable(-v) |
string string |
|
|
Set or query the value of a project variable. Project variables
are used when expanding names. See the -en/expandName flag
below. |
|
-variableList(-vl) |
|
|
|
Return a list of all variables in the workspace. |
|
-variableEntry(-ve) |
string |
|
|
Given a variable name, will return its value. |
|
-removeVariableEntry(-rve) |
string |
|
|
Remove the given variable from the specified workspace. If the
workspace name is not specified, the given variable will be removed
from the current workspace. |
|
-shortName(-sn) |
|
|
|
Query the short name of the workspace. |
|
-fullName(-fn) |
|
|
|
Return the full name of the workspace. |
|
-expandName(-en) |
string |
|
|
Query for the full path location of a filename using the
current workspace definition. The path may be a project relative
file name, a full path name or a variable name. The return value is
always a full path name. If the path is an empty string, the return
value will be the project root directory. Variable expansion is
supported, and will consider both variables defined in the
workspace as well as environment variables. There are three formats
supported for expanding variable names: %variableName%,
$variableName, ${variableName}. Maya will first attempt to find
matching variables defined in the current workspace, then search
for a matching environment variable. The tilde character ('~') is
also supported. If a tilde is located at the beginning of a
variable, Maya will only consider and expand environment variables,
and will leave the tilde in the expanded result. On linux platforms
only, a tilde can be used to expand a user's home directory, using
the form ~username, ~, or ~/. When specified as ~username, it will
be replaced with the corresponding user's home directory. When
specified as ~ or ~/, it will be replaced with the value of the
HOME environment variable. |
|
-projectPath(-pp) |
string |
|
|
Convert filePath passed as argument to a filename that is
relative to the project root directory (if possible) and return it.
If the filePath is not under the project root directory, a full
path name will be returned. |
|
-update(-u) |
|
|
|
This flag reads all the workspace definitions from the project
directory. It is used by Maya at startup time to find the available
workspaces. |
|
-updateAll(-ua) |
|
|
|
This flag is a synonym for -u/update. |
|
-filter(-f) |
|
|
|