Crear controles del módulo MIDI Scripter de MainStage

Este apartado describe el uso del editor de scripts para crear controladores de interfaz estándar, como reguladores y menús, para tus módulos Scripter. La única propiedad que debes definir obligatoriamente para un parámetro nuevo es “name”. El valor por omisión es un regulador básico. Además, puedes utilizar otras propiedades para cambiar el tipo y el comportamiento de los controles.

Propiedades opcionales

type: Escribe una de las siguientes cadenas como valor:
- “lin”: Crea un fader lineal.
- “log”: Crea un fader logarítmico.
- “momentary”: Crea un botón momentáneo.
- “menu”: Crea un menú.
  El tipo “menu” requiere una propiedad valueStrings adicional, que es un conjunto de cadenas que aparecerán en el menú. Consulta el script de Tutorial 13.
defaultValue: Escribe un número entero o de coma flotante para definir un valor por omisión. Si no se escribe ningún valor, el valor por omisión será 0.0.
minValue: Escribe un número entero o de coma flotante para definir un valor mínimo. Si no se escribe ningún valor, el valor por omisión será 0.0.
maxValue: Escribe un número entero o de coma flotante para definir un valor máximo. Si no se escribe ningún valor, el valor por omisión será 1.0.
numberOfSteps: Escribe un número entero para definir el número de pasos.
unit: Escribe una cadena para presentar una descripción de unidad en los controles del módulo. Si no introduces ningún valor, no se mostrará ninguna unidad por omisión.
text: Escribe texto para crear un divisor o una cabecera en la interfaz de usuario del módulo.

Carga el ajuste de Tutorial correspondiente para ver el script en el editor de scripts. Esto te ayudará a entender la estructura de la sintaxis y la disposición del código y los comentarios. Consulta Usar el editor de scripts del módulo MIDI Scripter de MainStage.

Script de Tutorial 11: Creación de regulador

En MainStage, escribe lo siguiente en la ventana “Script Editor” para crear un regulador denominado “Parameter x” con un intervalo por omisión de 0 a 1. Se configura en el valor de punto medio de 0,5.

var PluginParameters = [{name:"Parameter x", defaultValue:0.5}];

Script de Tutorial 12: Intervalos de regulador

En MainStage, escribe lo siguiente en la ventana “Script Editor” para crear un tipo de regulador lineal, con cinco posibles posiciones (pasos) y un intervalo de 0 a 5.

var PluginParameters = [{name:"Octaves", defaultValue:3, minValue:0, maxValue:5, numberOfSteps:5, unit:"octaves", type:"lin"}];

Script de Tutorial 13: Creación de menú

En MainStage, escribe lo siguiente en la ventana “Script Editor” para crear un menú denominado Range con las opciones Low, Mid y High.

var PluginParameters = [{name:"Range", type:"menu", valueStrings:["Low", "Mid", "High"]}];

Ocultar o mostrar los controles del módulo MIDI de forma dinámica

Para los scripts complejos de MainStage , puede resultar útil esconder o mostrar los controles de parámetros de manera dinámica, como en un ítem de menú que permita seleccionar la visualización de un grupo de controles. Escribe lo siguiente en la ventana “Script Editor” para crear estos tipos de controlador.

var PluginParameters = [{name:'uno'}, {name:'dos', hidden:true}];
Llama a UpdatePluginParameters() para cambiar esto de forma dinámica.

Recuperar los valores de los parámetros del módulo

Llama a GetParameter() con el nombre del parámetro para devolver un valor (objeto numérico) con el valor actual del parámetro. GetParameter() suele usarse dentro de la función HandleMIDI del módulo MIDI Scripter o Función ProcessMIDI del módulo MIDI Scripter de MainStage.

En MainStage, este código de ejemplo convierte eventos de modulación en eventos de nota y proporciona un regulador para determinar las duraciones de las notas.

El texto situado a continuación de /* muestra los comentarios que explican el código JavaScript.
var PluginParameters = [{name:"Note Length", minValue:0, maxValue: 100, unit:"%"}]; /* create a slider (default range 0 - 100) */function HandleMIDI(event) {if(event instanceof ControlChange && event.number == 1) { /* if event is MIDI cc1 (modwheel) */var note = new NoteOn; /* create a NoteOn object */if(event.value == 0)/* because modwheel range is 0-127 and pitch range is 1-127, convert a modwheel value of 0 to 1 */event.value = 1;note.pitch = event.value; /* use cc value as note pitch */note.velocity = 100; /* use velocity 100 */note.send(); /* send note on */ var off = new NoteOff(note); /* create a NoteOff object that inherits the NoteOn pitch and velocity values */ var delayInBeats = GetParameter("Note Length")/100 + 0.1; /* retrieve the parameter value of the slider you created (add 0.1 to guarantee note on and off are not simultaneous) */ off.sendAfterBeats(delayInBeats); /* send note off after the length in beats is set via the slider */ }}

¿Te resultó útil?

Manual del usuario de MainStage