AddFileCacheSource

Introduced

v7.0

Categories

Source

Description

Loads a file cache sequence onto the mixer. The file cache sequence has to be generated first using either the CacheOnFileNode node in an ICE Tree, or by running the CacheObjectsIntoFile command and then the CacheObjectsIntoFileDialog command.

This command creates a new FileCacheSource object, and can additionally create the FileCache track on the mixer and deploy the FileCache clip onto that track.

Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:

For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.

For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

Scripting Syntax

AddFileCacheSource( [InputObj], [FileName], [DeployInMixer], [Source] );

Parameters

Parameter Type Description
InputObj String The object to be linked to the file cache

Default Value: Current selection

FileName String Full path of the new file cache source.

Default Value: User is prompted to select a file

DeployInMixer Boolean True to make available in the animation mixer.

Default Value: True

Source CollectionItemLegacy The new file cache source.

Examples

Python Example

app = Application
True = 1
False = 0
app.NewScene("", False)
# First set the caching preferences
app.SetValue("preferences.simulation.cachetemplatefilename", "[object]_[version]_[frame].icecache")
app.SetValue("preferences.simulation.cachetemplateprojectpath", "[project path]/simulation/[model]/[object]/")
# Create a grid deformed by a wave
app.CreatePrim("Grid", "MeshSurface")
app.GetPrimWave()
# Cache this deformation into a file sequence
app.CacheObjectsIntoFile("grid", 0, 1, 100, 1, True, True, "PointPosition", "Wave")
# Delete the wave deform
app.DeleteObj("wave")
# Load the deformation file sequence onto the mixer
rtn = app.AddFileCacheSource("grid", "Simulation\Scene_Root\grid\grid_Wave_[1..100].icecache")
src = rtn.Value("Source")
app.LogMessage("The newly created %s is: %s" % (src.Type, src.FullName))
# INFO : The newly created FileCacheSource is: Mixer.grid_Wave__1__100__icecache
# Now hit Playback
app.PlayForwards()

See Also

CacheObjectsIntoFile CacheObjectsIntoFileDialog Source