MusiKraken
MusiKraken
Experimental MIDI Controller Construction Kit

Barcode Tracking

This module tracks all kinds of barcodes (including QR codes) in front of the camera.

You can assign any trigger (chords or other MIDI events) to each barcode, and use parameters like x- and y-position, size and angle as parameters.

Barcode tracking works best when you use simple and large enough barcodes (QR codes work quite well), and if you don't move the camera too fast sideways. To also support sideway movements better, there is also the option to combine it with rectangle tracking (you can enable this in the settings). In this case, when the barcode is no longer detected (mostly because the camera is blurred when the camera is moving too fast), it checks if there is a rectangle nearby with a similar location and size, and if yes, it will track this for a short while to fill the gap.

By default, only one barcode can be active (the one closest to the camera center), but you can change this in the settings to have multiple barcodes active simultaneously.

Ports:

MIDIOut:

All MIDI events generated when barcodes are detected are sent out through this port.

osc:

Sends out raw barcode information that can be sent via OSC.


Per registered barcode, there are the following output ports:

X:

The x-position of this barcode on the camera image:

Range: 0.0 to 1.0

Y:

The y-position of this barcode on the camera image:

Range: 0.0 to 1.0

Size:

The size of this barcode on the camera image:

Range: 0.0 to 1.0

Angle:

The angle of this barcode (not all barcode types have a defined up direction, but for example works well for QR codes):

Range: -1.0 to 1.0

Settings:

Colors: Tap on the plus sign to register a new color. Then tap the new button to enter the settings for that color.

Combine with rectangle tracking: When enabled, once the detection of a barcode is lost, it will search for nearby rectangles with similar size, and temporarily track these, until the original QR codes are found again. This improves faster sideway movements, when only one barcode is visible.

Only one barcode can be active: When enabled, only one barcode can be active simultaneously. Disable this when all detected barcodes should be active.

Barcodes: Here you can add and remove barcodes. Tapping on the barcode name will open up the barcode settings where you can define the payload, scan in barcodes and define actions to each barcode.