renoise.Views.Slider

A slider with arrow buttons, which shows and allows editing of values in a custom range. A slider can be horizontal or vertical; will flip its orientation according to the set width and height. By default horizontal.

 +---+---------------+
 |<|>| --------[]    |
 +---+---------------+

• Properties
  • active : ControlActive
  • midi_mapping : ControlMidiMappingString
  • min : SliderMinValue
  • max : SliderMaxValue
  • steps : SliderStepAmounts
  • default : SliderDefaultValue
  • value : SliderNumberValue
  • visible : ViewVisibility
  • width : ViewDimension
  • height : ViewDimension
  • tooltip : ViewTooltip
  • views : renoise.Views.View[]
• Functions
  • add_notifier(self, notifier : NumberValueNotifierFunction)
  • remove_notifier(self, notifier : NumberValueNotifierFunction)
  • add_child(self, child : renoise.Views.View)
  • remove_child(self, child : renoise.Views.View)
• Local Aliases
  • ControlActive
  • ControlMidiMappingString
  • NumberValueNotifierFunction
  • SliderDefaultValue
  • SliderMaxValue
  • SliderMinValue
  • SliderNumberValue
  • SliderStepAmounts
  • ViewDimension
  • ViewTooltip
  • ViewVisibility

Properties

active : ControlActive

Instead of making a control invisible, you can also make it inactive. Deactivated controls will still be shown, and will still show their currently assigned values, but will not allow changes. Most controls will display as "grayed out" to visualize the deactivated state.

midi_mapping : ControlMidiMappingString

When set, the control will be highlighted when Renoise's MIDI mapping dialog is open. When clicked, it selects the specified string as a MIDI mapping target action. This target acton can either be one of the globally available mappings in Renoise, or those that were created by the tool itself. Target strings are not verified. When they point to nothing, the mapped MIDI message will do nothing and no error is fired.

min : SliderMinValue

The minimum value that can be set using the view

• Default: 0

max : SliderMaxValue

The maximum value that can be set using the view

• Default: 1.0

steps : SliderStepAmounts

A table containing two numbers representing the step amounts for incrementing and decrementing by clicking the <> buttons. The first value is the small step (applied on left clicks) second value is the big step (applied on right clicks)

default : SliderDefaultValue

The default value that will be re-applied on double-click

value : SliderNumberValue

The current value of the view

visible : ViewVisibility

Set visible to false to hide a view (make it invisible without removing it). Please note that view.visible will also return false when any of its parents are invisible (when its implicitly invisible).

• Default: true

width : ViewDimension

The dimensions of a view has to be larger than 0. For nested views you can also specify relative size for example vb:text { width = "80%"}. The percentage values are relative to the view's parent size and will automatically update on size changes.

height : ViewDimension

The dimensions of a view has to be larger than 0. For nested views you can also specify relative size for example vb:text { width = "80%"}. The percentage values are relative to the view's parent size and will automatically update on size changes.

tooltip : ViewTooltip

A tooltip text that should be shown for this view on mouse hover.

• Default: "" (no tip will be shown)

views : renoise.Views.View[]

READ-ONLY Empty for all controls, for layout views this contains the layout child views in the order they got added

Functions

add_notifier(self, notifier : NumberValueNotifierFunction)

Add value change notifier

remove_notifier(self, notifier : NumberValueNotifierFunction)

Remove value change notifier

add_child(self, child : renoise.Views.View)

Add a new child view to this view.

remove_child(self, child : renoise.Views.View)

Remove a child view from this view.

Local Aliases

ControlActive

boolean

Instead of making a control invisible, you can also make it inactive. Deactivated controls will still be shown, and will still show their currently assigned values, but will not allow changes. Most controls will display as "grayed out" to visualize the deactivated state.

ControlMidiMappingString

string

When set, the control will be highlighted when Renoise's MIDI mapping dialog is open. When clicked, it selects the specified string as a MIDI mapping target action. This target acton can either be one of the globally available mappings in Renoise, or those that were created by the tool itself. Target strings are not verified. When they point to nothing, the mapped MIDI message will do nothing and no error is fired.

NumberValueNotifierFunction

(value : number)

SliderDefaultValue

number

The default value that will be re-applied on double-click

SliderMaxValue

number

The maximum value that can be set using the view

• Default: 1.0

SliderMinValue

number

The minimum value that can be set using the view

• Default: 0

SliderNumberValue

number

The current value of the view

SliderStepAmounts

{ 1 : number, 2 : number }

A table containing two numbers representing the step amounts for incrementing and decrementing by clicking the <> buttons. The first value is the small step (applied on left clicks) second value is the big step (applied on right clicks)

ViewDimension

string | integer

The dimensions of a view has to be larger than 0. For nested views you can also specify relative size for example vb:text { width = "80%"}. The percentage values are relative to the view's parent size and will automatically update on size changes.

ViewTooltip

string

A tooltip text that should be shown for this view on mouse hover.

• Default: "" (no tip will be shown)

ViewVisibility

boolean

Set visible to false to hide a view (make it invisible without removing it). Please note that view.visible will also return false when any of its parents are invisible (when its implicitly invisible).

• Default: true