renoise.Instrument Instrument

Constants
Properties
Functions
- clear (self)
- copy_from (self, renoise.Instrument)
- macro (self, integer) -> renoise.InstrumentMacro
- insert_phrase_at (self, integer) -> renoise.InstrumentPhrase
- delete_phrase_at (self, integer)
- phrase (self, integer) -> renoise.InstrumentPhrase
- can_insert_phrase_mapping_at (self, integer) -> boolean
- insert_phrase_mapping_at (self, integer, renoise.InstrumentPhrase) -> renoise.InstrumentPhraseMapping
- delete_phrase_mapping_at (self, integer)
- phrase_mapping (self, integer) -> renoise.InstrumentPhraseMapping
- insert_sample_at (self, integer) -> renoise.Sample
- delete_sample_at (self, integer)
- swap_samples_at (self, integer, integer)
- sample (self, integer) -> renoise.Sample
- sample_mapping (self, renoise.Instrument.Layer, integer) -> renoise.SampleMapping
- insert_sample_modulation_set_at (self, integer) -> renoise.SampleModulationSet
- delete_sample_modulation_set_at (self, integer)
- swap_sample_modulation_sets_at (self, any, any)
- sample_modulation_set (self, integer) -> renoise.SampleModulationSet
- insert_sample_device_chain_at (self, integer) -> renoise.SampleDeviceChain
- delete_sample_device_chain_at (self, integer)
- swap_sample_device_chains_at (self, integer, integer)
- sample_device_chain (self, integer) -> renoise.SampleDeviceChain

Constants

Tab

{
    TAB_SAMPLES: integer = 1,
    TAB_PLUGIN: integer = 2,
    TAB_EXT_MIDI: integer = 3,
}

PhrasePlaybackMode

{
    PHRASES_OFF: integer = 1,
    PHRASES_PLAY_SELECTIVE: integer = 2,
    PHRASES_PLAY_KEYMAP: integer = 3,
}

Layer

{
    LAYER_NOTE_DISABLED: integer = 0,
    LAYER_NOTE_ON: integer = 1,
    LAYER_NOTE_OFF: integer = 2,
}

OverlapMode

{
    OVERLAP_MODE_ALL: integer = 0,
    OVERLAP_MODE_CYCLED: integer = 1,
    OVERLAP_MODE_RANDOM: integer = 2,
}

NUMBER_OF_MACROS : `integer`

MAX_NUMBER_OF_PHRASES : `integer`

Properties

active_tab : `renoise.Instrument.Tab`

Currently active tab in the instrument GUI (samples, plugin or MIDI).

active_tab_observable : `renoise.Document.Observable`

READ-ONLY

name : `string`

Instrument’s name.

name_observable : `renoise.Document.Observable`

READ-ONLY

comments : `string[]`

Instrument’s comment list. See renoise.song().comments for more info on how to get notified on changes and how to change it.

comments_observable : `renoise.Document.Observable`

READ-ONLY

comments_assignment_observable : `renoise.Document.Observable`

READ-ONLY

show_comments_after_loading : `boolean`

Set this to true to show the comments dialog after loading a song

show_comments_after_loading_observable : `renoise.Document.Observable`

READ-ONLY

macros_visible : `boolean`

Macro parameter pane visibility in the GUI.

macros_visible_observable : `renoise.Document.Observable`

READ-ONLY

macros : `renoise.InstrumentMacro[]`

Macro parameters. Array with size Instrument.NUMBER_OF_MACROS. READ-ONLY

pitchbend_macro : `renoise.InstrumentMacro`

Access the MIDI pitch-bend macro

modulation_wheel_macro : `renoise.InstrumentMacro`

Access the MIDI modulation-wheel macro

channel_pressure_macro : `renoise.InstrumentMacro`

Access the MIDI channel pressure macro

volume : `number`

Global linear volume of the instrument. Applied to all samples, MIDI and plugins in the instrument. Range: (0 - math.db2lin(6))

volume_observable : `renoise.Document.Observable`

READ-ONLY

transpose : `integer`

Range: (-120 - 120). Global relative pitch in semi tones. Applied to all samples, MIDI and plugins in the instrument.

transpose_observable : `renoise.Document.Observable`

READ-ONLY

trigger_options : `renoise.InstrumentTriggerOptions`

Global trigger options (quantization and scaling options).

sample_mapping_overlap_mode : `renoise.Instrument.OverlapMode`

