Array Custom Pane (Panel Edit)

The Array control allows an array of identical parameters to be edited by one control. this could be used with a wavetable synthesizer that generates output based on 256 programmable samples. The array control is able to access all 256 samples and edit them

Array Parameters

This control is a little different from standard controls when calling the Retrieve, Store, and Transmit Common macros.

Number of Elements

This parameter specifies the number of parameters in the SysEx that are to be edited by this control. For example, if you wanted to edit 256 samples of a wave sample, you would enter "256".

Pixels Per Element

Specifies the number of pixels assigned to edit each element

Element Width

Specifies the number of pixels assigned to draw the element. This should be less than or equal to the Pixels Per Element parameter. If this value is smaller than Pixels Per Element there will be a space between the drawing of each element.

Element Variable

This is a critical parameter! When the Retrieve, Store, Transmit, and Activate macros are called, the specified variable will contain the value of the currently selected element. For example, set this parameter to "10" and V10 will contain the value of the element currently being edited. Access macros will look something like this

Retrieve Macro

MW = 5            ; the value to edit starts at offset 5

MW + V10        ; add the offset to the parameter being edited (assume that each element is a byte in size

FR X W            ; read the value

RET X                ; return the value

Store Macro

MW = 5            ; the value to edit starts at offset 5

MW + V10        ; add the offset to the parameter being edited

FS X W            ; store the current value

Center Value

Enter the value considered to be the "0" value. This will usually be 0 but in the case of sample editing, the range may be 0 - 255 where the center value is 128. Values less than 128 will be drawn down from the 128 center point instead of up.

Use Popup Menu

Enable the popup menu. Not currently supported.

Background

Specify the type of background used by the control

Display Style

Select the type of display to use

Background Bitmap

Specify a custom bitmap to draw into the background of the control

Element Bitmap

Specify a custom bitmap to use when drawing the value of each element in the control (non-edited value)

Element (Edited)

Specify a custom bitmap to use when drawing the value of each element in the control (edited value)

Rounding

Check to round the edges of the control

Make Transparent

Check to make the control transparent

Transparent Color

Specify the color to indicate transparency

Selected Pos ID

ID of the control that specifies the currently selected position in the array. A display update message is sent to the control with this ID as the selected position of the changed

Offset Correction

is a value, if required to have the display select focus line up properly

Available in: