Interface: FileResolutionManager

Core Interfaces - Quick Navigation

The FileResolutionManager Core Interface exposes the new system introduced in 3ds Max 2010 which is used internally by plug-ins to resolve the paths of their file assets.

In releases prior to 3ds Max 2010, the resolution of asset files was performed either locally in the plug-in code, or through one of several methods provided by 3ds Max.

Since 3ds Max 2010, all resolutions of asset files must be performed through the AssetUser object that uses the new Asset File Resolution Manager. The File Resolution Manager can also be used for resolutions of Assets. All other resolution methods have been removed, and plug-ins should not implement their rules for resolving paths to a file asset. File resolution is based on the asset file name, asset type,and the file path to a scene that depends on the asset.

The File Resolution Manager also implements a path caching mechanism. A set of methods has been exposed to allow plug-ins and scripts to control the cache enabled/disabled state, cache duration and also to provide a way to bypass the cache when getting the resolved path.

Methods:

<bool>FileResolutionManager.getFullFilePath <&TSTR>filePath <enum>assetType byPassCache:<bool> 	 

filePath is In and Out parameter 	 
assetType enums: {#Other | #Bitmap | #XRef | #Photometric | #Animation | #VideoPost | #BatchRender | #ExternalLink | #RenderOutput | #PreRenderScript | #PostRenderScript | #Sound | #Container | #MaxCreationGraph} 	 
byPassCache default value: false

Returns the full file path by modifying the first argument passed by-reference. The second argument determines the asset type the file belongs to.

If byPassCache: is passed as true, the cache will not be used. If it is passed as false or not specified, the cache will be used.

theFilename = "Simple_Stone_Mtl_Marble_bump.jpg"
--> "Simple_Stone_Mtl_Marble_bump.jpg"
 
FileResolutionManager.getFullFilePath &theFilename #Bitmap
--> true
 
theFilename
--> "C:\Program Files\Autodesk\3ds Max 2010\Maps\adskMtl\Simple_Stone_Mtl_Marble_bump.jpg"

<bool>FileResolutionManager.getFullFilePath_assetID <TSTR>assetID <&TSTR>filePath byPassCache:<bool> 

filePath is In and Out parameter 
byPassCache default value: false 

Returns the full file path by modifying the second argument passed by-reference. The first argument defines the assetID to search for.

If byPassCache: is passed as true, the cache will not be used. If it is passed as false or not specified, the cache will be used.

theID = AssetManager.GetAssetID "Simple_Stone_Mtl_Marble_bump.jpg" #Bitmap
--> "{7477A3A4-0304-47AC-8427-6B490673231A}"
 
FileResolutionManager.getFullFilePath_assetID theID &filePath
--> true
 
filePath
--> "C:\Program Files\Autodesk\3ds Max 2010\Maps\adskMtl\Simple_Stone_Mtl_Marble_bump.jpg"

<void>FileResolutionManager.doGetUniversalFileName <&TSTR>aFullFilePath 

aFullFilePath is In and Out parameter 

Returns the universal file name by modifying the by-reference argument.

<integer>FileResolutionManager.GetNumAssetTypes() 

Returns the number of asset types.

Available in 3ds Max 2011 and higher.

<string>FileResolutionManager.GetAssetTypeString <enum>assetType 

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

Returns the asset type string corresponding to the provided asset type name.

Available in 3ds Max 2011 and higher.

<void>FileResolutionManager.EnableCaching() 

<void>FileResolutionManager.DisableCaching() 

<bool>FileResolutionManager.IsCachingEnabled() 

<DWORD>FileResolutionManager.GetMaximumCacheDuration() 

<void>FileResolutionManager.SetMaximumCacheDuration <DWORD>newMaxDuration 

<INT64>FileResolutionManager.GetNumCacheHit() 

 Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.