Module Descriptions
The DH_MatrixPak consists of 3 modules. DH_MatrixInput displays the matrix, and accepts input from the user. DH_Matrix8X8 and DH_Matrix16X16 apply the values from the matrix to the modulation or other control voltage signals.
This module provides the graphical user interface (GUI) that the user uses to control how much of each source gets sent to each destination. Here's a quick rundown of its input and output pins:
Matrix Values - Sends the current values of the matrix to one
or more matrix processing modules (see below). Because SynthEdit limits the
amount of data that can be sent on one pin, there are 5 Matrix Values pins.
These are used from the top down, as needed, depending on the number of
non-zero entries in the matrix. 2 pins are sufficient for an 8X8 matrix; use
all 5 with a DH_Matrix16X16.
# Sources - The number of inputs in the matrix. By default, the number of
rows.
# Targets - The number of outputs in the matrix. By default, the number of columns.
Swap Rows/Cols - Transposes the matrix so that columns
represent sources, and rows represent targets.
Bkgd RGB, Text RGB -- RGB values of background and text colors. Use
-1 for a transparent background.
Note: These are integer composite RGB values. They can be set easily using either a DH_Text to RGB, which allows entry of red, green and blue color components as numbers between 0 and 255, or a DH_ColorPicker, which lets you select a color from a standard Windows color selector dialog. Both are included in the DH_Sub-ControlPak, and may be used within SynthEdit for free, without requiring registration.
Font - List of 11 widely distributed fonts.
Font Size - List of selected font sizes.
Vertical Spacing - Amount of space per row. Adjust this to enhance visual
clarity and/or to line rows up with labels.
Horizontal Spacing - Amount of space per column. Adjust this to enhance visual clarity and/or to line columns up with labels.
Min Value - The minimum value for the numbers in the matrix.
Max Value - The maximum value for the numbers in the matrix.
Default Value - The value to which numbers in the matrix will be reset when they are double-clicked, or on Reset All.
Number Width (chars) - The number of characters reserved for displaying a number in the matrix. Can be used together with Horizontal Spacing to align columns.
Decimal Places - How many decimal places to display (0, 1 or 2).
Leading Zeros - If set to TRUE, numbers are padded with zeros to fit the Number Width.
Hide Zeros - If set to TRUE, zero entries will not be displayed.
Horiz Lines - If set to TRUE, horizontal lines separate the rows.
Reset All - Sets all numbers in the matrix to
the default value.
DH_Matrix8X8
Calculates what percentage of each source input is sent to each target output. For each source-target pair, it applies the value from the corresponding location in the connected DH_MatrixInput module as a percent to the input, and accumulates the results for each target¹. All calculations are performed at the audio sample rate.²
Matrix
Array In - Current matrix values from a DH_MatrixInput module (use both).
Source 1 .. 8 - Inputs from modulation sources (or other origins).
Target 1 .. 8 - Outputs to be sent to modulation targets (or other destinations).
Identical to the DH_Matrix8X8, but has pins for up to 16 sources and 16 targets, and has 5 Matrix Array In pins (use all 5).
¹ For efficiency reasons, the actual calculation includes only source-target pairs with non-zero matrix entries; the others are known to be zero, and so can safely be ignored.
² SSE instructions are used when possible to speed up calculations.