PathConfig 構造体

プロジェクト フォルダ

pathConfig.doProjectSetupSteps() 

新しいプロジェクトをセット アップするために必要なすべての手順(プロジェクト フォルダの指定やすべてのサブフォルダの作成など)を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。

pathConfig.doProjectSetupStepsUsingDirectory <ProjectPath> 	 

指定された ProjectPath を ルートとして、新しいプロジェクトをセット アップするために必要なすべての手順を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。

pathConfig.getCurrentProjectFolder() 

現在のプロジェクト フォルダを返します。

pathConfig.getCurrentProjectFolderPath() 

現在のプロジェクト フォルダ定義ファイル(*.MXP)を返します。

pathConfig.getProjectFolderPath <ProjectPath> 

指定されたプロジェクト フォルダのプロジェクト定義ファイルのファイル名(<ProjectPath>¥<ProjectName>.mxp)を返します。

pathConfig.getProjectSubDirectory <subdir_index> 

インデックスで指定されたプロジェクト サブディレクトリを返します。

--Print all Project Sub-Directories:
for i = 1 to pathConfig.getProjectSubDirectoryCount() do
format "%: %\n" i (pathConfig.getProjectSubDirectoryi)

pathConfig.getProjectSubDirectoryCount() 

プロジェクト サブディレクトリの数を返します。上の例を参照してください。

pathConfig.addProjectDirectoryCreateFilter <#directory_type> 

<directory_type> が次のいずれかであるプロジェクト ディレクトリ フィルタを追加します。

 #font | #Scene | #export | #import | #help | #expression | #preview | #image | #Sound | #plugcfg | #maxstart | #vpost | #drivers | #autoback | #matlib | #scripts | #startupScripts | #defaults | #renderPresets | #ui | #maxroot | #renderoutput | #animations | #archives | #Photometric | #renderassets | #userScripts | #userMacros | #userStartupScripts | #temp | #userIcons | #maxData | #downloads | #proxies 

pathConfig.removeAllProjectDirectoryCreateFilters() 

pathConfig.addProjectDirectoryCreateFilter() を使用して追加されたすべてのフィルタを削除します。

pathConfig.setCurrentProjectFolder <ProjectPath> 

現在のプロジェクト フォルダを指定されたパスに設定します。プロジェクト フォルダは 3ds Max のタイトル バーに表示され、即座に更新されます。

パスの操作、変換、および解決

pathConfig.appendPath <path1> <path2> 

2 個目の引数のファイル名を 1 個目の引数のパスに付加します。

pathConfig.appendPath "c:\\temp" "test.txt"
"c:\temp\test.txt"
pathConfig.appendPath "c:\\temp\\" "test"
"c:\temp\test"

pathConfig.convertPathToAbsolute <relative_path> 

相対パス引数(relative_path)を、プロジェクト ディレクトリを使用して絶対プロジェクト パスに変換します。

pathConfig.convertPathToAbsolute "meshes"
"C:\Documents and Settings\username\My Documents\3dsmax\meshes"

pathConfig.convertPathToLowerCase <path> 

パス引数を小文字に変換し、バックスラッシュを 1 つにします。

pathConfig.convertPathToLowerCase "C:\\Temp\Test/pATH"
"c:\temp\test\path"

pathConfig.convertPathToRelativeTo <path1> <path2> 

1 個目のパス引数を、2 個目のパス引数を基点とした相対パスに変換します。

pathConfig.convertPathToRelativeTo "C:\\Temp\\Test" "c:\\Program Files\\"
"..\Temp\Test"

pathConfig.convertPathToUnc <path> 

マッピングされたドライブ パスからの UNC パスを返します。

--If drive letter T: is mapped to a server called MyServer, then
pathConfig.convertPathToUnc "t:\\project"
"\\MyServer\projects"

mapPaths.getFullFilePath <filename> 

マップ パスを使用してファイル名を解決し、このファイルが見つかった場合には完全な修飾名を返します。

