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

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

## Initline

    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='')

## Description

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.

## Parameters

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