RNBO Objects & Operators scale~
Open Help

scale~

Map an input range of values to an output range

Description

The scale object maps an input range of signal values to an output range. The output range can be larger or smaller than the input range and can be inverted. If specified, the mapping can also be exponential.

Arguments

lowin [auto]

Optional

Sets the low end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

hiin [auto]

Optional

Sets the high end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

lowout [auto]

Optional

This sets the low end of the output range, and will be the lowest output value if the input value stays with its expected range.

highout [auto]

Optional

This sets the high end of the output range, and will be the highest output value if the input value stays with its expected range.

pow [auto]

Optional

This optional fifth argument specifies the nature of the scaling curve. This argument must be a floating-point number greater than 1., with larger values leading to steeper exponential curves. Note that the rnbo version of scale uses modern exponential scaling. For more information see the Max scale~ object reference file.

Inlets

x [auto]

The signal or value that will be scaled.

lowin [auto]

Sets the low end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

hiin [auto]

Sets the high end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

lowout [auto]

This sets the low end of the output range, and will be the lowest output value if the input value stays with its expected range.

highout [auto]

This sets the high end of the output range, and will be the highest output value if the input value stays with its expected range.

pow [auto]

This optional fifth argument specifies the nature of the scaling curve. This argument must be a floating-point number greater than 1., with larger values leading to steeper exponential curves. Note that the rnbo version of scale uses modern exponential scaling. For more information see the Max scale~ object reference file.

Outlets

out1 [signal]

out1

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

highout [auto]

This sets the high end of the output range, and will be the highest output value if the input value stays with its expected range.

hiin [auto]

Sets the high end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

lowin [auto]

Sets the low end of the expected input range. Incoming values are not clipped to this range; rather, the input range is used to determine the value mapping formula.

lowout [auto]

This sets the low end of the output range, and will be the lowest output value if the input value stays with its expected range.

pow [auto]

This optional fifth argument specifies the nature of the scaling curve. This argument must be a floating-point number greater than 1., with larger values leading to steeper exponential curves. Note that the rnbo version of scale uses modern exponential scaling. For more information see the Max scale~ object reference file.

reset [bang] (default: 0)

Banging this attribute will reset the object to its default state.

x [auto]

The signal or value that will be scaled.

See Also

Name Description
scale~
scale Map an input range of values to an output range
tonormalized~ Define signal parameters for RNBO that can be accessed by the target platform.
fromnormalized~ Define signal parameters for RNBO that can be accessed by the target platform.
expr~ Evaluate an expression using the rnbo expr language.