pathConfig.normalizePath <path> 

正規化したパス名を返します。

pathConfig.normalizePath "scenes/test.txt"
".\scenes\test.txt"

pathConfig.pathsResolveEquivalent <path1> <path2> 

2 つのパスを解決し、2 つのパスが同じ場所を指している(同等である)場合は true を返し、同等でない場合は false を返します。

pathConfig.pathsResolveEquivalent "scenes\\test.txt" "./scenes/test.txt"
true

pathConfig.resolvePathSymbols <path> 

パス記号を解決します。

pathConfig.resolveUNC SystemGlobal:resolveUNC false 

[基本設定](Preferences) > [ファイル](Files) にあるファイル パスを UNC に変換と同じ、プロパティの切り替えを指定します。(たとえば、M: が server1¥¥ にマッピングされている場合、M:¥file.txt を server1¥¥file.txt に変換するかどうかを設定します。

pathConfig.removePathLeaf <path> 

指定されたパスから最下位のリーフを取り除きます。

pathConfig.removePathLeaf "c:\\temp\\test"
"c:\temp"

pathConfig.removePathTopParent <path> 

指定されたパスから最上位の親を取り除きます。

pathConfig.removePathTopParent "c:\\temp\\test"
"temp\test"

pathConfig.stripPathToLeaf <path_or_filename> 

指定されたパスから、最後のサブディレクトリ名を返します。指定されたパスが完全なファイル名である場合は、ファイル名を返します。パスのファイル名に相当します。

pathConfig.stripPathToLeaf "C:\\temp\\test"
"test"
pathConfig.stripPathToLeaf "C:\\temp\\test\\"
""
pathConfig.stripPathToLeaf "C:\\temp\\test\\somefile.tga"
"somefile.tga"
--COMPARE:
filenamefrompath "C:\\temp\\test"
"test"
filenamefrompath "C:\\temp\\test\\"
""
filenamefrompath "C:\\temp\\test\\somefile.tga"
"somefile.tga"

pathConfig.stripPathToTopParent 

指定されたパスのルートを返します。

pathConfig.stripPathToTopParent "C:\\temp\\test\\test.tga"
"C:\"
pathConfig.stripPathToTopParent "\\\\SomeServer\\Projects\\Test"
"\\SomeServer"

is... クエリー メソッド

pathConfig.isAbsolutePath <path_string> 

引数が絶対パスの場合は true を返し、相対パスの場合は false を返します。このメソッドは、実在しないパスを指定しても正常に動作します。

pathConfig.isLegalPath <path_string> 

引数が有効なパス定義である場合は true を返し、無効なパスである場合は false を返します。このメソッドは正確さを解析するだけなので、実在しないパスを指定しても正常に動作します。

pathConfig.isLegalPath "c:\\" --legal path, existing
true
pathConfig.isLegalPath "z:\\path" --legal path, not existing
true
pathConfig.isLegalPath "zz:\\path" --illegal double drive letter!
false

pathConfig.isPathRootedAtBackslash <path> 

引数の最初の文字がバックスラッシュである場合は true を返し、それ以外の場合は false を返します。

--starts with backslash:
pathConfig.isPathRootedAtBackslash "\\machine\\c$"
true
--does not start with backslash:
pathConfig.isPathRootedAtBackslash "c:\\temp"
false

pathConfig.isPathRootedAtDriveLetter <path> 

引数の最初の文字がバックスラッシュである場合は false を返し、ドライブ文字である場合は true を返します。 pathConfig.isPathRootedAtBackslash() の反対です。

pathConfig.isProjectFolder<path> 

引数のパスが有効なプロジェクト フォルダのルートである場合は true を返し、そうでない場合は false を返します。

pathConfig.isRootPath <path> 

引数のパスがルートのパスである場合は true を返し、そうでない場合は false を返します。

pathConfig.isRootPath "C:\\"
true
pathConfig.isRootPath "C:\\temp"
false

pathConfig.isUncPath <path> 

引数のパスが UNC パスである場合は true を返し、そうでない場合は false を返します。

pathConfig.isUncPath "T:\\Projects" --mapped drive, not UNC
false
pathConfig.isUncPath "\\\\MyServer\\Projects" --UNC path
true

pathConfig.isUncSharePath <path> 

引数のパスが UNC 共有パスである場合は true を返し、そうでない場合は false を返します。

pathConfig.isUsingProfileDirectories() 

システムがプロファイル ディレクトリを使用している場合は true を返し、そうでない場合は false を返します。

pathConfig.isUsingRoamingProfiles() 

システムがローミング プロファイルを使用している場合は true を返し、そうでない場合は false を返します。誰か別の人物のマシン上でローミング プロファイルを使用している場合は、ネットワークを介して自分のマシン上のプロファイルにアクセスしていることになります。このモードは正式にはサポートされていません。

その他のパス関連メソッドおよび構造体

pathConfig.GetDir <#directory_type> 

ここで説明されている GetDir() メソッドをポイントします。

directory_type が次のいずれかであるシステム ディレクトリを返します。

#font | #Scene | #export | #import | #help | #expression | #preview | #image | #Sound | #plugcfg | #maxstart | #vpost | #drivers | #autoback | #matlib | #scripts | #startupScripts | #defaults | #renderPresets | #ui | #maxroot | #renderoutput | #animations | #archives | #Photometric | #renderassets | #userScripts | #userMacros | #userStartupScripts | #temp | #userIcons | #maxData | #downloads | #proxies | #pageFile 

pathConfig.mapPaths #Struct:mapPaths 

mapPaths 構造体の定義をポイントします。

--the two method calls are equivalent:
mapPaths.getFullFilePath "fir.tga"
pathConfig.mapPaths.getFullFilePath "fir.tga"

pathConfig.pluginPaths #Struct:pluginPaths 

pluginPaths 構造体をポイントします。

count = pathConfig.pluginPaths.count()
for j = 1 to count do
format " % : %\n" j (pathConfig.pluginPaths.get j)

pathConfig.sessionPaths #Struct:sessionPaths 

sessionPaths 構造をポイントします。

pathConfig.SetDir 

ここで説明されている SetDir() メソッドをポイントします。

pathConfig.xrefPaths #Struct:xrefPaths 

XRefPath 構造体をポイントします。

--the two method calls are equivalent:
xrefPaths.getFullFilePath "delme.max"
pathConfig.xrefPaths.getFullFilePath "delme.max"

[ユーザ パスの設定](Configurate User Paths)ダイアログ ボックス - パス設定のロード、保存、結合

pathConfig.SaveTo <filename> 

パス設定を指定されたファイルに保存します。成功した場合は true を返し、成功しなかった場合は false を返します。。[カスタマイズ](Customize) > [ユーザ パスを設定](Configure User Paths)で表示される[ユーザ パスの設定](Configure User Paths)ダイアログ ボックスの[名前をつけて保存...](Save To...)ボタンに対応します。

pathConfig.load <filename> 

指定されたパス設定ファイルからパス設定を読み込みます。指定されたパス設定ファイルからパス設定を読み込みます。成功した場合は true を返し、成功しなかった場合は false を返します。[カスタマイズ](Customize) > [ユーザ パスを設定](Configure User Paths)ダイアログ ボックスの[ロード](Load)ボタンに対応します。

pathConfig.merge <filename> 

指定されたパス設定ファイルの設定を合成します。成功した場合は true、失敗した場合は false を返します。指定されたパス設定ファイルからパス設定を読み込みます。成功した場合は true、失敗した場合は false を返します。[カスタマイズ](Customize) > [ユーザ パスの設定](Configure User Paths)ダイアログ ボックスの[合成](Merge)ボタンに対応します。