The Keyframe CHOP uses channel and keys data in a Keyframe COMP and creates channels of samples at a selectable sample rate (frames per second).
The Keyframe CHOP lets you access the keyframed channel data inside a Keyframe component. The Keyframe CHOP allows the channels to be played back with the global frame or seconds index. It can be synced to the internal global beat clock, a specified index, or based on a timing or lookup channel sent into the input. It outputs all channels - either as a single sample or an entire start/end range.
To create/edit/delete keyframed channels, create a Keyframe COMP and open the Keyframe Editor by right-clicking on the component and selecting Edit Keyframes... from the pop-up menu. Inside the Keyframe component a Keyframe CHOP will be outputting the channels created in the editor.
Adding an input to the Keyframe CHOP now acts as a lookup index. In addition it outputs a proper timeslice if its input is a timeslice.
The lookup cycles through all the input channels, though only 1 is necessary
Parameters - Keyframe Page
/keyframe - the path to the Keyframe Component holding the channel and key data.
/playmode - The play mode determines how the channels of the Keyframe CHOP are played back.
- Locked to Timeline - Playback is tied to TouchDesigner's main Timeline.
- Specify Index - Use the Index and Index Unit parameters below to control playback.
- Sequential - Continually plays regardless of the Timeline position.
- Output Rage - Outputs all channel samples from start to end range.
- Use Input - Use Keyframe CHOP's input to control playback.
- Use Input if Channels Available -
/play - When using Sequential Play Mode, plays back when 1, stops when 0.
/reset - When using Sequential Play Mode, jumps to the start when 1, resumes playback when 0.
/speed - This is a speed multiplier which only works when Play Mode is Sequential. A value of 1 is the default playback speed. A value of 2 is double speed, 0.5 is half speed and so on. Negative values will play the movie backwards.
/cue - jumps to Cue Point when set to 1. Only available when Play Mode is Sequential.
/cuepoint - Set any index as a point to jump to.
/index - When Play Mode is set to Specify Index, this parameter provides the index into the channel data. Works in conjunction with Index Unit below.
/inputunit - Units used when Play Mode is set to Specify Index or the CHOP is using the its input to drive playback.
Parameters - Trim Page
relative - Determines whether the Start/End parameters are expressed as absolute numbers (relative to time 0) or numbers that are relative to the start and end of the input channels.
- Absolute - The Start and End are the actual numbers defining the new interval.
- Relative to Start/End - The Start and End are relative to the start and end of the input chop.
/start, /end - The start / end of the range to trim. The numbers are expressed in seconds, frames or samples, depending on units menu for each parameter.
tleft - The left extend condition before Trim Start.
tright - The right extend condition after Trim End.
tdefault - The default value for the trim extend conditions.
Parameters - Channel Page
/rate - The sample rate of the channels, in samples per second.
Extend Left / Extend Right
/left /right - The left and right extend conditions (before/after range).
/defval - The default value for extend conditions.
Standard Options and Local Variables
There are no local variables.