renoise.InstrumentPhraseScript

• Properties
  • editor_visible : boolean
  • editor_visible_observable : renoise.Document.Observable
  • parameters : renoise.DeviceParameter[]
  • parameters_observable : renoise.Document.ObservableList
  • paragraphs : string[]
  • paragraphs_observable : renoise.Document.DocumentList
  • paragraphs_assignment_observable : renoise.Document.Observable
  • compile_error : string
  • compile_error_observable : renoise.Document.Observable
  • runtime_error : string
  • runtime_error_observable : renoise.Document.Observable
  • pending_changes : integer
  • pending_changes_observable : renoise.Document.Observable
  • committed_observable : renoise.Document.Observable
• Functions
  • parameter(self, index : integer)
  • commit(self)
  • render_to_pattern(self, options : RenderScriptOptions, rendering_done_callback : (string : any``?, integer : any, integer : any))
  • render_to_clipboard(self, options : RenderScriptOptions, rendering_done_callback : (string : any``?, integer : any, integer : any))
• Structs
• RenderScriptOptions
  • Properties
    • lpb : number``?
    • max_events : number``?

Properties

editor_visible : boolean

When false, a preview of the script is shown instead of a text editor.

editor_visible_observable : renoise.Document.Observable

fired, when the editor visibility changed.

parameters : renoise.DeviceParameter[]

READ-ONLY List of script input parameters, if any.

parameters_observable : renoise.Document.ObservableList

fired, when the input parameter set changed.

paragraphs : string[]

Script content. When changing paragraphs, changes are visible in the script editor, but are not applied for playback until they get committed. See also @function commit and @field committed_observable.

paragraphs_observable : renoise.Document.DocumentList

Notifier which is called when a paragraph got added or removed.

paragraphs_assignment_observable : renoise.Document.Observable

Notifier which is called when existing paragraph content changed.

compile_error : string

READ-ONLY When not empty, the script failed to compile. This error text is also visible to the user in the script preview.

compile_error_observable : renoise.Document.Observable

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

runtime_error : string

READ-ONLY When not empty, script compiled successfully, but caused an error while running. This error text is also visible to the user in the script editor.

runtime_error_observable : renoise.Document.Observable

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

pending_changes : integer

READ-ONLY Number of changes since the last commit() or auto-commit call, that have been applied to the parapgraphs. Note: auto-commit only is applied for scripts which are currently edited.

pending_changes_observable : renoise.Document.Observable

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

committed_observable : renoise.Document.Observable

Fired when script paragraph changes got committed: Either by an explicit commit call or via auto-commit in the editor when the script currently is edited. Script compile errors will be set or cleared after the observable fires as the commit & compilation happens asynchroniously in the player engine.

Functions

parameter(self, index : integer)

->renoise.DeviceParameter

Access to a single input parameter by index. Use properties 'parameters' to iterate over all parameters and to query the parameter count.

commit(self)

Commit paragraph changes for playback.

render_to_pattern(self, options : RenderScriptOptions, rendering_done_callback : (string : any?, integer : any, integer : any))

Render script content with the given options to the phrase pattern. Only committed content will be rendered, so make sure to commit changes first. Parameter rendering_done_callback carries along rendering results:

• 1. optional error as string that happened while rendering. nil when succeeded.
• 2. number of successfully rendered raw events (not pattern lines) or 0.
• 3. number of skipped raw events, in case the pattern can't fit all events, or 0.

render_to_clipboard(self, options : RenderScriptOptions, rendering_done_callback : (string : any?, integer : any, integer : any))

Same as render_to_pattern, but rendering into a temporary phrase object in the clipboard, which can then be pasted by the user somewhere.

Structs

RenderScriptOptions

Options for the render functions. All undefined properties will fall back to the user preferences values from the script preview

Properties

lpb : number?

Lines per beat of the target phrase.

max_events : number?

Maximum events (not pattern lines) that will be rendered