csplitter : creates a multi-knobs slider used to split the spectrum in sub-regions


csplitter(name='splitter', label='Pitch', min=20.0, max=20000.0,
          init=[500.0, 2000.0, 5000.0], rel='log', res='float',
          gliss=0.025, unit='x', up=False, num_knobs=3, col='red', help='')


When created, the splitter is stacked in the slider pane of the main Cecilia window in the order it is defined. The values of the splitter slider are passed to the module with a variable named self.name. The knob values are collected using self.name[0] to self.name[num-knobs-1]. The up argument passes the values of the splitter on mouse up if set to True or continuously if set to False. The gliss argument determines the duration of the portamento (in seconds) applied between values. The resolution of the splitter slider can be set to int or float using the res argument. The slider color can be set using the col argument and a color value. However, sliders with up set to True are greyed out and the col argument is ignored.

The csplitter is designed to be used with the FourBand() object in order to allow multi-band processing. Although the FourBand() parameters can be changed at audio rate, it is not recommended. This filter is CPU intensive and can have erratic behavior when boundaries are changed too quickly.


name: str

Name of the splitter slider.

label: str

Label shown in the csplitter label.

min: float

Minimum value of the splitter slider.

max: float

Maximum value of the splitter slider.

init: list of float

Splitter knobs initial values. List must be of length num_knobs. Defaults to [500.0, 2000.0, 5000.0].

rel: str {‘lin’, ‘log’}

Splitter slider scaling. Defaults to ‘lin’.

res: str {‘int’, ‘float’}

Splitter slider resolution. Defaults to ‘float’

gliss: float

Portamento between values in seconds. Defaults to 0.025.

unit: str

Unit symbol shown in the interface.

up: boolean

Value passed on mouse up if True. Defaults to False.

num_knobs: int

Number of junction knobs. Defaults to 3.

col: str

Color of the widget.

help: str

Help string shown in the csplitter tooltip.