PathConfig 構造体

PathConfig 構造体は、プロジェクトパスおよびシステムパスへのアクセスおよび管理、パスの操作、UNC、絶対パス、および相対パスなどの相互変換などを行うためのメソッドを提供します。

3ds Max 9 以降で使用可能です。

プロジェクトフォルダ

pathConfig.doProjectSetupSteps()

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

pathConfig.doProjectSetupStepsUsingDirectory <ProjectPath>

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

pathConfig.getCurrentProjectFolder()

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

pathConfig.getCurrentProjectFolderPath()

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

pathConfig.getProjectFolderPath <ProjectPath>

指定されたプロジェクトフォルダのプロジェクト定義ファイルのファイル名(\.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.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

[基本設定]/[ファイル] にある[ファイルパスを 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.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 を返します。。[カスタマイズ]/[ユーザパスを設定]で表示される[ユーザパスの設定]ダイアログボックスの[名前をつけて保存]ボタンに対応します。

pathConfig.load <filename>

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

pathConfig.merge <filename>

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

PathConfig 構造体

プロジェクト フォルダ

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

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

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

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

関連ページ

プロジェクトフォルダ

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

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