The Object CHOP compares two objects and outputs channels containing their raw or relative positions and orientations. The information that can be output is:
- Position of one object relative to another
- Rotation of one object relative to another
- Bearing of one object relative to another
- Single Bearing Angle between two objects
- Distance between the origin of two objects
- Inverse Square of the Distance between two objects
The optional two inputs allow you to compare X,Y,Z points in world space with objects or each other. The inputs are expected to have three channels containing XYZ points. These inputs replace the target and/or reference objects. Object and points can be compared with each other, but "Rotation" mode will always return zero.
Parameters - Object Page
The default simply gives you one object's position relative to another. You get the XYZ of the origin of the Target Object relative to the origin and rotation of the Reference Object. That is, you get the XYZ of the target object's origin as if you were at the 0,0,0 location (origin) of the Reference Object, looking down the Reference Object's Z-axis.
target - The object that is being compared to the position of the reference object. The Target Object can be expressed as a text string. This can be useful when the object name needs to be a variable - it allows you to type in a name which may include expressions or variables.
reference - The object that acts as the origin of the comparison. The Reference Object can be expressed as a text string.
compute - ⊞ - The information to output from the objects, as described below:
translate- The displacement from the reference object to the target object.
rotate- The orientation difference from the reference object to the target object.
scale- The scale difference from reference object to the target object.
transform- The translation from reference object to the target object.
bearing- The rotation necessary for the reference object to be facing the target object.
- Single Bearing Angle
singlebear- An angle representing where the target object is relative to the reference object. Zero degrees is directly in front, 90 degrees is beside and 180 degrees is behind.
distance- The distance between the two objects.
- Inverse Square Distance
invsqr- The inverse squared distance between the two objects, useful for modeling electric forces, audio dropoff and gravity.
xord - ⊞ - The transform order to use for Rotation, Scale, Transform, Bearing, or Single Bearing Angle Compute modes.
- Scale Rotate Translate
- Scale Translate Rotate
- Rotate Scale Translate
- Rotate Translate Scale
- Translate Scale Rotate
- Translate Rotate Scale
rord - ⊞ - The rotation order to use for Rotation, Scale, Transform, Bearing, or Single Bearing Angle Compute modes.
- Rx Ry Rz
- Rx Rz Ry
- Ry Rx Rz
- Ry Rz Rx
- Rz Rx Ry
- Rz Ry Rx
bearingref - ⊞ - Bearing requires a direction to use as a reference base.
- X Axis
- Y Axis
- Z Axis
- Bearing Vector
bearing - ⊞ - An arbitrary base direction for the bearing calculation.
Point Scope X
tscopex - When one of the optional point inputs is connected, this determines which channels represent X, Y and Z.
Point Scope Y
tscopey - When one of the optional point inputs is connected, this determines which channels represent X, Y and Z.
Point Scope Z
tscopez - When one of the optional point inputs is connected, this determines which channels represent X, Y and Z.
appendattribs - Adds a rotate attribute to any rotation channels the Object CHOP creates.
smoothrotate - When on outputs a smooth rotation curve without graphical jumps at 0, 90, etc.
Parameters - Channel Page
nameformat - ⊞ - Sets how the created channels are named.
- Channel Name
channel- Automatically names channels. For example:
tx, ty, tz.
- Target and Channel Names
target- Names channels with target prefix. For example: if target =
obj1:tx, obj1:ty, obj1:tz.
- Reference and Channel Names
reference- Names channels with reference parameter prefix. Behaves like Target and Channel Names above but uses the name of the reference object.
outputrange - ⊞ - The start and end time of the desired interval of the object path.
- Current Frame
currentframe- Output a single sample at the current frame.
- Current Time Slice
timeslice- Span of samples covering the current Time Slice.
- Start / End
startend- Uses range defined by the Start / End parameters below.
Cook Past Values (slow)
start - The start time of the desired interval of the object path.
end - The end time of the desired interval of the object path.
left - ⊞ - The extend condition before the CHOP interval. They are:
hold- Hold the first or last value.
slope- Continue the slope before the start, or after the end of the channel.
cycle- Cycle the channel repeatedly.
mirror- Cycle the channel repeatedly, mirroring every other cycle.
- Default Value
default- Use the constant value specified in the Default Value parameter.
right - ⊞ - Extend condition after the interval. Same options as Extend Left.
- Default Value
defval - The value used for the Default Value extend condition.
Note: When creating rotation channels, the Transform CHOP and Object CHOP will select values which minimize frame-to-frame discontinuity. The graphs will appear continuous and free of 180 degree shifts.
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 -
- Input 1 -
|• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •|
Each SOP has a list of Points. Each point has an XYZ 3D position value plus other optional attributes. Each polygon Primitive is defined by a vertex list, which is list of point numbers.
A parameter in most CHOPs that restricts which channels of that CHOP will be affected. Normally all channels of a CHOP are affected by the operator.
The term "Frame" is used (1) in the Timeline, (2) as a time-unit in CHOPs, (3) as a time-unit in TOPs, and (4) with movies images which are read and created with TOPs.
A Time Slice is the time from the last cook frame to the current cook frame. In CHOPs it is the set of short channels that only contain the CHOP channels' samples between the last and the current cook frame.
To re-compute the output data of the Operators. An operator cooks when (1) its inputs change, (2) its Parameters change, (3) when the timeline moves forward in some cases, or (4) Scripting commands are run on the node. When the operator is a Gadget, it also cooks when a user interacts with it. When an operator cooks, it usually causes operators connected to its output to re-cook. When TouchDesigner draws the screen, it re-cooks all the necessary operators in all Networks, contributing to a frame's total "cook time".
samples-per-second of a CHOP. Each CHOP in your network has a sample rate, whether it is used or not. The overall timeline has a "frame rate", which is the number of animation frames per second, generally your monitor display frequency.
Exporting is the connection of CHOP channels to parameters of operators. The output of each exporting CHOP is one or more channels, active only while the CHOP Viewer is on. The current value of a channel can be exported to a parameter of any operator, overriding that parameter's value. See Parameter.
Parameters in TouchDesigner are an operator's settings (numbers, menus, flags, strings, paths) which the user can alter. Parameters for any operator can be opened by right-clicking on the operator and selecting "Parameters..." A currently selected operator's parameters can be viewed in a Network Editor by pressing the keyboard shortcut 'p'.