bridge

bridge — creates a bridge between two points.

Syntax

(bridge source destination [flags [multiply add [srcmin srcmax dstmin dstmax]]])
    

Arguments

source

The fully qualified point name of the source, or starting point of the bridge.

destination

The fully qualified point name of the destination, or ending point of the bridge.

flags

A bitwise combination of:

1Forward bridge: bridge from source to destination
2Inverse bridge: bridge from destination to source
16Clamp output to the minimum. (Range mapping only.)
32Clamp output to the maximum. (Range mapping only.)
256The bridge is a direct copy
512The bridge uses a linear transformation
1024The bridge uses range mapping
4096The bridge is disabled
[Note]

Bits 256, 512 and 1024 are mutually exclusive.

multiply

The multiplier value for a linear transformation. This is ignored if (flags & 512) == 0.

add

The adder value for a linear transformation. This is ignored if (flags & 512) == 0.

srcmin

The minimum range map value for the source point. This is ignored if (flags & 1024) == 0.

srcmax

The maximum range map value for the source point. This is ignored if (flags & 1024) == 0.

dstmin

The minimum range map value for the destination point. This is ingored if (flags & 1024) == 0.

dstmax

The maximum range map value for the destination point. This is ingored if (flags & 1024) == 0.

Returns

A message indicating success or error. Please refer to Return Syntax for details.

Description

This command creates a bridge between two data points so that a change to the value of one point automatically propagates to the other point. The scaling and the limits on source and destination points used for linear transformations are stored with the bridge so that if you decide to change from a direct bridge to one that uses linear transformations your previous entries are preserved. The values themselves are only applied when the flag set indicates the corresponding transfer function.