インタフェース: AssetManager

AssetManager コア インタフェースは 3ds Max 2010で導入され、3ds Max シーン ファイルへのアセット データの保存を管理します。

インタフェース > コア インタフェース > AssetManager

 

   

コア インタフェース - クイック ナビゲーション

3ds Max 2010 より前のバージョンでは、外部ファイル(アセット)を参照したプラグインがそのアセットのファイル名を文字列またはパス オブジェクトとして保持し、このファイル名を 3ds Max シーン ファイルに文字列または IParameterBlock2 TYPE_FILENAME パラメータとして格納していました。プラグインによって使用されるアセットを 3ds Max が識別できるようにするために、プラグインは IAssetAccessor から派生するクラスを実装します。このクラスから提供される情報は、主にアセット トラッカーによって使用されます。

3ds Max 2010 以降、アセットは AssetUser クラスのインスタンスとして処理されます。このクラスのインスタンスには、アセットのファイル名、タイプ、およびこのアセットに依存する 3ds Max シーン ファイル(外部参照を解決するために使用されます)が含まれています。アセットへのアクセスおよびアセットの寿命管理は、アセット マネージャによって処理されます。

3ds Maxシーン ファイルへのアセットのロードと保存は、AssetUser と AssetManager によって行われます。

3ds Max シーンを保存すると、アセット データはアセット マネージャによって 3ds Max ファイルの別のストリームに保存されます。これにより、外部プログラムがアセット データにアクセスしてシーンで使用されているアセットを識別できるようになり、3ds Max にシーン ファイルをロードしなくてもアセット データを修正することができます。

以下のメソッドは、AssetManager が管理する情報を MAXScript に公開します。

メソッド:

アセットの取得 

<IObject>AssetManager.GetAsset <&TSTR>fileName <enum>assetType autoAcquire:<bool> 		

