Merge CHOP

From TouchDesigner 088 Wiki

MergeCHOP 13.jpg

Summary

The Merge CHOP takes multiple inputs and merges them into the output. All the channels of the input appear in the output. The channel order is the channels of the first input followed by the channels of the second input, and so on.

Channel names may conflict, but a channel is renamed according to the Duplicate Names menu. The CHOP appends or increments the digits of the channel name until an unused name is found.

When the Time Slice flag on the Common parameter page is on, the Merge CHOP will merge only the current Time Slice of a channel, not the entire length of all the channels.

PythonIcon.png mergeCHOP_Class

Parameters - Transform Page

Align - This menu handles cases where multiple input CHOPs have different start or end times. All channels output from a CHOP share the same start/end interval, so the inputs must be treated with the Align Options:

  • Auto - It will trim to the current [[Time Slice] if there are any Time Slices, else it will do an Extend Min/Max.
  • Extend to Min/Max - Find the earliest start and latest end, and extend all inputs to that range using the extend conditions. (see Extend Conditions).
  • Stretch to Min/Max - Find the earliest start and latest end, and stretch every channel's start and end to that range.
  • Shift to Minimum - Find the earliest start and shift all channels so they all start at that index. All channels are extended to the length of the longest one.
  • Shift to Maximum - Find the latest end and shift all channels so they all end at that index. Extend all channels to the length of the longest one.
  • Shift to First Interval - Shift all channels to the start of the first CHOP and sample all inputs using the first input's range.
  • Trim to First Interval - Trim all channels to first CHOP's range.
  • Stretch to First Interval - Stretch all channels to the first CHOP's range.
  • Trim to Smallest Interval - Trim all channels to the smallest start/end interval. The start and end values may not come from the same channel.
  • Stretch to Smallest Interval - Stretch all channels to the smallest start/end interval. The start and end values may not come from the same channel.

Duplicate Names - When channels of the input CHOPs have the same name, this menu determines what to do.

  • Unique Names - Include all the input channels, and when there is a conflict of name, make the new channel's name similar but unique by adding digits to the name.
  • Keep First - Include the channel of the first input CHOP which the name appears in, and discard any further channels with the same name.
  • Keep Last - Include the channel of the last input CHOP which the name appears in, and discard any other channels with the same name.

How the Merge CHOP determines its Output Frame Range

The Merge CHOP assures that the time interval of the output is not too long when the inputs' frame ranges are different. When one input is at frame1 and another is Time Sliced, the Merge CHOP previously output a constant-value CHOP that started at frame one and ended at the current frame. Now if the inputs are constants, it outputs a small Time Sliced interval ending at the current frame. This is the new default Align option called Auto. It will trim to the current Time Slice if there are any Time Slices, else it does as before, it does an Extend Min/Max.

Standard Options and Local Variables

There are no local variables.