Sample mapping’s overlap trigger mode.

sample_mapping_overlap_mode_observable : `renoise.Document.Observable`

READ-ONLY

phrase_editor_visible : `boolean`

Phrase editor pane visibility in the GUI.

phrase_editor_visible_observable : `renoise.Document.Observable`

READ-ONLY

phrase_playback_mode : `renoise.Instrument.PhrasePlaybackMode`

Phrase playback.

phrase_playback_mode_observable : `renoise.Document.Observable`

READ-ONLY

phrase_program : `integer`

Phrase playback program: 0 = Off, 1-126 = specific phrase, 127 = keymap.

phrase_program_observable : `renoise.Document.Observable`

READ-ONLY

phrases : `renoise.InstrumentPhrase[]`

READ-ONLY

phrases_observable : `renoise.Document.ObservableList`

READ-ONLY

phrase_mappings : `renoise.InstrumentPhraseMapping[]`

READ-ONLY

phrase_mappings_observable : `renoise.Document.ObservableList`

READ-ONLY

samples : `renoise.Sample[]`

READ-ONLY

samples_observable : `renoise.Document.ObservableList`

READ-ONLY

sample_mappings : `renoise.SampleMapping[]`

Sample mappings (key/velocity to sample slot mappings). sample_mappings[LAYER_NOTE_ON/OFF][]. Sample mappings also can be accessed via —@field samples[].sample_mapping

sample_mappings_observable : `renoise.Document.ObservableList`

READ-ONLY

sample_modulation_sets : `renoise.SampleModulationSet[]`

READ-ONLY

sample_modulation_sets_observable : `renoise.Document.ObservableList`

READ-ONLY

sample_device_chains : `renoise.SampleDeviceChain[]`

READ-ONLY

sample_device_chains_observable : `renoise.Document.ObservableList`

READ-ONLY

midi_input_properties : `renoise.InstrumentMidiInputProperties`

READ-ONLY

midi_output_properties : `renoise.InstrumentMidiOutputProperties`

READ-ONLY

plugin_properties : `renoise.InstrumentPluginProperties`

READ-ONLY

Functions

clear(self)

Reset, clear all settings and all samples.

copy_from(self, instrument : `renoise.Instrument`)

Copy all settings from the other instrument, including all samples.

macro(self, index : `integer`)

->instrument_macro : renoise.InstrumentMacro

Range: (1 - renoise.Instrument.NUMBER_OF_MACROS) Access a single macro by index. See also property macros.

insert_phrase_at(self, index : `integer`)

->new_phrase : renoise.InstrumentPhrase

Insert a new phrase behind the given phrase index (1 for the first one).

delete_phrase_at(self, index : `integer`)

Delete a new phrase at the given phrase index.

phrase(self, index : `integer`)

->renoise.InstrumentPhrase

Access a single phrase by index. Use properties ‘phrases’ to iterate over all phrases and to query the phrase count.

can_insert_phrase_mapping_at(self, index : `integer`)

->boolean

Returns true if a new phrase mapping can be inserted at the given phrase mapping index (see See renoise.song().instruments[].phrase_mappings). Passed phrase must exist and must not have a mapping yet. Phrase note mappings may not overlap and are sorted by note, so there can be max 119 phrases per instrument when each phrase is mapped to a single key only. To make up room for new phrases, access phrases by index, adjust their note_range, then call ‘insert_phrase_mapping_at’ again.

insert_phrase_mapping_at(self, index : `integer`, phrase : `renoise.InstrumentPhrase`)

->new_mapping : renoise.InstrumentPhraseMapping

Insert a new phrase mapping behind the given phrase mapping index. The new phrase mapping will by default use the entire free (note) range between the previous and next phrase (if any). To adjust the note range of the new phrase change its ‘new_phrase_mapping.note_range’ property.

delete_phrase_mapping_at(self, index : `integer`)

Delete a new phrase mapping at the given phrase mapping index.

phrase_mapping(self, index : `integer`)

->renoise.InstrumentPhraseMapping

Access to a phrase note mapping by index. Use property ‘phrase_mappings’ to iterate over all phrase mappings and to query the phrase (mapping) count.

insert_sample_at(self, index : `integer`)

->new_sample : renoise.Sample

Insert a new empty sample. returns the new renoise.Sample object. Every newly inserted sample has a default mapping, which covers the entire key and velocity range, or it gets added as drum kit mapping when the instrument used a drum-kit mapping before the sample got added.