dirmap

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

Synopsis

dirmap [-convertDirectory string] [-enable boolean] [-getAllMappings] [-getMappedDirectory string] [-mapDirectory string string] [-unmapDirectory string] string string

dirmap is undoable, queryable, and NOT editable.

Directories must both be absolute paths, and should be separated with forward slashes ('/'). The mapping is case-sensitive on all platforms. This command can be useful when moving projects to another machine where some textures may not be contained in the Maya project, or when a texture archive moves to a new location. This command is not necessary when moving a (self-contained) project from one machine to another - instead copy the entire project over and set the Maya project to the new location.

For one-time directory moves, if the command is enabled and the mapping configured correctly, when a scene is opened and saved the mapped locations will be reflected in the filenames saved with the file. To set up a permanent mapping the command should be enabled and the mappings set up in a script which is executed every time you launch Maya (userSetup.mel is sourced on startup). The directory mappings and enabled state are not preserved between Maya sessions. This command requires one "main" flag that specifies the action to take. Flags are:

-[m|um|gmd|gam|cd|en]

Return value

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

Flags

Long name (short name)	Argument types	Properties
-convertDirectory(-cd)	string
Convert a file or directory. Returns the name of the mapped file or directory, if the command is enabled. If the given string contains one of the mapped directories, the return value will have that substring replaced with the mapped one. Otherwise the given argument string will be returned. If the command is disabled the given argument is always returned. Checks are not made for whether the file or directory exists. If the given string is a directory it should have a trailing '/'.
-enable(-en)	boolean
Enable directory mapping. Directory mapping is off when you start Maya. If enabled, when opening Maya scenes, file texture paths (and other file paths) will be converted when the scene is opened. The -cd flag only returns mapped directories when -enable is true. Query returns whether mapping has been enabled.
-getAllMappings(-gam)
Get all current mappings. Returns string array of current mappings in format: [redirect1, replacement1, ... redirectN, replacementN]
-getMappedDirectory(-gmd)	string
Get the mapped redirected directory. The given argument must exactly match the first string used with the -mapDirectory flag.
-mapDirectory(-m)	string string
Map a directory - the first argument is mapped to the second. Neither directory needs to exist on the local machine at the time of invocation.
-unmapDirectory(-um)	string
Unmap a directory. The given argument must exactly match the argument used with the -mapDirectory flag.

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

dirmap -en true;
dirmap -m "/usr/maya/textures" "/share/store/textures";
dirmap -cd "/usr/maya/textures/characters/skin1.iff";
// Result: /share/store/textures/characters/skin1.iff"
dirmap -m "D:/mySoundfiles" "/usr/me/sounds";
dirmap -cd "D:/mySoundfiles/";
// Result: /usr/me/sounds/