The Api Wishlist Thread

Renoise Tool Development
293

R3.2.4 Win10 x64. (Renoise.Song.API.lua)
The API has no way to select the automatable parameter in the automation editor to display the envelope window. It would be great to have this function: :open_envelope_automation()

renoise.song().tracks[].devices[].parameters[]:open_envelope_automation()

Doc related

    -- Set a new value and write automation when the MIDI mapping
    -- "record to automation" option is set. Only works for parameters
    -- of track devices, not for instrument devices.
    renoise.song().tracks[].devices[].parameters[]:record_value(value)

    -- Not valid for parameters of instrument devices. Returns true if creating
    -- envelope automation is possible for the parameter (see also
    -- renoise.song().patterns[].tracks[]:create_automation)
    renoise.song().tracks[].devices[].parameters[].is_automatable
      -> [read-only, boolean]

    -- Is automated. Not valid for parameters of instrument devices.
    renoise.song().tracks[].devices[].parameters[].is_automated, _observable
      -> [read-only, boolean]

    -- Returns the automation for the given device parameter or nil when there is
    -- none.
    renoise.song().patterns[].tracks[]:find_automation(parameter)
      -> [renoise.PatternTrackAutomation or nil]

image
For example, the action of this function would be exactly the same as pressing the button marked in the screenshot, for the associated parameter. In this case it would be the first parameter of the device.
image

Or, at least select the parameter in the automation editor (without opening the automation editor), so that it displays the associated envelope: :select_envelope_automation()

renoise.song().tracks[].devices[].parameters[]:select_envelope_automation()

The latter would be better.

Edit: This is already covered

– Selected parameter in the automation editor. Can be nil.
– When setting a new parameter, parameter must be automateable and
– must be one of the currently selected track device chain.
renoise.song().selected_automation_parameter, _observable
– Example:
renoise.song().selected_automation_parameter=renoise.song():track():device():parameter()

Thanks to @KanetonKiller for reporting on this!

Edit2: There is only one problem with this matter. Active/Bypassed cannot be selected.
The Active/Bypassed state does not appear to be considered “a parameter” of the device. It is a parameter with its properties, but it does not have an index to access it. Therefore it has no index. Could it be worth 0? So it would be possible to select it like this (…device():parameter(0)) :

renoise.song().selected_automation_parameter=renoise.song():track():device():parameter(0)
2 Likes