cslider : creates a slider, and its own graph line, for time-varying controls — Cecilia 5.4.1 documentation

# cslider : creates a slider, and its own graph line, for time-varying controls

## Initline

    cslider(name='slider', label='Pitch', min=20.0, max=20000.0, init=1000.0,
            rel='lin', res='float', gliss=0.025, unit='x', up=False,
            func=None, midictl=None, half=False, col='red', help='')

## Description

When created, the slider is stacked in the slider pane of the main Cecilia window in the order it is defined. The value of the slider is passed to the module with a variable named self.name. The up argument passes the value of the slider 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 portamento is automatically set to 0 if up is True. The resolution of the slider can be set to int or float using the res argument. 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.

If up is set to True, the cslider will not create an audio rate signal, but will call a method named widget_name + ‘_up’. This method must be defined in the class Module. For a cslider with the name ‘grains’, the method should be declared like this:

    def grains_up(self, value):

Every time a slider is defined with up set to False, a corresponding graph line is automatically defined for the grapher in the Cecilia interface. The recording and playback of an automated slider is linked to its graph line.

## Parameters

> name: str

>   Name of the slider.

> label: str

>   Label shown in the slider label and the grapher popup.

> min: float

>   Minimum value of the slider.

> max: float

>   Maximum value of the slider.

> init: float

>   Slider’s initial value.

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

>   Slider scaling. Defaults to ‘lin’.

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

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

> func: list of tuples

>   Initial automation in break-points format (serie of time/value points). Times must be in increasing order between 0 and 1.

> midictl: int

>   Automatically map a midi controller to this slider. Defaults to None.

> half: boolean

>   Determines if the slider is full-width or half-width. Set to True to get half-width slider. Defaults to False.

> col: str

>   Color of the widget.

> help: str

>   Help string shown in the cslider tooltip.