double CopyChan (object slave, object master, string channelMask, string additiveMask)

Return Value: 1.0 = success, 0.0 = failure.

Arguments:

Copies the channel values from master to slave. You indicate which channels you want copied with the channelMask. This bit mask is arranges as follows:

xpos ypos zpos heading pitch bank xscale yscale zscale xpivot ypivot zpivot

So a mask of 111000111000 would copy the three translation channels and the three scale channels.

In the case where you want the effects of this function to be additive (i.e. you can keyframe on top of this procedural animation) you would indicate which channels are additive by setting the channels bit to 1 in the additiveMask.

Note: The bit masks must be passed as strings so they need to be enclosed in quotes. You are allowed to put spaces in the string for better visual representation of the channels e.g. "111 111 000 000".

Example:

Exp_1
|_ CopyChan( Null, Null_1, "111 000 000 000", "010 000 000 000" )

Exp_1
|_ CopyChan( Null, Null_1, "111 000 000 000", "010 000 000 000" )

The values of Null_1's xpos, ypos and zpos channels are copied to Null's. The ypos channel is marked as additive and can therefore be animated on top of the value set by CopyChan.