index :: ui

ui.sliders

aliases: [ui.vsliders]

Multiple slider widget

available since version: 0.1

---

arguments:

• N number of sliders
  type: float
  

methods:

• dump dumps all object info to Pd console window
  

• select draws specified slider with select color
  parameters:
  • N slider index, starting from 0.
    type: int
    required: True
    

• random fill sliders with random values without output
  

• linup fill sliders with increasing values without output
  

• lindown fill sliders with decreasing values without output
  

• fill fill sliders value with specified value without output
  

• set sets sliders values without output
  parameters:
  • [VALUES] slider values
    type: list
    
• get slider N get specified slider value
  parameters:
  • N slider position, starting from 0
    type: int
    required: True
    
• set slider N V sets specified slider value
  parameters:

  • N slider position, starting from 0
    type: int
    required: True
    

  • V slider value
    type: float
    required: True
    

• ++ increment all sliders without output
  

• – decrement all sliders without output
  

• + add value to every slider without output
  parameters:
  • V added value
    type: float
    required: True
    
• - subtract value from every slider without output
  parameters:
  • V subtracted value
    type: float
    required: True
    

---

multiply each slider without output
parameters:

• V multiplied value
  type: float
  required: True
  

• / divide each slider without output
  parameters:
  • V denominator value
    type: float
    required: True
    
• load loads specified preset
  parameters:
  • IDX preset index
    type: int
    required: True
    
• store stores specified preset
  parameters:
  • IDX preset index
    type: int
    required: True
    
• clear clears specified preset
  parameters:
  • IDX preset index
    type: int
    required: True
    
• interp interplolates between presets
  parameters:
  • IDX preset fraction index
    type: float
    required: True
    
• pos set UI element position
  parameters:

  • X top left x-coord
    type: float
    required: True
    

  • Y top right y-coord
    type: float
    required: True
    

properties:

• @count Get/set number of sliders
  type: int
  range: 1..1024
  default: 8
  

• @min Get/set minimal value
  type: float
  default: 0
  

• @max Get/set maximum value
  type: float
  default: 1
  

• @range (readonly) Get value range
  type: float
  default: 1
  

• @value (readonly) Get sliders value
  type: list
  

• @auto_count Get/set if set numbers of sliders equal to input list length
  type: bool
  default: 0
  

• @auto_range_mode Get/set if calculate @min/@max values automatically
  type: symbol
  enum: none, both, min, max
  default: none
  

• @show_range Get/set if show slider range
  type: bool
  default: 1
  

• @show_lines Get/set if show slider ruler lines
  type: bool
  default: 0
  

• @presetname Get/set preset name for using with [ui.preset]
  type: symbol
  default: (null)
  

• @send Get/set send destination
  type: symbol
  default: (null)
  

• @receive Get/set receive source
  type: symbol
  default: (null)
  

• @size Get/set element size (width, height pair)
  type: list
  default: 150 100
  

• @pinned Get/set pin mode. if 1 - put element to the lowest level
  type: bool
  default: 0
  

• @mouse_events Get/set mouse events output mode. If on outputs @mouse_down, @mouse_up and @mouse_drag events
  type: bool
  default: 0
  

• @slider_color Get/set slider color (list of red, green, blue values in 0-1 range)
  type: list
  default: 0.75 0.75 0.75 1
  

• @select_color Get/set selection color (list of red, green, blue values in 0-1 range)
  type: list
  default: 0 0.75 1 1
  

• @background_color Get/set element background color (list of red, green, blue values in 0-1 range)
  type: list
  default: 0.93 0.93 0.93 1
  

• @border_color Get/set border color (list of red, green, blue values in 0-1 range)
  type: list
  default: 0.6 0.6 0.6 1
  

• @fontsize Get/set fontsize
  type: int
  range: 4..100
  default: 11
  

• @fontname Get/set fontname
  type: symbol
  enum: Courier, DejaVu, Helvetica, Monaco, Times
  default: Helvetica
  

• @fontweight Get/set font weight
  type: symbol
  enum: normal, bold
  default: normal
  

• @fontslant Get/set font slant
  type: symbol
  enum: roman, italic
  default: roman
  

• @label Get/set label text
  type: symbol
  default: (null)
  

• @label_color Get/set label color in RGB format within 0-1 range, for example: 0.2 0.4 0.1
  type: list
  default: 0 0 0 1
  

• @label_inner Get/set label position (1 - inner, 0 - outer).
  type: bool
  default: 0
  

• @label_align Get/set label horizontal align
  type: symbol
  enum: left, center, right
  default: left
  

• @label_valign Get/set label vertical align
  type: symbol
  enum: top, center, bottom
  default: top
  

• @label_side Get/set label snap side
  type: symbol
  enum: left, top, right, bottom
  default: top
  

• @label_margins Get/set label offset in pixels
  type: list
  default: 0 0
  

inlets:

• outputs sliders position
  type: control

outlets:

• list of slider values
  type: control

keywords:

ui slider

See also: [ui.slider] [ui.preset]

Authors: Alex Nadzharov, Serge Poltavsky

License: GPL3 or later