feat: add Joe Easton's mod for S4Mk3 screens

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/AdvancedScreen.qml

@@ -0,0 +1,69 @@
+import QtQuick 2.15
+
+import './CSI' as CSI
+import './Screens/Defines' as Defines
+import './Screens/S4MK3/Views' as Views
+import './Screens/S4MK3' as S4MK3
+
+//----------------------------------------------------------------------------------------------------------------------
+//  S4MK3 Screen - manage top/bottom deck of one screen
+//----------------------------------------------------------------------------------------------------------------------
+
+Item {
+    id: screen
+
+    required property bool isLeftScreen
+
+    //--------------------------------------------------------------------------------------------------------------------
+
+    readonly property int topDeckId: isLeftScreen ? 1 : 2
+    readonly property int bottomDeckId: isLeftScreen ? 3 : 4
+    property bool propTopDeckFocus: true
+
+    Defines.Font {id: fonts}
+    Defines.Utils {id: utils}
+    Defines.Settings {id: settings}
+    Defines.Durations {id: durations}
+    Views.Colors {id: colors}
+
+    property int deckA: settings.deckAColour
+    property int deckB: settings.deckBColour
+    property int deckC: settings.deckCColour
+    property int deckD: settings.deckDColour
+
+    Component.onCompleted: {
+        if (engine.getSetting("useSharedDataAPI")) {
+            engine.makeSharedDataConnection(screen.onSharedDataUpdate)
+        }
+    }
+
+    function onSharedDataUpdate(data) {
+        if (typeof data === "object" && typeof data.group === "object") {
+            propTopDeckFocus = data.group[isLeftScreen ? 'leftdeck' : 'rightdeck'] === `[Channel${screen.topDeckId}]`
+        }
+    }
+
+    width: 320
+    height: 240
+    clip: true
+
+    /*
+      A screen is visible if -
+      The deck is in focus and the linked deck is not selecting a sample slot
+      OR
+      The deck is not in focus but a sample slot is selected
+    */
+    S4MK3.DeckScreen {
+        id: topDeckScreen
+        deckId: topDeckId
+        visible: propTopDeckFocus
+        anchors.fill: parent
+    }
+
+    S4MK3.DeckScreen {
+        id: bottomDeckScreen
+        deckId: bottomDeckId
+        visible: !propTopDeckFocus
+        anchors.fill: parent
+    }
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/CSI/Common/DeckHelpers.js

@@ -0,0 +1,54 @@
+
+// Returns a color for the specified Deck index
+/**
+ *
+ * @param deckIdx
+ */
+function colorForDeck(deckIdx) {
+    switch (deckIdx) {
+    case 1:
+    case 2:
+        // Deck A and B are color-coded in Blue
+        return Color.Blue;
+
+    case 3:
+    case 4:
+        // Deck C and D are color-coded in Orange
+        return Color.LightOrange;
+    }
+
+    // Fall-through...
+    return Color.Black;
+}
+
+// primary decks default to track, secondary decks default to remix
+/**
+ *
+ * @param deckIdx
+ */
+function defaultTypeForDeck(deckIdx) {
+    return (deckIdx > 2) ? DeckType.Remix : DeckType.Track;
+}
+
+/**
+ *
+ * @param deckType
+ */
+function deckTypeSupportsGridAdjust(deckType) {
+    return deckType == DeckType.Track || deckType == DeckType.Stem;
+}
+
+/**
+ *
+ * @param deckIdx
+ */
+function linkedDeckIdx(deckIdx) {
+    switch (deckIdx) {
+    // Deck A and C are linked
+    case 0: return 2;
+    case 2: return 0;
+    // Deck B and D are linked
+    case 1: return 3;
+    case 3: return 1;
+    }
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/CSI/S4MK3/S4MK3Functions.js

@@ -0,0 +1,83 @@
+
+// Returns a color for the specified Deck index
+/**
+ *
+ * @param deckId
+ * @param deckA
+ * @param deckB
+ * @param deckC
+ * @param deckD
+ */
+function colorForDeck(deckId, deckA, deckB, deckC, deckD) {
+    switch (deckId) {
+    case 1: return colorForDeckSingle(deckA);
+    case 2: return colorForDeckSingle(deckB);
+    case 3: return colorForDeckSingle(deckC);
+    case 4: return colorForDeckSingle(deckD);
+    }
+}
+
+/**
+ *
+ * @param deck
+ */
+function colorForDeckSingle(deck) {
+    if (deck === 0) { return Color.Red; } else if (deck === 1) { return Color.DarkOrange; } else if (deck === 2) { return Color.LightOrange; } else if (deck === 3) { return Color.White; } else if (deck === 4) { return Color.Yellow; } else if (deck === 5) { return Color.Lime; } else if (deck === 6) { return Color.Green; } else if (deck === 7) { return Color.Mint; } else if (deck === 8) { return Color.Cyan; } else if (deck === 9) { return Color.Turquoise; } else if (deck === 10) { return Color.Blue; } else if (deck === 11) { return Color.Plum; } else if (deck === 12) { return Color.Violet; } else if (deck === 13) { return Color.Purple; } else if (deck === 14) { return Color.Magenta; } else if (deck === 15) { return Color.Fuchsia; } else if (deck === 16) { return Color.Black; } else if (deck === 17) { return Color.WarmYellow; } else { return Color.White; }
+}
+
+/**
+ *
+ * @param deck
+ */
+function colorForDeckSingle2(deck) {
+    if (deck === 0) { return Color.Red; } else if (deck === 1) { return Color.DarkOrange; } else if (deck === 2) { return Color.LightOrange; } else if (deck === 3) { return Color.White; } else if (deck === 4) { return Color.Yellow; } else if (deck === 5) { return Color.Lime; } else if (deck === 6) { return Color.Green; } else if (deck === 7) { return Color.Mint; } else if (deck === 8) { return Color.Cyan; } else if (deck === 9) { return Color.Turquoise; } else if (deck === 10) { return Color.Blue; } else if (deck === 11) { return Color.Plum; } else if (deck === 12) { return Color.Violet; } else if (deck === 13) { return Color.Purple; } else if (deck === 14) { return Color.Magenta; } else if (deck === 15) { return Color.Fuchsia; } else if (deck === 16) { return Color.WarmYellow; } else { return Color.White; }
+}
+
+/**
+ *
+ * @param key
+ * @param masterKey
+ */
+function colorKey(key, masterKey) {
+    if (key === "1m" || "1M") { if (masterKey === "12m" || "12M" || "2m" || "2M") { return true; } } else { return false; }
+}
+
+// primary decks default to track, secondary decks default to remix
+/**
+ *
+ * @param deckIdx
+ */
+function defaultTypeForDeck(deckIdx) {
+    return (deckIdx > 2) ? DeckType.Remix : DeckType.Track;
+}
+
+/**
+ *
+ * @param deckType
+ */
+function deckTypeSupportsGridAdjust(deckType) {
+    return deckType === DeckType.Track || deckType === DeckType.Stem;
+}
+
+/**
+ *
+ * @param val
+ */
+function select(val) {
+    return Math.round(val * 45);
+}
+
+/**
+ *
+ * @param deckIdx
+ */
+function linkedDeckIdx(deckIdx) {
+    switch (deckIdx) {
+    // Deck A and C are linked
+    case 0: return 2;
+    case 2: return 0;
+    // Deck B and D are linked
+    case 1: return 3;
+    case 3: return 1;
+    }
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/FooterPage.qml

@@ -0,0 +1,31 @@
+pragma Singleton
+
+import QtQuick 2.15
+
+// Constants to use in enables based on active footer page
+QtObject {
+    readonly property int empty: 0
+    readonly property int filter: 	1
+    readonly property int pitch: 	2
+    readonly property int fxSend: 	3
+    readonly property int fx: 	4
+    readonly property int midi: 	5
+    readonly property int volume: 6
+    readonly property int slot1: 7
+    readonly property int slot2: 8
+    readonly property int slot3: 9
+    readonly property int slot4: 10
+
+    readonly property variant states: [ "EMPTY"
+                                       , "FILTER"
+                                       , "PITCH"
+                                       , "FX SEND"
+                                       , "FX"
+                                       , "MIDI"
+                                       , "VOLUME"
+                                       , "SLOT 1"
+                                       , "SLOT 2"
+                                       , "SLOT 3"
+                                       , "SLOT 4"
+    ]
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/FxOverlay.qml

@@ -0,0 +1,15 @@
+pragma Singleton
+
+import QtQuick 2.15
+
+// Constants to use in enables based on active overlay
+QtObject {
+    readonly property int upper_button_1: 0
+    readonly property int upper_button_2: 1
+    readonly property int upper_button_3: 2
+    readonly property int upper_button_4: 3
+    readonly property int lower_button_1: 4
+    readonly property int lower_button_2: 5
+    readonly property int lower_button_3: 6
+    readonly property int lower_button_4: 7
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/Overlay.qml

@@ -0,0 +1,29 @@
+pragma Singleton
+
+import QtQuick 2.15
+
+// Constants to use in enables based on active overlay
+QtObject {
+    readonly property int none: 0
+    readonly property int bpm: 1
+    readonly property int key: 2
+    readonly property int fx: 3
+    readonly property int quantize: 4
+    readonly property int slice: 5
+    readonly property int sorting: 6
+    readonly property int capture: 7
+    readonly property int browserWarnings: 8
+    readonly property int swing: 9
+
+    readonly property variant states: [ "none"
+                                       , "bpm"
+                                       , "key"
+                                       , "fx"
+                                       , "quantize"
+                                       , "slice"
+                                       , "sorting"
+                                       , "capture"
+                                       , "browserWarnings"
+                                       , "swing"
+    ]
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/PadsMode.qml

@@ -0,0 +1,75 @@
+pragma Singleton
+
+import QtQuick 2.15
+import '..' as CSI
+
+QtObject {
+    readonly property int disabled: 0
+    readonly property int hotcues: 1
+    readonly property int remix: 2
+    readonly property int stems: 3
+    readonly property int freeze: 4
+    readonly property int loop: 5
+    readonly property int favorite: 6
+    readonly property int roll: 7
+    readonly property int jump: 8
+    readonly property int fx1:	 9
+    readonly property int fx2:	 10
+    readonly property int tone:	 11
+    readonly property int fxBank1: 12
+    readonly property int fxBank2: 13
+    readonly property int fxBank3: 14
+    readonly property int fxBank4: 15
+
+    function isPadsModeSupported(padMode, deckType) {
+        switch(padMode) {
+            case disabled:
+                return deckType == DeckType.Live
+            case hotcues:
+                return deckType == DeckType.Stem || deckType == DeckType.Track;
+            case remix:
+                return deckType == DeckType.Remix;
+            case stems:
+                return deckType == DeckType.Stem;
+            case freeze:
+                return deckType == DeckType.Stem || deckType == DeckType.Track;
+            case loop:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case jump:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case favorite:
+                return deckType == DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case roll:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case fx1:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case fx2:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case tone:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track;
+            case fxBank1:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case fxBank2:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case fxBank3:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+            case fxBank4:
+                return deckType != DeckType.Live || deckType == DeckType.Stem || deckType == DeckType.Track || deckType == DeckType.Remix;
+        }
+    }
+
+    function defaultPadsModeForDeck(deckType) {
+
+        switch(deckType) {
+            case DeckType.Stem:
+                return stems;
+            case DeckType.Remix:
+                return remix;
+            case DeckType.Track:
+                return hotcues;
+            case DeckType.Live:
+                default:
+                    return disabled;
+        }
+    }
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/ScreenView.qml

@@ -0,0 +1,9 @@
+pragma Singleton
+
+import QtQuick 2.15
+
+QtObject {
+    readonly property int deck: 0
+    readonly property int browser: 1
+    readonly property int settings: 2
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/StemStyle.qml

@@ -0,0 +1,9 @@
+pragma Singleton
+
+import QtQuick 2.15
+
+// Constants to use in enables based on active overlay
+QtObject {
+    readonly property int track: 0
+    readonly property int daw: 1
+}

res/controllers/TraktorKontrolS4MK3Screens/S4MK3/Defines/qmldir

@@ -0,0 +1,6 @@
+singleton Overlay     Overlay.qml
+singleton FxOverlay   FxOverlay.qml
+singleton FooterPage  FooterPage.qml
+singleton StemStyle   StemStyle.qml
+singleton ScreenView  ScreenView.qml
+singleton PadsMode    PadsMode.qml