Changes Script Output Display

Changes : oL= n, oR= n

The Output Display commands allow you to see the values of Changes script variables or expressions as the script runs. This can be helpful during development of a script, to understand how different values affect the performance.

There are separate Left and Right Output Displays at the bottom of the Pitch-to-MIDI dialog dialog, which are hidden until invoked by an Output Display command.

oL= n sends the value of n to the Left display, and oR= n sends it to the Right.

n may be any variable or expression, including oscillators, random values, User variables, Buffer note values, and computer keyboard key states.

If, instead of a numerical value for n you use the character s, the display will show the value of the current pseudo-random seed. If true random mode is active instead (the default), the displayed value will be 0.

Alternatively, you may use a quoted string in place of a numerical value, as in oL= "1st Movement". The quotes are mandatory, but are not shown in the display. The display window holds about 22 characters; strings longer than the display can hold are cut off at the right end. However, the characters are still present and can be highlighted and copied.

You can highlight the Output Display text or value and use CTRL+C to copy it to the Windows clipboard. You can then use CTRL+V to paste it into a separate text editor like Windows Notepad, or the Daqarta Notes Editor, or into a Changes script.

For example, you may have a script that uses random values to set some parameter. If you monitor the parameter value during a performance, you may discover certain values that are particularly useful. You may want to modify the script to use such a value as a constant in place of a random value.

To monitor a random-value parameter, you should set a User variable with the random value, then set the parameter with the User variable, and also send that same User variable to an Output Display. That assures that the same random value is used for both the parameter and the display.

For instance, if you are setting Note Range Max to a random value between 50 and 100 for Voice 2, you could use:

UA=?(50,100) rM2=UA oL=UA

The above example is for an integer parameter. However, if you are setting an oscillator or observing its output, you may wish to use lower-case User variables which support decimal fractions. To see the full value including the decimal part, use oLf= n or oRf= n.

Similarly, for some integer values such as the seed for the pseudo-random generator mode, you may prefer to have the display show hexadecimal format via oLh= n or oRh= n.

You can interpret integers as Instrument Numbers and tell the display to show the corresponding name with oLi= n or oRi= n. If the integer is outside the normal 0-127 General MIDI Instrument range, the display will show "Unknown".

Similarly, you can show the integer as a Percussion Instrument Number via oLp= n or oRp= n. If the integer is outside the 27-87 range of General MIDI Percussion instruments, the display will show "Unknown".

oLn= n or oRn= n show the integer n as a note name. For example, 60 will be shown as ' C4'. Negative values are shown as "Unknown", while positive values greater than 127 are shown as "Off".

The Output Displays are re-hidden when the performance is ended by toggling Pitch-to-MIDI On/Off to Off. Since the displays may be changing during the performance, you can use Pause to momentarily halt things while you examine or copy the display values.

See also Changes Script Overview, Changes Script Editor, MIDI Voice Setup Dialogs, Pitch-to-MIDI dialog, Pitch Track Toolbox - Overview