appendMidiModule

Description

Function to add a MIDI module in the specified destination layer. The destination layer is determined by its Layer object. For example, this.parent specifies the parent layer of the script module as destination layer. The MIDI module to be added is determined by its MidiModule object. You can use getMidiModule or findMidiModules to determine the desired MIDI module. The new MIDI module will be added behind the existing MIDI modules. To insert a MIDI module at a specific position in the destination layer, use insertMidiModule instead.

Available in: Controller.

Arguments

Example

To explore the following script:

1. Download Program.vstpreset.
2. Drag the preset on the MediaBay to import it to the user folder for VST presets.
3. Create an empty program and add a script module.
4. Paste the script into the text editor of the script module and execute the script.

-- append MIDI module from Program.vstpreset into the current program
   
-- get the file path for user VST presets
path = getUserPresetPath()
   
-- load VST preset
loadedProgram = loadPreset(path.."/Program/Program.vstpreset")
   
-- get the first MIDI module from the loaded program
module = loadedProgram:getMidiModule()
   
-- append MIDI module
if module then
    this.program:appendMidiModule(module)
end