Interface: AssetManager

The AssetManagerCore Interface introduced in 3ds Max 2010 manages the saving of Asset data into the 3ds Max scene file.

Interfaces > Core Interfaces > AssetManager

 

   

Core Interfaces - Quick Navigation

In releases prior to 3ds Max 2010 , a plug-in that referenced an external file (an asset) would hold the asset’s filename as a string or as a Path object, and would store the filename to the 3ds Max scene file as a string or an IParameterBlock2 TYPE_FILENAME parameter. To allow 3ds Max to identify the assets used by a plug-in, the plug-in would implement an IAssetAccessor-derived class. The information provided from this class was primarily used by the Asset Tracker.

Since 3ds Max 2010 , assets are handled as instances of class AssetUser . An instance of this class contains information on the asset filename, its type, and the 3ds Max scene file that depends on it (this is used for resolving external references). Access to, and lifetime management of assets is handled by the Asset Manager.

Loading and saving the Asset to the 3ds Max scene file is now done through the AssetUser and the AssetManager.

When saving a 3ds Max scene, the asset data is saved by the Asset Manager to a separate stream in the 3ds Max file. This gives the capability to external programs to access the asset data in order to identify the assets used by the scene and potentially modify the asset data without loading the scene file into 3ds Max.

The following methods expose the information handled by the AssetManager to MAXScript:

Methods:

Get Asset

<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} 		
autoAcquire default value: true 	   

Returns the AssetUser Object of the asset with the specified file name and asset type.

   

<IObject>AssetManager.GetAssetByIndex <index>index 

Returns the AssetUser Object of the asset with the given index.

Use AssetManager.GetNumAssets() to get the number of Assets.

See example at the end of this topic for details.

Get Asset ID and File Name

<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} 

Returns the asset ID of the specified file name of the given asset type.

EXAMPLE:

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 

Returns the file name of the asset with the given AssetID.

EXAMPLE:

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

Add and Release Reference

   

<integer>AssetManager.GetNumReference <&TSTR>assetid 

assetid is In parameter 

Returns the number of the References to the Asset with the given AssetID.

   

<bool>AssetManager.AddReference <&TSTR>assetid 

assetid is In parameter 

Adds a Reference to the Asset with the given AssetID.

Returns true on success, false on failure.

   

<bool>AssetManager.ReleaseReference <&TSTR>assetid 

assetid is In parameter 

Releases the Reference of the Asset with the given AssetID.

Returns true on success, false on failure.

EXAMPLE:

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

Get Number of Assets and AssetUsers

<INT64>AssetManager.GetNumAssetUsersCreated() 

Returns the total number of AssetUser instances created during the current 3ds Max session.

   

<INT64>AssetManager.GetNumAssetUsers() 

Returns the number of AssetUser instances.

   

<INT64>AssetManager.GetNumAssetsCreated() 

Returns the total number of Assets created during the current 3ds Max session.

   

<INT64>AssetManager.GetNumAssets() 

Returns the number of Assets.

EXAMPLE:

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

Examples:

EXAMPLE:

The following script outputs to the MAXScript Listener the ID, type and file name of all Assets in the current scene:

--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
)

POSSIBLE OUTPUT:

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

See also

Accessing AssetManager, AssetUser and Asset Metadata in MAX Files

IObject:AssetUser

MAX File Asset Metadata Stream Access

Interface: FileResolutionManager