Read out key range in Mainstage via scripter?

Question

Hey people,
I just realized, that scripter seems to be a powerful plugin.
Anyways I didn't find a "detailed" tutorial to the scripter. I found the documentation of apple called "mainstage effects" and it says a bit about the scripter. But I'm wondering (for example), which parameters is the scripter able to get with the function GetParameters? There is no list in the internet, which shows the possible or processable parameters.
The main thing I'm interested in:
Mainstage has a pretty good workflow. But it's anoying that it's not possible to assign the learn-buttons for key ranges to buttons. This would be nice, if I can create two buttons that handle this.
And another thing:
Is the scripter able to read out the key range which is set in the channelstrip and send it out the lowest and highest key as single CC command? (I'm right now into creating a key-light-system, based on to what Native Instruments implemented in their new keyboards).
Thank you very much,
Chris

Answer 1

Here's script for Scripter with a Learn button.
It has an extra parameter for learning.
Hope this helps!
DaCaptain
>>>>>>>
// limit pitch range of notes
var activeNotes = [];
function ParameterChanged(param, value)
    switch(param)
    {                          // if it's the slider you just created
       case 0:  HandleMIDI.maxPitch = value; break;
       case 1:  HandleMIDI.minPitch = value; break;
       case 2:  HandleMIDI.learnState = value;  break;   
function HandleMIDI(event)
  if (event instanceof NoteOn)
    if(HandleMIDI.learnState != 1)
      var pitch = event.pitch;
  if(HandleMIDI.learnState == 0) // first note
     HandleMIDI.minPitch = pitch;
     HandleMIDI.learnState = -1;
     SetParameter('Minimum Pitch', pitch);
  else if(HandleMIDI.learnState == -1)
       HandleMIDI.maxPitch = pitch;    
       SetParameter('Learn', 1); 
       SetParameter('Maximum Pitch', pitch);
  if (event.pitch > HandleMIDI.maxPitch)
  return undefined;  // don't send if too high
  if (event.pitch < HandleMIDI.minPitch)
  return undefined;  // don't send if too low
  else {
  activeNotes.push(event);
  event.send()
  else if (event instanceof NoteOff) {
  for (i=0; i < activeNotes.length; i++) {
  if (event.pitch == activeNotes[i].pitch) {
  event.send();
  activeNotes.splice(i,1);
  break;
  else { // pass non-note events through
  event.send();
var PluginParameters = [
  { name:'Maximum Pitch', type:'lin',
  minValue:0, maxValue:127, numberOfSteps:127, defaultValue:115},
  { name:'Minimum Pitch', type:'lin',
  minValue:0, maxValue:127, numberOfSteps:127, defaultValue:30},
  {name:"Learn", type:"menu", valueStrings:["On", "Off"],
  defaultValue:1}