Matrix - Midi Mix

A matrix module specialized to mix data.

WIP

Cells values of the matrix are contained in a data array row by row (row1, row2, row3…).

Different mouse mode are available to interact with cells.

num of cols

Slider (in/out) : how many columns for the matrix

  • from 1 to 128
  • default : 4

num of rows

Slider (in/out) : how many rows number for the matrix

  • from 1 to 128
  • default : 4

matrix size

Datafield (out) : size of the matrix, deducted from num of cols and num of rows

  • from 1 to 16384
  • default : 16

mouse mode

Combobox (in) : mode of the mouse interaction with cells

  • toggle : mouse click toggle the cell value to 0 or cell draw val
  • fade : mouse move (up/down) shift the cell value between 0 and cell draw val
  • draw : mouse move
  • lock : the matrix is mouse locked, no mouse interaction
  • edit : the matrix is mouse locked, but last click col, last click row and last click sel event are fired
  • default : toggle

cell draw val

Slider (in/out) : template value for the mouse interaction with cells

  • from 0 to 1
  • default : 1

randomize

Button (in) set cells to random values.

  • in fade mode : between 0 and cell draw val.
  • other mode : 0 or cell draw val.

last click col

Data field (out) : The last cell column clicked

last click row

Data field (out) : The last cell row clicked

last click cel

Data field (out) : The last cell index clicked

reset

Button (in) : reset all cells to the reset val value.

reset val

Slider (in) : the template value for the reset button.

cells val

Array (in) : input array to populate the matrix cells.

the cells range values should be between 0 and 1.

cells out

Array (out) : output array containing the matrix cells values.

cells color

Color chooser (in/out) : colors array to populate the matrix cells.

cells border color

Color chooser (in/out) : colors array to populate the matrix cells border.

cells caption

Comma text (in/out) : Comma text array to populate the matrix cells captions.

where

Determines where the display panel is visible:

  • invisible : the panel is invisible
  • ctrl panel : in the control panel
  • parent ctrl panel : in the control panel of the parent patch if it exists
  • top ctrl panel : in the control panel of the top parent patch (main patch) if it exists
  • container : in the container of the current patch
  • parent container : in the container of the parent patch current patch
  • top parent container : in the container of the top parent patch patch
  • IB: visible in the interface builder mode only

when the location is set to a container which doesn’t exist in the patch, Usine try to find, in parent patches, the first container available. If no container is available an error message is displayed.

mouse dwn

Gives the mouse state of the control: 1 if the mouse is pressed 0 otherwise. In multi-touch configuration, can be an array of [0..1] values. See Getting Multi-touch infos in Patches.

mouse X

Gives the mouse X position on the the control in relative coordinates:

  • 0 most left,
  • 1 most right.

In multi-touch configuration, can be an array of [0..1] values. See Getting Multi-touch infos in Patches.

mouse Y

Gives the mouse Y position on the the control in relative coordinates:

  • 0 top,
  • 1 bottom.

In multi-touch configuration, can be an array of [0..1] values. See Getting Multi-touch infos in Patches.

gesture

Gives information about the last gesture applied on the control. See Getting Gesture Info.

bitmap in

Background bitmap input. See Manipulate Bitmaps.

bitmap out

Bitmap output. See Manipulate Bitmaps.

drop file name

Name of the dropped file. See Using drag & drop.

allow drop

Enables or disables the drag&drop possibilities on the panel. See Using drag & drop.

dbl click

Send a 1 value if the user has double clicked on the control.

panel X

Gives the X position of the top left corner of the panel in the parent panel (container or control panel). See Floating Panels.

panel Y

Gives the Y position of the top left corner of the panel in the parent panel (container or control panel). See Floating Panels.

hint

Hint string of the control. See Hint Strings.

edit layout

Opens the layout window. See Use the Layout window.

caption

Displayed caption of the control.

manual/modules/users/matrix_midi.txt · Last modified: 2013/04/19 04:23 (external edit)