renoise.PatternTrackAutomation

Graphical automation of a device parameter within a pattern track.

General remarks: Automation "time" is specified in lines + optional 1/256 line fraction for the sub line grid. The sub line grid has 256 units per line. All times are internally quantized to this sub line grid. For example a time of 1.5 means: line 1 with a note column delay of 128

Constants
- Playmode
Properties
Functions
Local Structs
EnvelopePoint
- Properties

Constants

Playmode

{
    PLAYMODE_POINTS: integer = 1,
    PLAYMODE_LINES: integer = 2,
    PLAYMODE_CURVES: integer = 3,
}

Properties

dest_device : `renoise.AudioDevice`

Destination device. Can in some rare circumstances be nil, i.e. when a device or track is about to be deleted.

dest_parameter : `renoise.DeviceParameter`

Destination device's parameter. Can in some rare circumstances be nil, i.e. when a device or track is about to be deleted.

length : `integer`

Range: (1 - NUM_LINES_IN_PATTERN)

playmode : `renoise.PatternTrackAutomation.Playmode`

play-mode (interpolation mode).

playmode_observable : `renoise.Document.Observable`

Track changes to document properties or general states by attaching listener functions to it.

points : `EnvelopePoint`[]

Get all points of the automation. When setting a new list of points, items may be unsorted by time, but there may not be multiple points for the same time. Returns a copy of the list, so changing points[1].value will not do anything. Instead, change them via points = { modified_points }.

points_observable : `renoise.Document.ObservableList`

Track changes to document lists by attaching listener functions to it. NB: Notifiers will not broadcast changes made to list items, but only changes to the lists layout (items got added, removed, swapped).

selection_end : `integer`

Range: (1 - automation.length + 1)

selection_end_observable : `renoise.Document.Observable`

Track changes to document properties or general states by attaching listener functions to it.

selection_range : `integer`[]

Get or set selection range. when setting an empty table, the existing selection, if any, will be cleared. array of two numbers [] OR Range: (1 - automation.length + 1)

selection_range_observable : `renoise.Document.Observable`

Track changes to document properties or general states by attaching listener functions to it.

selection_start : `integer`

Range: (1 - automation.length + 1)

selection_start_observable : `renoise.Document.Observable`

Track changes to document properties or general states by attaching listener functions to it.

Functions

add_point_at(self, time : `integer`, value : `number`, scaling : `number?`)

Insert a new point, or change an existing one, if a point in time already exists.

clear(self)

Removes all points from the automation. Will not delete the automation from tracks[]:automation, instead the resulting automation will not do anything at all.