MIDI In DAT

From TouchDesigner 099 Wiki

Summary

The MIDI In DAT logs all MIDI messages coming into TouchDesigner from a specified MIDI device. It outputs columns in a table format - message, type, channel, index, value.

However general setup is simpler. Once you have MIDI set up via the Dialogs -> MIDI Device Mapper, TouchDesigner is ready to receive MIDI via Select CHOPs that point to /local/maps/map1 for device 1, etc.

See also the MIDI Event DAT, MIDI In Map CHOP, MIDI In CHOP, MIDI Out CHOP, midi command, MIDI Device Mapper Dialog.

PythonIcon.png midiinDAT_Class

Parameters - Connect Page

Active /active - logs MIDI events when turned on.

Device Table /device - path to the MIDI device Table DAT

Device ID /id - specify the id of which device to use. The id can be found in the MIDI Device Mapper Dialog.

Parameters - Filter Page

Skip Sense /skipsense - does not log sense messages when this is turned on.

Skip Timing /skiptiming - does not report timing messages when this is turned on.

Filter Messages /filter - turning this on enables the message filtering parameters below.

Message /message -

Type /type -

Channel /channel -

Index /index -

Value /value -

Parameters - Received Messages Page

Callbacks DAT callback - Runs this script once for each row added to the table (ie. each MIDI event received). See midiinDAT_Class for usage.

Execute From executeloc - Determines the location the script is run from.

  • Current Node current - The script is executed from the current node location (for example, where 'cc' points to).
  • CallbacksDAT callback - The script is executed from the location of the DAT specified in the Callbacks DAT parameter.
  • Specified Operator op - The script is executed from the operator specified in the From Operator parameter below.

From Operator fromop - The operator whose state change will trigger the DAT to execute its script when Execute from is set to Specified Operator. This operator is also the path that the script will be executed from if the Execute From parameter is set to Specified Operator.

Clamp Output clamp - The DAT is limited to 100 messages by default but with Clamp Output, this can be set to anything including unlimited.

Maximum Lines maxlines - Limits the number of messages, older messages are removed from the list first.

Clear Output clear - Deletes all lines except the heading. To clear with a python script op("opname").par.clear.pulse()

Bytes Column bytes - Outputs the raw bytes of the message in a separate column.