PathConfig 構造体は、プロジェクト パスおよびシステム パスへのアクセスおよび管理、パスの操作、UNC、絶対パス、および相対パスなどの相互変換などを行うためのメソッドを提供します。
3ds Max 9 以降で使用可能です。
pathConfig.doProjectSetupSteps() 新しいプロジェクトをセット アップするために必要なすべての手順(プロジェクト フォルダの指定やすべてのサブフォルダの作成など)を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。
pathConfig.doProjectSetupStepsUsingDirectory <ProjectPath> 指定された ProjectPath を ルートとして、新しいプロジェクトをセット アップするために必要なすべての手順を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。
pathConfig.doSetProjectFolderSteps()既存のプロジェクトを設定するために必要なすべての手順(プロジェクト フォルダの指定など)を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。
pathConfig.doProjectSetupStepsUsingDirectory <ProjectPath>指定された ProjectPath を ルートとして、既存のプロジェクトを設定するために必要なすべての手順を実行します。成功した場合は true を返し、キャンセルされた場合は false を返します。
pathConfig.getCurrentProjectFolder() 現在のプロジェクト フォルダを返します。
pathConfig.getCurrentProjectFolderPath() 現在のプロジェクト フォルダ定義ファイル(*.MXP)を返します。
pathConfig.getProjectFolderPath <ProjectPath> 指定されたプロジェクト フォルダのプロジェクト定義ファイルのファイル名(
pathConfig.getProjectSubDirectory <subdir_index> インデックスで指定されたプロジェクト サブディレクトリを返します。
例:
--Print all Project Sub-Directories:
for i = 1 to pathConfig.getProjectSubDirectoryCount() do
format "%: %\n" i (pathConfig.getProjectSubDirectory i)
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.removeProjectDirectoryCreateFilter <#directory_type>指定したプロジェクト ディレクトリ フィルタを削除します。<directory_type> は addProjectDirectoryCreateFilter() でリストされたプロジェクト ディレクトリの中の 1 つです。
pathConfig.removeAllProjectDirectoryCreateFilters() pathConfig.addProjectDirectoryCreateFilter() を使用して追加されたすべてのフィルタを削除します。
pathConfig.getProjectDirectoryCreateFilters() 現在設定されているプロジェクト ディレクトリ フィルタからなる配列を返します。
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 に変換](Convert file paths to UNC)プロパティと同様に、絶対パスをそれに対応する 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"
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.doesFileExist <filename_string> ignoreCache:<boolean> パスが絶対パスであり、現在存在するファイルまたはディレクトリを示している場合は、true を返します。この関数は、絶対的な filename_string で示されている場所内にファイルまたはディレクトリが存在するかどうかを確認します。その際に、MissingPathCache が反映される可能性があります。詳細については、「MissingPathCache」を参照してください。
ディスクの有無を確認する際にディスク アクセスが発生するため、パスを確認するとパフォーマンスが低下することがあります。
ignoreCache が true として設定されている場合、MissingPathCache で管理されている File Path Not Present Cache 内にファイルのパスが存在するかどうかはテストに反映されません。
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"
pathConfig.SaveTo <filename> パス設定を指定されたファイルに保存します。成功した場合は true を返し、成功しなかった場合は false を返します。[カスタマイズ] (Customize) > [ユーザ パスの設定](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)ボタンに対応します。