bridge

bridge — creates a bridge between two points.

Synopsis

(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:

1 Forward bridge: bridge from source to destination
2 Inverse bridge: bridge from destination to source
16 Clamp output to the minimum. (Range mapping only.)
32 Clamp output to the maximum. (Range mapping only.)
256 The bridge is a direct copy
512 The bridge uses a linear transformation
1024 The bridge uses range mapping
4096 The 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 ignored if (flags & 1024) == 0.

dstmax

The maximum range map value for the destination point. This is ignored 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.