dirmap

移動先: 概要 戻り値 フラグ. Python 例.

概要

dirmap( string string , [convertDirectory=string], [enable=boolean], [getAllMappings=boolean], [getMappedDirectory=string], [mapDirectory=[string, string]], [unmapDirectory=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

dirmap は 「元に戻す」が可能、「照会」が可能、「編集」が不可能 です。

ディレクトリは絶対パスであり、またスラッシュ（「/」）で区切る必要もあります。マッピングでは、すべてのプラットフォームで大文字と小文字が区別されます。 このコマンドは、Maya プロジェクト内に一部のテクスチャが含まれていない可能性がある別のマシンにプロジェクトを移動する場合、またはテクスチャ アーカイブを新しい場所に移動する場合に便利です。内蔵タイプのプロジェクトをあるマシンから別のマシンに移動する場合は必要ありません。この場合はプロジェクト全体をコピーし、Maya プロジェクトを新しい場所に設定してください。

1 回のディレクトリ移動では、コマンドが有効になってマッピングが正しく設定されると、シーンを開いてマップ場所を保存したときが、ファイルに保存したファイル名に反映されます。 永久マッピングをセット アップするには、コマンドを有効にし、Maya を起動するたびに実行されるスクリプト内でマッピングをセット アップする必要があります（userSetup.mel が起動時に読み込まれる）。 ディレクトリ マッピングと有効な状態は、Maya セッション間で保持されません。 このコマンドでは、1 つの「メイン」フラグで、実行するアクションを指定する必要があります。 メイン フラグは以下のとおりです。

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

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
enable(en)	boolean
ディレクトリ マッピングが有効になります。 ディレクトリ マッピングは、Maya の起動時にオフになります。ディレクトリ マッピングが有効な場合に Maya シーンを開くと、シーンを開いた際にファイル テクスチャ パス（とその他のファイル パス）が変換されます。-enable が true である場合、-cd フラグのみがマップ済みディレクトリを返します。 照会時には、マッピングが有効になっているかどうかが返されます。
mapDirectory(m)	[string, string]
ディレクトリがマップされます。最初の引数が次の引数にマップされます。 どちらのディレクトリも、起動時にローカル マシン上に存在する必要はありません。
unmapDirectory(um)	string
ディレクトリのマップを解除します。指定する引数は、-mapDirectory フラグで使用される引数とまったく同じである必要があります。
getMappedDirectory(gmd)	string
マップ済みディレクトリを入手します。指定する引数は、-mapDirectory フラグで使用される最初の文字列とまったく同じである必要があります。
getAllMappings(gam)	boolean
すべてのカレント マッピングを入手します。 カレント マッピングの文字配列が、 [redirect1, replacement1, ... redirectN, replacementN] というフォーマットで返されます。
convertDirectory(cd)	string
ファイルまたはディレクトリを変換します。 コマンドが有効な場合は、マップ済みファイルかディレクトリの名前が返されます。指定した文字列にマップ済みディレクトリが含まれている場合、戻り値には、マップ済みのもので置き換えられた従属文字列が含まれます。その他の場合は、指定した引数文字列が返されます。コマンドが無効な場合は、常に指定した引数が返されます。ファイルかディレクトリが存在するかどうかはチェックされません。指定した文字列がディレクトリである場合は、最後に「/」を付ける必要があります。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

cmds.dirmap( en=True )
cmds.dirmap( m=('/usr/maya/textures', '/share/store/textures') )
cmds.dirmap( cd='/usr/maya/textures/characters/skin1.iff' )
# Result: /share/store/textures/characters/skin1.iff"
cmds.dirmap( m=('D:/mySoundfiles', '/usr/me/sounds') )
cmds.dirmap( cd='D:/mySoundfiles/' )
# Result: /usr/me/sounds/