記号パス名

MAXScript に指定するファイル名の任意の場所に、 $<name> という形式で記号パス名を使用することができます。

この機能は 3ds Max 4 で追加され、3ds Max 9 で大幅に拡張されました。

以下の例で MAXScript に指定するファイル名は、「 $ 」で始まり、下記の記号ディレクトリ名のいずれかが続きます。

次の記号名が認識されます。

インデックス	記号名	ディレクトリ
1	$max	メインの MAX 実行可能ディレクトリ
2	$maps	マップディレクトリ構成内の最初のディレクトリ*
3	$scenes	3ds Max のシーンディレクトリ
4	$fonts	フォントディレクトリ
5	$imports	ファイルの読み込み元ディレクトリ
6	$exports	ファイルの書き出し先ディレクトリ
7	$sounds	サウンドディレクトリ
8	$matlibs	マテリアルライブラリディレクトリ
9	$scripts	スクリプトディレクトリ
10	$startupScripts	自動ロードのスタートアップスクリプトディレクトリ
11	$plugins	プラグインディレクトリ構成内の最初のディレクトリ*
12	$plugcfg	プラグイン構成ディレクトリ
13	$images	イメージディレクトリ
14	$ui	ユーザインタフェースファイルディレクトリ
15	$macroScripts	UI ディレクトリ内の macroScripts
16	$web	Web ダウンロード用ディレクトリ
17	$temp	システムの一時ディレクトリ
18	$renderPresets	レンダリングプリセットディレクトリ
19	$help	ヘルプファイルディレクトリ
20	$expressions	関数ディレクトリ
21	$previews	プレビューディレクトリ
22	$maxstart	MAXSTART.MAX のディレクトリ
23	$vpost	ビデオポストディレクトリ
24	$drivers	ドライバディレクトリ
25	$autoback	自動バックアップディレクトリ
26	$marketDefaults	各市場の既定値のディレクトリ
27	$icons	アイコンディレクトリ
28	$maxSysIcons	システムアイコンディレクトリ
29	$renderOutput	レンダリング出力ディレクトリ
30	$animation	アニメーションディレクトリ
31	$archives	アーカイブディレクトリ
32	$photometrics	フォトメトリックファイルディレクトリ
33	$renderAssets	レンダリングアセットディレクトリ
34	$userScripts	ユーザスクリプトディレクトリ
35	$userMacros	ユーザマクロスクリプトディレクトリ
36	$userStartupScripts	ユーザスタートアップディレクトリ
37	$userIcons	ユーザアイコンディレクトリ
38	$maxData	Max データ(ルート)ディレクトリ
39	$downloads	ダウンロードディレクトリ
40	$proxies	ビットマッププロキシディレクトリ

これらは GetDir() および SetDir() メソッドの引数である 3ds MAX システムディレクトリの filetype_names(「#」で始まる)とよく似ていることに注意してください。

以下の例では、現在の 3ds Max スクリプトディレクトリにある「foo.ms」というファイルを開きます。

例:

fileIn "$scripts\foo.ms"

3ds Max 9 以降では、 $maps および $plugins 記号パス名は、インデックスも指定できます。以下の例では、インデックス付きのディレクトリを使用しています。

例:

"$maps[2]\\mybitmap.tga"

インデックスを指定しないと、マップに対応する最初のプラグインパスが使用されます。

SymbolicPaths 構造体

3ds Max 9 以降では、SymbolicPaths 構造体には、既存の記号パスにアクセスするメソッドと、新しい記号パスを定義するメソッドがあります。

symbolicPaths.numPaths()

記号パス名の数を返します。これには、システムパスとユーザ定義のパス名の両方が含まれます。

symbolicPaths.getPathName<index>

インデックス付きの記号パス名を返します。

例:

for i =1 to symbolicPaths.numPaths() do
format "% : %\n" i (symbolicPaths.getPathName i)

symbolicPaths.isPathName <string>

文字列が記号パス名に対応する場合には true、対応しない場合には false を返します。

例:

symbolicPaths.isPathName "$maps"
true
symbolicPaths.isPathName "$map"
false

symbolicPaths.getPathValue {<index> | <string>}

指定の記号パス名に関連するパスを返します(インデックスまたは名前文字列で指定)。

例:

symbolicPaths.getPathValue 2
"C:\Program Files\Autodesk\3ds Max 2012\maps"
symbolicPaths.getPathValue"$maps"
"C:\Program Files\Autodesk\3ds Max 2012\maps"

symbolicPaths.numUserPaths()

ユーザ定義の記号パス名の数を返します。

symbolicPaths.getUserPathName <index>

インデックス付きのユーザ定義の記号パス名を返します。

symbolicPaths.isUserPathName <string>

文字列がユーザ定義の記号パス名に対応する場合には true、対応しない場合には false を返します。

symbolicPaths.getUserPathValue {<index> | <string>}

指定のユーザ定義の記号パス名に関連付けられたパスを返します。

symbolicPaths.setUserPathValue {<index> | <string>} <filepath>

指定のユーザ定義の記号パス名に関連付けられたパスを設定します。

symbolicPaths.addUserPath <string> <filepath>

ユーザ定義の記号パス名とパスを追加します。

symbolicPaths.removeUserPath {<index> | <string>}

ユーザ定義の記号パス名を削除します。

symbolicPaths.expandFileName <filename>

拡張ファイル名を返します。

例:

symbolicPaths.numUserPaths() --check foruser path- none by default
0
symbolicPaths.addUserPath "$test" "c:\\test" --define new user path
OK
symbolicPaths.numUserPaths() --check foruser path- there is one!
1
symbolicPaths.isUserPathName "$test" --is a user symbolic path?
true
--See if $temp is a user symbolic path.
--NOTE that $temp is aSYSTEMsymbolic path,
--but not aUSERsymbolic path:
symbolicPaths.isUserPathName "$temp"
false
symbolicPaths.getUserPathName 1 --get the name of the first path
"$test"
symbolicPaths.getUserPathValue 1 --get the first path
"c:\test"
symbolicPaths.getUserPathValue "$test" --get the path by name
"c:\test"
symbolicPaths.setUserPathValue "$test" "c:\\another\\path" --change
OK
symbolicPaths.getUserPathValue "$test" --see if itchangeg?
"c:\another\path"
symbolicPaths.expandFileName "$test\\somefile.txt" --expand a path
"c:\another\path\somefile.txt"
symbolicPaths.removeUserPath "$test" --remove the user path
OK
symbolicPaths.numUserPaths() --there are no user paths left
0

記号パス名

SymbolicPaths 構造体

関連事項