Examples
Decibel volume slider and monitor
| bang | Sends the current value out the outlet. | |
| int | db-input [int] |
The number received in the inlet sets the level (in dB). |
| float | db-input [float] |
The number received in the inlet sets the level (in dB). |
| assign | assign-input [float] |
The word , followed by a floating point value, causes that value to be stored and displayed and sent out the live.gain~ object's outlet. If the Parameter Visibility attribute is set to Stored Only, the message will not add the new value to the Live application’s undo chain. |
| init | Restore and output the initial value. | |
| (mouse) | Click and drag the slider to change the amplification. Hold down the Command key (Macintosh) or the Control key (Windows) for more precise mouse control. | |
| outputvalue | Sends the current value out the outlet. | |
| set | set-slider-value [float] |
Sets the current value without causing output. |
| signal | In left inlet: The input signal (left channel) to be scaled. In right inlet: The input signal (right channel) to be scaled. |
|
| rawfloat | input [float] |
A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, stored, displayed by live.gain~ object, and the current value is sent out the outlet. |
| Name | Type | g/s | Description |
|---|---|---|---|
| active | int def.:1 |
Toggles the object's active mode. When the attribute is set to 0, mouse action does not cause output and the inactive colors are used. | |
| clip_size | int def.:0 |
Sets the clipping zone size. The options are: 0./Normal (the default) 1.0/Extended |
|
| display_range | float def.:-70. 6. |
Sets the range, in deciBels, displayed by the live.gain~ object. By default, the the display range is set to the same values as the range of the object itself (-70dB - +6dB). | |
| focusbordercolor | float | Sets the display color for the live.gain~ object's border in RGBA format. | |
| interp | float def.:10. |
Sets the ramp time in milliseconds. The default is 10 milliseconds. | |
| interval | int def.:20 |
Sets the update time interval of the meter display, in milliseconds. The minimum update interval is 10 milliseconds, the maximum is 2 seconds. This message also sets the rate at which the live.gain~ object sends out the list of peak values (in dB) for each channel received in that time interval. | |
| metering | int def.:1 |
Specifies whether the live.gain~ object displays and outputs the signal level pre-fader (0) or post-fader (1). | |
| modulationcolor | float | Sets the modulation color of live.gain~ object in RGBA format. | |
| orientation | int def.:0 |
Sets the slider object to a horizontal or vertical data display. 0 : (the default) sets the display dependent on the size of the slider - longest side of the rectangle that describes the slider sets the orientation. 1 2 |
|
| relative | int def.:0 |
Sets the mode for mouse behavior. The options are: 0 : In relative mode (the default), the live.gain~ keeps its relative position when you click on it. Moving the mouse outputs higher or lower values in relation to that relative position. 1 : In absolute mode, the live.gain~ will automatically jump directly to the clicked location. |
|
| showname | int def.:1 |
Toggles the display of the parameter name. The default is 1 (on). | |
| shownumber | int def.:1 |
Toggles the display of the gain parameter value. The default is 1 (on). | |
| slidercolor | float | Sets the slider background color in RGBA format. | |
| textcolor | float | Sets the display color for the live.gain~ object's text in RGBA format. | |
| tribordercolor | float | Sets the triangle border color in RGBA format. This is only used when the live.gain~ object does not have the focus. | |
| tricolor | float | Sets the triangle color in RGBA format. This is only used when the live.gain~ object does not have the focus. | |
| trioncolor | float | Sets the triangle color in RGBA format. This is only used when the live.gain~ object does have the focus. |