mapping files for Hercules DJControl Inpulse 300

res/controllers/Hercules-DJControl-Inpulse-300-script.js

@@ -0,0 +1,197 @@
+// DJControl_Inpulse_300_script.js
+//
+// ***************************************************************************
+// * Mixxx mapping script file for the Hercules DJControl Inpulse 300.
+// * Author: DJ Phatso, contributions by Kerrick Staley
+// * Version 1.2 (March 2020)
+// * Forum: https://www.mixxx.org/forums/viewtopic.php?f=7&t=12599
+// * Wiki: https://mixxx.org/wiki/doku.php/hercules_djcontrol_inpulse_300
+//
+// Changes to v1.2
+// - Code cleanup.
+//
+// Changes to v1.1
+// - Fix seek-to-start and cue-master behavior.
+// - Tweak scratch, seek, and bend behavior.
+// - Controller knob/slider values are queried on startup, so MIXXX is synced.
+// - Fixed vinyl button behavior the first time it's pressed.
+//
+// v1.0 : Original forum release
+//
+// TO DO: Functions that could be implemented to the script:
+//
+// * ROLL: Keep SLIP active (if already enabled) when exiting from rolls
+//
+// * SLICER/SLICER LOOP
+//
+// * TONEPLAY
+//
+// * FX:
+//  	- See how to preselect effects for a rack
+// ****************************************************************************
+var DJCi300 = {};
+///////////////////////////////////////////////////////////////
+//                       USER OPTIONS                        //
+///////////////////////////////////////////////////////////////
+
+// How fast scratching is.
+DJCi300.scratchScale = 1.0;
+
+// How much faster seeking (shift+scratch) is than scratching.
+DJCi300.scratchShiftMultiplier = 4;
+
+// How fast bending is.
+DJCi300.bendScale = 1.0;
+
+// Other scratch related options
+DJCi300.kScratchActionNone = 0;
+DJCi300.kScratchActionScratch = 1;
+DJCi300.kScratchActionSeek = 2;
+DJCi300.kScratchActionBend = 3;
+
+DJCi300.vuMeterUpdateMaster = function(value, _group, _control) {
+    value = (value * 122) + 5;
+    midi.sendShortMsg(0xB0, 0x40, value);
+    midi.sendShortMsg(0xB0, 0x41, value);
+};
+
+DJCi300.vuMeterUpdateDeck = function(value, group, _control, _status) {
+    value = (value * 122) + 5;
+    var status = (group === "[Channel1]") ? 0xB1 : 0xB2;
+    midi.sendShortMsg(status, 0x40, value);
+};
+
+DJCi300.init = function() {
+    // Scratch button state
+    DJCi300.scratchButtonState = true;
+    // Scratch Action
+    DJCi300.scratchAction = {
+    1: DJCi300.kScratchActionNone,
+    2: DJCi300.kScratchActionNone
+    };
+
+    // Turn On Vinyl buttons LED(one for each deck).
+    midi.sendShortMsg(0x91, 0x03, 0x7F);
+    midi.sendShortMsg(0x92, 0x03, 0x7F);
+
+    //Turn On Browser button LED
+    midi.sendShortMsg(0x90, 0x04, 0x05);
+
+   //Softtakeover for Pitch fader
+   engine.softTakeover("[Channel1]", "rate", true);
+   engine.softTakeover("[Channel2]", "rate", true);
+   engine.softTakeoverIgnoreNextValue("[Channel1]", "rate");
+   engine.softTakeoverIgnoreNextValue("[Channel2]", "rate");
+
+   // Connect the VUMeters
+    engine.connectControl("[Channel1]", "VuMeter", "DJCi300.vuMeterUpdateDeck");
+	engine.getValue("[Channel1]", "VuMeter", "DJCi300.vuMeterUpdateDeck");
+    engine.connectControl("[Channel2]", "VuMeter", "DJCi300.vuMeterUpdateDeck");
+	engine.getValue("[Channel2]", "VuMeter", "DJCi300.vuMeterUpdateDeck");
+    engine.connectControl("[Master]", "VuMeterL", "DJCi300.vuMeterUpdateMaster");
+    engine.connectControl("[Master]", "VuMeterR", "DJCi300.vuMeterUpdateMaster");
+	engine.getValue("[Master]", "VuMeterL", "DJCi300.vuMeterUpdateMaster");
+    engine.getValue("[Master]", "VuMeterR", "DJCi300.vuMeterUpdateMaster");
+
+    // Ask the controller to send all current knob/slider values over MIDI, which will update
+    // the corresponding GUI controls in MIXXX.
+    midi.sendShortMsg(0xB0, 0x7F, 0x7F);
+};
+
+// The Vinyl button, used to enable or disable scratching on the jog wheels (One per deck).
+DJCi300.vinylButton = function(_channel, _control, value, status, _group) {
+    if (value) {
+        if (DJCi300.scratchButtonState) {
+            DJCi300.scratchButtonState = false;
+            midi.sendShortMsg(status, 0x03, 0x00);
+        } else {
+            DJCi300.scratchButtonState = true;
+            midi.sendShortMsg(status, 0x03, 0x7F);
+        }
+    }
+};
+
+DJCi300._scratchEnable = function(deck) {
+    var alpha = 1.0/8;
+    var beta = alpha/32;
+    engine.scratchEnable(deck, 248, 33 + 1/3, alpha, beta);
+};
+
+DJCi300._convertWheelRotation = function(value) {
+    // When you rotate the jogwheel, the controller always sends either 0x1
+    // (clockwise) or 0x7F (counter clockwise). 0x1 should map to 1, 0x7F
+    // should map to -1 (IOW it's 7-bit signed).
+    return value < 0x40 ? 1 : -1;
+};
+
+// The touch action on the jog wheel's top surface
+DJCi300.wheelTouch = function(channel, control, value, _status, _group) {
+    var deck = channel;
+    if (value > 0) {
+        //  Touching the wheel.
+        if (engine.getValue("[Channel" + deck + "]", "play") !== 1 || DJCi300.scratchButtonState) {
+            DJCi300._scratchEnable(deck);
+            DJCi300.scratchAction[deck] = DJCi300.kScratchActionScratch;
+        } else {
+            DJCi300.scratchAction[deck] = DJCi300.kScratchActionBend;
+        }
+    } else {
+        // Released the wheel.
+        engine.scratchDisable(deck);
+        DJCi300.scratchAction[deck] = DJCi300.kScratchActionNone;
+    }
+};
+
+// The touch action on the jog wheel's top surface while holding shift
+DJCi300.wheelTouchShift = function(channel, control, value, _status, _group) {
+    var deck = channel - 3;
+    // We always enable scratching regardless of button state.
+    if (value > 0) {
+        DJCi300._scratchEnable(deck);
+        DJCi300.scratchAction[deck] = DJCi300.kScratchActionSeek;
+    } else {
+        // Released the wheel.
+        engine.scratchDisable(deck);
+        DJCi300.scratchAction[deck] = DJCi300.kScratchActionNone;
+    }
+};
+
+// Scratching on the jog wheel (rotating it while pressing the top surface)
+DJCi300.scratchWheel = function(channel, control, value, status, _group) {
+    var deck;
+    switch (status) {
+    case 0xB1:
+    case 0xB4:
+        deck  = 1;
+        break;
+    case 0xB2:
+    case 0xB5:
+        deck  = 2;
+        break;
+    default:
+        return;
+    }
+    var interval = DJCi300._convertWheelRotation(value);
+    var scratchAction = DJCi300.scratchAction[deck];
+    if (scratchAction === DJCi300.kScratchActionScratch) {
+        engine.scratchTick(deck, interval * DJCi300.scratchScale);
+    } else if (scratchAction === DJCi300.kScratchActionSeek) {
+        engine.scratchTick(deck,
+            interval *  DJCi300.scratchScale *
+            DJCi300.scratchShiftMultiplier);
+    } else {
+        engine.setValue(
+            "[Channel" + deck + "]", "jog", interval * DJCi300.bendScale);
+    }
+};
+
+// Bending on the jog wheel (rotating using the edge)
+DJCi300.bendWheel = function(channel, control, value, _status, _group) {
+    var interval = DJCi300._convertWheelRotation(value);
+    engine.setValue(
+        "[Channel" + channel + "]", "jog", interval * DJCi300.bendScale);
+};
+
+DJCi300.shutdown = function() {
+    midi.sendShortMsg(0xB0, 0x7F, 0x00);
+};