The Timecode CHOP generates timecode data, supporting a variety of different modes for doing so: including from a timecode string, sequentially, and more. The timecode data is output as both channel data in the CHOP, and as a timecode object via its timecode member in Python.
The timecode can follow the SMPTE standard (ie. non-negative, loops at 24 hours), or a more general format (ie. negative timecode allowed, loops at 100 hours).
Optionally, an input with negative, hour, minute, second, or frame channels can be provided that is added to the Timecode CHOP's output.
Parameters - Timecode Page
smpte - When enabled the generated timecode will follow the SMPTE timecode standard, meaning no negative timecodes, and the timecode will loop at 24 hours. When disabled, the format will be more general, allowing for negative numbers and a maximum timecode of 100 hours.
mode - ⊞ - The source used for generating the timecode
- Locked to Timeline
lockedtotimeline- Generates the timecode from the timeline's time.
- Specify Index
specifyindex- Generates the timecode from a single index value.
- Timecode String
timecodestr- Generates the timecode from a timecode string following the format:
- Hour, Minute, Second, Frame Parameters
timecodepar- Generates the timecode from hour, minute, second, and frame parameters. The parameters will overflow from one to the next, eg. specifying 120 seconds will output timecode as
00:02:00:00. Fractional values are also allowed.
sequential- The timecode increases sequentially over time.
- Timecode Object
timecodeobj- Generates the timecode from a timecode object.
- CHOP Channels
chop- Generates the timecode from a CHOP reference with some or all of the channels: negative, hour, minute, second, frame.
- OP Reference
op- Generates the timecode from an OP with a timecode Python member, eg. MoviefileinTOP_Class.
rate - The timecode FPS. The timecode's max frame value is equal to
rate-1. If a fractional rate is provided then the rate is rounded up to the nearest whole number and drop-frames will be calculated if enabled on the Drop Frame parameter.
dropframe - ⊞ - Specify how to calculate drop-frames. Drop frames are used when the FPS is fractional. FPS cannot increment a fractional amount per frame so FPS is rounded to the next whole number and the accumulation of error is accommodated for by adding drop frames.
off- Drop-frames will not added.
auto- Drop-frames will be added to the timecode when the rate is fractional. For special rate values such as 29.97, the defined standard solution is used (ie. 2 frames added every minute, except minutes that are divisible by 10). In other cases, a general solution is used by calculating the accumulated error.
index - The index used to generate the timecode. Value is used in conjunction with the specified units.
indexunit - ⊞ - The index value units.
timecodestr - A timecode string following the format:
frame - Frame component of the timecode.
second - Second component of the timecode.
minute - Minute component of the timecode. Allows for overflow.
hour - Hour component of the timecode.
init - Used in sequential mode. Initializes the timecode value.
start - Used in sequential mode. Starts the timecode sequential increment.
play - When enabled, the sequential timecode will step forward.
timecodeobj - A timecode object.
chop - A CHOP reference which contains some or all of the following channels: negative, hour, minute, second, frame.
op - An OP reference that contains a timecode Python member: eg. MoviefileinTOP_Class.
Parameters - Output Page
negativechan - When enabled, outputs the negative channel, which is true when the timecode is negative. Always false when using SMPTE standard.
framechan - When enabled, outputs the frame channel.
secondchan - When enabled, outputs the second channel.
minutechan - When enabled, outputs the minute channel.
hourchan - When enabled, outputs the hour channel.
Total Seconds Chan
totalseconds - When enabled, outputs the total_seconds channel, which is the timecode converted into seconds.
Total Frames Chan
totalframes - When enabled, outputs the total_frames channel, which is the timecode into frames.
Drop Frame Chan
dropframechan - When enabled, outputs the drop_frame channel, which is true when the timecode is drop-frame.
fpschan - When enabled, outputs the fps channel.
Parameters - Common Page
timeslice - Turning this on forces the channels to be "Time Sliced". A Time Slice is the time between the last cook frame and the current cook frame.
scope - To determine which channels get affected, some CHOPs use a Scope string on the Common page.
Sample Rate Match
srselect - ⊞ - Handle cases where multiple input CHOPs' sample rates are different. When Resampling occurs, the curves are interpolated according to the Interpolation Method Option, or "Linear" if the Interpolate Options are not available.
- Resample At First Input's Rate
first- Use rate of first input to resample others.
- Resample At Maximum Rate
max- Resample to the highest sample rate.
- Resample At Minimum Rate
min- Resample to the lowest sample rate.
- Error If Rates Differ
err- Doesn't accept conflicting sample rates.
exportmethod - ⊞ - This will determine how to connect the CHOP channel to the parameter. Refer to the Export article for more information.
- DAT Table by Index
datindex- Uses the docked DAT table and references the channel via the index of the channel in the CHOP.
- DAT Table by Name
datname- Uses the docked DAT table and references the channel via the name of the channel in the CHOP.
- Channel Name is Path:Parameter
autoname- The channel is the full destination of where to export to, such has
autoexportroot - This path points to the root node where all of the paths that exporting by Channel Name is Path:Parameter are relative to.
exporttable - The DAT used to hold the export information when using the DAT Table Export Methods (See above).
- Input 0: - Optional input CHOP with some or all of following channels: negative, hour, minute, second, frame. The input timecode value is added to the Timecode CHOP's output.