The DataKeyFrame plug-in affects a named keyframe of an animation defined on the container the plug-in is attached to.
The Keyframe name must be unique.
When the FieldName changes, the plug-in looks for the keyframe and assigns new values to it.
Note: This plug-in is located in: Plugins -> Container plug-ins -> Data
Information: DataPool plug-ins only work properly on a single channel on the same machine.
DataKeyFrame Properties
KeyFrame Name: Defines the name of the keyframe the plug-in works on. The keyframe name must be unique.
Reset KeyFrame: Defines the name of a keyframe containing initial parameters to be used when a
RESET
string is received. If aRESET
data is accepted, the keyframe values are set to the values of the Reset KeyFrame. The keyframe name must be unique.Value Format: Defines the format of the received data.
Note: If data format is not as defined in the Value Format parameter, unpredictable behavior occurs.
Note: When using a combination of DataAction and DataKeyframe2, it's important to ensure that the DataAction plug-in appears after the DataKeyframe2 plug-in in the scene tree.
If all the keyframes are within the same container, the DataAction plug-in must be positioned after the DataKeyframe2 plug-in within that container.
If multiple containers have DataKeyframe2 plug-ins and you want to use DataAction, the DataAction plug-in should be placed in a separate container positioned below all the other containers containing DataKeyframe2 plug-ins.
Known Issues
When using DataKeyFrame inside a Transition Logic scene, be sure to use unique keyframe names, as searching for a keyframe inside a merged geometry only returns the first one.