bridge_transform

bridge_transform — modifies an existing bridge.

Syntax

(bridge_transform name flags [multiply add [srcmin srcmax dstmin dstmax]])
    

Arguments

name

The name 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 modifies an existing bridge between two data points. 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.