Fetch channel node

Imports channels from other OPs.

All

Channelgroupname

Parameters

Example files

See also: Export

The Fetch CHOP imports channels from other OPs. It can grab either the regular control channels from any OP, or data channels that are output from chops. Control channels are those channels associated with parameters of any OP. Data channels are only present in CHOPs, and are the channels output by CHOPs.

The Fetch CHOP can get the output channels from CHOPs in other CHOP networks.

The Channels field also supports channel groups with the syntax.

Channelgroupname

Note

Fetching cannot be recursive. If a CHOP exports to an object’s channel, and that object channel is fetched, the Fetch CHOP cannot feed to the CHOP that exports. This will produce an error message in the Fetch CHOP. If this occurs, you will have to lock the Fetch CHOP before exporting back to the object.

Parameters

Source

Node	The Node and Channels determine where the channels come from. They are concatenated together, so a channels of “tx” and a path of “/obj/model” will fetch “/obj/model/tx”. They also accept globbing, so a Node of /obj/ and a channel of tx would select all the tx channels from all the nodes inside.
Channels	This field is appended to the specified Node to complete the path. Wildcards and multiple entries are allowed. t? implies all translate channels, tx, ty, tz. Alternately, you can set leave the node blank and specify the full path in Channels, such as /obj/geo/*.
Fetch	If fetching from another CHOP, you can fetch its OP Control Channels or CHOP Data Channels. All other OPs have only Control Channels, so leave this menu set at “OP Control Channels”.
Select	Fetched channels can be eliminated to include only control channels that have been added, or further, channels that have been added and are animating over the start/end time range. Applies to OP Control Channels.

Channel

Channel Names

Sets how the fetched channels are named. A : is placed in the channel name where / is in the path.

Channel Name	Only use the name of the channel.
OP and Channel Names	Include the parent OP name with the channel name, separated by a colon (:).
Full Path Name	Use the full path as the name, with the parts separated by a colon (:).

Channel Range

Indicates how much of the channel to fetch.

Use Full Animation Range	All of the animated range.
Use Current Frame	Only the sample at the current frame.
Use Start/End	Specify the range below.

Start

The beginning of the fetch.

End

The end of the fetch.

Sampling Method

Determines the sample rate to be used.

New Rate (Same Index Range)	Resample to new rate below.
Resample From Maximum Rate	Use the highest rate found.
Resample From Minimum Rate	Use the lowest rate found.

Sample Rate

The sample to use if “New Rate” is selected, or if no rates are found.

Common

Some of these parameters may not be avaiable on all CHOP nodes.

Scope

To determine which channels get affected, some CHOPs have a scope string. Patterns can be used in the scope, for example * (match all), and ? (match single character).

The following are examples of possible channel name matching options:

`chan2`	Matches a single channel name.
`chan3 tx ty tz`	Matches four channel names, separated by spaces.
`chan*`	Matches each channel that starts with `chan`.
`foot`	Matches each channel that has `foot` in it.
`t?`	The `?` matches a single character. `t?` matches two-character channels starting with t.
`r[xyz]`	Matches channels `rx`, `ry` and `rz`.
`blend[3-7:2]`	Matches number ranges giving `blend3`, `blend5`, and `blend7`.
`blend[2-3,5,13]`	Matches channels `blend2`, `blend3`, `blend5`, `blend13`.
`t[xyz]`	`[xyz]`matches three characters, giving channels `tx`, `ty` and `tz`.

Sample Rate Match

The Sample Rate Match Options handle cases where multiple input CHOPs’ sample rates are different.

Resample At First Input’s Rate	Use rate of first input to resample others.
Resample At Maximum Rate	Resample to highest sample rate.
Resample At Minimum Rate	Resample to the lowest sample rate.
Error if Rates Differ	Does not accept conflicting sample rates.

Units

The units for which time parameters are specified.

For example, you can specify the amount of time a lag should last for in seconds (default), frames (at the Houdini FPS), or samples (in the CHOP’s sample rate).

Note

When you change the Units parameter, it does not convert the existing parameters to the new units.

Time Slice

Time Slicing is a feature which boosts cooking performance and reduces memory usage. Traditionally, CHOPs calculate the channel over its entire frame range. If the channel does need to be evaluated every frame, then cooking the entire range of the channel is unnecessary. It is more efficient to calculate only the fraction of the channel that is needed. This fraction is known as a Time Slice.

Unload

Causes the memory consumed by a CHOP to be released after it is cooked and the data passed to the next CHOP.

Export Prefix

The Export prefix is prepended to CHOP channel names to determine where to export to.

For example, if the CHOP channel was named geo1:tx, and the prefix was /obj, the channel would be exported to /obj/geo1/tx.

Note

You can leave the Export Prefix blank, but then your CHOP track names need to be absolute paths, such as obj:geo1:tx.

Graph Color

Every CHOP has this option. Each CHOP gets a default color assigned for display in the Graph port, but you can override the color in the Common page under Graph Color. There are 36 RGB color combinations in the Palette.

Graph Color Step

When the graph displays the animation curves and a CHOP has two or more channels, this defines the difference in color from one channel to the next, giving a rainbow spectrum of colors.

Example files

Fetch

$HFS/houdini/help/examples/nodes/chop/fetch/Fetch.cmd

Load | Launch

This is an example of the Fetch CHOP. Here the Fetch CHOP is used to import the tx, ty and tz channels from a null node.

Usages in other examples

Example name	Example for
SimpleIKSolver	IKSolver channel node	Load \| Launch
FurBallWorkflow	Fur surface node	Load \| Launch
BeadCurtain	Wire Solver dynamics node	Load \| Launch
BendingTree	Wire Solver dynamics node	Load \| Launch
TypesOfDrag	Drag Force dynamics node	Load \| Launch
DampedHinge	RBD Angular Spring Constraint dynamics node	Load \| Launch
AnimatedSkin	Wire Glue Constraint dynamics node	Load \| Launch
FluidWireInteraction	Fluid Force dynamics node	Load \| Launch
PaddleWheel	RBD Solver dynamics node	Load \| Launch
Pendulum	RBD Hinge Constraint dynamics node	Load \| Launch
DentingWithPops	SOP Solver dynamics node	Load \| Launch
ParticlesAndCloth	Particle Fluid Solver dynamics node	Load \| Launch
grass		Load \| Launch
ClothSpringsBalls	Cloth Solver dynamics node	Load \| Launch
StitchedClothPatches	Cloth Solver dynamics node	Load \| Launch
PinnedClothWind	Cloth Solver dynamics node	Load \| Launch
ClothAttachedDynamic	Cloth Solver dynamics node	Load \| Launch
AnimatedClothPatch	Cloth Solver dynamics node	Load \| Launch
Weights	RBD Spring Constraint dynamics node	Load \| Launch
ShatterGlass	RBD Glue Object dynamics node	Load \| Launch
Chain	RBD Pin Constraint dynamics node	Load \| Launch
Pendulum	RBD Pin Constraint dynamics node	Load \| Launch