workspace

Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

workspace [-active] [-baseWorkspace string] [-create string] [-directory string] [-expandName string] [-fileRule string string] [-fileRuleEntry string] [-fileRuleList] [-fullName] [-list] [-listFullWorkspaces] [-listWorkspaces] [-newWorkspace] [-objectType string string] [-objectTypeEntry string] [-objectTypeList] [-openWorkspace] [-projectPath string] [-renderType string string] [-renderTypeEntry string] [-renderTypeList] [-rootDirectory string] [-saveWorkspace] [-shortName] [-update] [-updateAll] [-variable string string] [-variableEntry string] [-variableList] [string]

workspace is undoable, queryable, and NOT editable.

The string argument reprents the workspace. If no workspace is specified then the current workspace is assumed.

Return value

In query mode, return type is based on queried flag.

Related

Flags

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.
-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)	string
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 (dxf, iges, etc) and the second is the location. When queried, it returns a list of strings. The elements of the list alternate between fileRule names and the corresponding location. There is typically one file rule for each available translator. Environment variables are supported. Maya will add the following defaults: scene, image, depth, iprImages, lights, renderScenes, sourceImages and textures.
-fileRuleList(-frl)
Returns a list of the currently defined file rules.
-fileRuleEntry(-fre)	string
Return the location for the given fileRule.
-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/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 the available variables.
-variableEntry(-ve)	string
Return the value of the given variable name
-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 the filename name. The name may be a project relative file name, or a full path name. If the name is an empty string, the return value will be the project directory. The return value is always a full path name.
-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 avaiable workspaces.
-updateAll(-ua)
This flag is a synonym for -u/update.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

  // Set the current workspace to "alphabet".
  workspace -o alphabet;

  // Save the currently workspace settings (for "alphabet").
  workspace -s;

  // Create a new Workspace named "newWorkspace".
  workspace -n newWorkspace;

  // Find the current workspace area.
  workspace -q -dir;
// Result : /h/userName/maya/projects/default

// Note that the "current working directory" as defined by the
// 'pwd' and 'chdir' commands is unrelated to the directories
// used by the workspace command.
//
pwd;
// Result : /usr/tmp

chdir "/tmp";
pwd;
// Result : /tmp
workspace -q -dir;
// Result : /h/userName/maya/projects/default

workspace -dir "/h/userName/maya/projects/commercial";
pwd;
// Result : /tmp