Cache on File

Categories

• Data Access

Description

Reads or writes attribute information to a file. For more information about using caches, see ICE Caching [ICE].

The filename used is resolved based several things including a path, several tokens as well as a frame number. The path is chosen by either one of the path templates in the simulation preferences or a specified alternative path. Files are stored as pathtemplate\modelname\objectname_versionstring_localframe.icecache.

Furthermore this node can be used to blend file cache sequences with each other, merge file cache sequences together and copy cache file sequences from one location to a second one.

Note that in an ICE tree in the Simulation region, only the simulated frames are written to the cache. The first frame is considered to be the initial state and is not simulated. So for example, if the scene is 100 frames long, then 99 frames are written to the cache beginning with frame 2.

Parameters

Template Path

Choose the path to use for the cache file. For more information about setting up cache paths, see Setting the Default Paths for Cache Files [ICE].

Version String

Enter any string to identify this version of the cache. By default files are named objectname_versionstring_localframe.icecache.

Alternative Path

An alternative path to use for the cache file. Set Template Path (above) to Alternative Path and then specify the path here.

File Mode

Choose whether the node is reading, writing, or doing nothing.

• Do Nothing

• Save to File

• Read from File

Second Path

The path for a second file to copy values to or from.

Attribute List

A comma-separated list of extra attributes to cache.

You do not need to include attributes that are required and used by the ICE tree and render tree. Required attributes are always included.

Ports

Inputs

Mute

True to prevent the node from being executed.

In Name

Allows daisy chaining Cache On File nodes. The scene path connected in this port is appended as a prefix to the reference string of the node.

Frame

Specifies the frame number to be used to resolve the filename. This is typically driven by a Current Frame node.

Normalize

True to normalize the attribute values from a file with the ones in the scene values when blending; otherwise, handle them as additive.

Blend

Specifies the amount of blending of this current file cache sequence. Set to 1 the attribute values are simply overwritten; set to 0.5 the values from the file cache sequence are blended with the previous ones by 50%.

Overlay

True to blend file cache sequences for point clouds by overlaying one file cache sequence with a second one; otherwise, use the particle's ID. When overlaying, particles are linearly removed from the first sequence and added based on the second sequence. The balance is defined by the Blend value of the node.

Append

Merge the particles into the existing point cloud when loading multiple file cache sequences; otherwise, blend with each other.

Outputs

Execute

Output port to connect to execute the node.

Out Name

Allows daisy chaining Cache On File nodes. Connect this port into the In Name port of another Cache On File to prefix the reference of the other node with the reference of this node.



Autodesk Softimage v.7.5