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]
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.
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]
out1Dynamic 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. |