fileName is In parameter 		
assetType enums: {#Other | #Bitmap | #XRef | #Photometric | #Animation | #VideoPost | #BatchRender | #ExternalLink | #RenderOutput | #PreRenderScript | #PostRenderScript | #Sound | #Container | #MaxCreationGraph} 		
autoAcquire default value: true

指定されたファイル名とアセット タイプを持つアセットの AssetUser オブジェクトを返します。

    

<IObject>AssetManager.GetAssetByIndex <index>index

指定されたインデックスを持つアセットの AssetUser オブジェクトを返します。

AssetManager.GetNumAssets() を使用してアセットの数を取得します。

詳細については、「本トピックの最後にある例」を参照してください。

アセット ID とファイル名の取得 

<TSTR by value>AssetManager.GetAssetId <&TSTR>fileName <enum>assetType 

fileName is In parameter 
assetType enums: {#Other | #Bitmap | #XRef | #Photometric | #Animation | #VideoPost | #BatchRender | #ExternalLink | #RenderOutput | #PreRenderScript | #PostRenderScript | #Sound | #Container | #MaxCreationGraph}

指定されたアセット タイプを持つ指定されたファイル名のアセット ID を返します。

例: 

AssetManager.GetAssetID "Simple_Stone_Mtl_Marble_bump.jpg" #Bitmap
"{7477A3A4-0304-47AC-8427-6B490673231A}"

    

<TSTR by value>AssetManager.GetFileName <&TSTR>assetid 

assetid is In parameter

指定された AssetID を持つアセットのファイル名を返します。

例: 

AUIO = AssetManager.GetAssetByIndex 1--get the AsserUser with index 1
--><IObject:AssetUser>
 
AUIO.GetFileName()--get the file name
-->"Untitled Scene"
 
--This is equivalent:
AssetManager.GetFileName (AUIO.getAssetID())--get the name by AssetID
-->"Untitled Scene"

参照の追加と解放

    

<integer>AssetManager.GetNumReference <&TSTR>assetid 

assetid is In parameter

指定された AssetID を持つアセットへの参照の数を返します。

    

<bool>AssetManager.AddReference <&TSTR>assetid 

assetid is In parameter

指定された AssetID を持つアセットへの参照を追加します。

成功した場合は true を、失敗した場合は false を返します。

    

<bool>AssetManager.ReleaseReference <&TSTR>assetid 

assetid is In parameter

指定された AssetID を持つアセットの参照を解放します。

成功した場合は true を、失敗した場合は false を返します。

例: 

AUIO = AssetManager.GetAssetByIndex 1--get the AsserUser with index 1
--><IObject:AssetUser>
 
AID =AUIO.getAssetID()--get the file name
-->"{7477A3A4-0304-47AC-8427-6B490673231A}"
 
AssetManager.GetNumReference AID--get the reference numberby AssetID
-->4
 
AssetManager.AddReference AID--add a referenceby AssetID
-->true
 
AssetManager.GetNumReference AID--get thereference numberby AssetID
-->5
 
AssetManager.ReleaseReference AID--release a referenceby AssetID
-->true
 
AssetManager.GetNumReference AID--get thereference numberby AssetID
-->4

アセット数および AssetUser 数の取得 

<INT64>AssetManager.GetNumAssetUsersCreated()

現在の 3ds Max セッションで作成された AssetUser インスタンスの合計数を返します。

    

<INT64>AssetManager.GetNumAssetUsers()

AssetUser インスタンスの数を返します。

    

<INT64>AssetManager.GetNumAssetsCreated()

現在の 3ds Max セッションで作成されたアセットの合計数を返します。

    

<INT64>AssetManager.GetNumAssets()

アセットの数を返します。

   

例: 

AssetManager.GetNumAssetUsersCreated()
-->19862L
 
AssetManager.GetNumAssetUsers()
-->114L
 
AssetManager.GetNumAssetsCreated()
-->1080L
 
AssetManager.GetNumAssets()
-->18L

    

<bool>AssetManager.RemoveMissingAssets()

3ds Max 2016 の 新機能 : 見つからないアセットを削除します。

見つからないアセットが正常に削除された場合は True を返します。

見つからないアセットが削除されなかった場合には False を返します。

例:

例:

以下のスクリプトは MAXScript リスナーに現在のシーンにあるすべてのアセットの ID、タイプ、ファイル名を出力します。 

--Loop through all Asset indices:
for i = 1 to AssetManager.GetNumAssets() do
(
local AUIO = AssetManager.GetAssetByIndex i--get the AssetUser IObject
local AID = AUIO.GetAssetId()--get the Asset's ID
local AType = AUIO.getType()--get the Asset's Type
local AFile = AUIO.getfilename()--get the Asset's File Name
format"ID:% Type:% File:%\n"AID AType AFile--format the info
)

出力例: 

ID:{B6D86A17-85FF-42E2-99D4-BB2F1857C4FB} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\PlaneToBake_diffuse.tga
ID:{7477A3A4-0304-47AC-8427-6B490673231A} Type:#bitmap File:Simple_Stone_Mtl_Marble_bump.jpg
ID:{8188ACCD-A014-4B24-A3DD-697269D8BFDB} Type:#bitmap File:Simple_Concrete_Mtl_BroomStraight_pattern.jpg
ID:{B0B6A6FD-2B76-4EA0-8B34-D1F3F3596F91} Type:#bitmap File:x47645df4
ID:{CF096A5C-41C8-43FD-852F-8823B9A707C7} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsmax\renderoutput\AssetMan_.tga
ID:{D5A9608F-EE4E-4BDC-AAB6-93D3D34E5F65} Type:#bitmap File:Simple_Concrete_Mtl_BroomCurved_pattern.jpg
ID:{30241317-2623-4628-9BF1-ED06449E3D06} Type:#bitmap File:Simple_Metal_Mtl_DiamondPlate_pattern.jpg
ID:{742F4FE3-91FC-48E7-9F3B-37CE76D37046} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Sphere01_diffuse.tga
ID:{8BEFCD25-F133-4D5E-8678-E710F8BFBFF8} Type:#bitmap File:Simple_Metal_Mtl_CheckerPlate_pattern.jpg
ID:{21B0F246-C6D0-44D3-9ECE-87D7BF8AFF14} Type:#bitmap File:Simple_Metal_Mtl_Break_pattern.jpg
ID:{B5BB9B91-DBB4-486B-835A-A107F9F4783F} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\PlaneToBake_lighting.tga
ID:{65CAE8F4-F0DF-4CC3-A05C-733CC0285CF4} Type:#bitmap File:C:\Program Files\Autodesk\3ds Max 2010\CachedThumbnails\1000000000000003.bmp
ID:{5FF857B0-D2E0-4DCC-B4F7-97248CBC6FC5} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Sphere01LightingMap.tga
ID:{31FE4D48-12B5-422E-A5D2-3A2979D773CD} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Sphere01_lighting.tga
ID:{6AC17983-685D-42A8-8269-DBEA5FECB0DB} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Plane01_lighting.tga
ID:{9BEAD40C-2562-42CF-A95D-E13E0EBD526D} Type:#bitmap File:C:\Program Files\Autodesk\3ds Max 2010\CachedThumbnails\1000000000000004.bmp
ID:{2253E2F5-82FE-46B1-B012-BC5FA100D86A} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Sphere01DiffuseMap.tga
ID:{42B8F3F4-0D38-49D9-A9D9-598288A4E674} Type:#renderoutput File:C:\Documents and Settings\username\My Documents\3dsmax\renderoutput\AssetMan_.tga
ID:{AC8AF90A-44DB-42C9-AC9E-7C35A7EBFF1A} Type:#bitmap File:C:\Documents and Settings\username\My Documents\3dsMax\sceneassets\images\Plane01_diffuse.tga
ID:{A9742E5A-4AB4-471D-A440-DE47F5262EF9} Type:#bitmap File:Simple_Stone_Mtl_Granite_bump.jpg
ID:{8EC0A624-D996-48D7-9AA8-775ACA1652B9} Type:#xref File:C:\Documents and Settings\username\My Documents\3dsmax\scenes\RENOIR\AssetManagerTest.max
ID:{B51DCC8A-57C6-4308-B5B8-00FE0A105A29} Type:#bitmap File:Simple_Stone_Mtl_StoneWall_bump.jpg
ID:{16544B6C-5D81-4E96-9B4D-550BFD4111E3} Type:#bitmap File:Simple_Metal_Mtl_Brush_pattern.jpg

関連項目

MAX ファイルの AssetManager、AssetUser、アセット メタデータへのアクセス

IObject:AssetUser

MAX ファイル アセット メタデータのストリーム アクセス

インタフェース: FileResolutionManager

このトピックについてのコメントをお送りください

Creative Commons License 特に明記されている場合以外は、この作業は、Creative Commons 表示 - 非営利 - 継承 3.0 非移植ライセンス のもと認可を受けています。 Autodesk Creative Commons FAQ (英語版) を参照してください。