SessionPaths 構造体

セッション パスはビットマップ/フォトメトリック パスおよび外部参照パスと同じものですが、3ds Max の終了時に保存されないという点が異なります。

セッション パスのリストは、3ds Max の起動時には常に空です。

しかし、ファイルをロードする前にセッション パスを設定した場合には、ファイル内のリソースを検索するためにセッション パスが使用されます。

注: セッション パスは[パスを設定](Configure Paths)ダイアログ ボックスには表示されません

sessionPaths 構造体を通して 4 つの関数を使用できます。各関数では、キーワード #map#xref に置き換えて外部参照パスを指定することができます。

セッション パスの 2 つのリスト(ビットマップと外部参照)は、互いに個別に保持されます。

<boolean>sessionPaths.add (#map |    #xref ) <String path>      

新しいビットマップまたは外部参照パスを追加します。成功した場合は true を、失敗した場合は false を返します。同じパスを何度も追加すると、セッション パス内には単一のパスが保存されることになります。注: 存在しないパスを追加することはできません。存在しないパスを渡すと失敗し、false が返されます。

<integer>sessionPaths.count ( #map |    #xref )   

ビットマップまたは外部参照パスの数を返します。

<string>sessionPaths.get ( #map | #xref ) <Integer index> 

インデックス指定されたビットマップまたは外部参照セッション パスを返します。

<boolean>sessionPaths.delete ( #map | #xref ) <Integer index> 

インデックス指定されたビットマップまたは外部参照パスを削除します。成功時に true を返します。

   sessionPaths.count #map --the number of session bitmap paths
   0 --there are none at this point
   sessionPaths.add #map "d:/maps" --add a bitmap session path
   true --success!
   sessionPaths.count #map --has the number of paths changed?
   1 --of course it did!
   sessionPaths.get #map 1 --get the first bitmap session path
   "d:/maps" --what you put in, comes out...
   sessionPaths.delete #map 1 --delete the first bitmap session path
   true --dead you are!
   sessionPaths.count #map --and the number of session paths is...
   0 --none.

セッション パスの使用方法として考えられるのは、アセット管理の「プロジェクト」システムの作成です。各プロジェクトにはビットマップおよび外部参照用の特定のフォルダがあります。ユーザはファイルをロードする前に、まずプロジェクト設定をロードし、これによって適切なセッション パスを設定します。プロジェクトの一部としてロードされたすべてのファイルは、マップおよび外部参照の適切なライブラリに自動的にアクセスするようになります。プロジェクトを閉じると、セッション パスは削除されます。