spessasynth_lib 3.23.13 → 3.24.0

package/synthetizer/worklet_system/message_protocol/message_sending.js

@@ -6,7 +6,7 @@ import { NON_CC_INDEX_OFFSET } from "../worklet_utilities/controller_tables.js";
 /**
  * Calls synth event from the worklet side
  * @param eventName {EventTypes} the event name
- * @param eventData {any}
+ * @param eventData {EventCallbackData}
  * @this {SpessaSynthProcessor}
  */
 export function callEvent(eventName, eventData)

package/synthetizer/worklet_system/worklet_methods/system_exclusive.js

@@ -36,6 +36,16 @@ function getTuning(byte1, byte2, byte3)
     return { midiNote: midiNote, centTuning: fraction * 0.0061 };
 }
 
+/**
+ * The text types for the synth display
+ * @enum {number}
+ */
+export const SynthDisplayType = {
+    SoundCanvasText: 0,
+    XGText: 1,
+    SoundCanvasDotDisplay: 2
+};
+
 
 /**
  * Executes a system exclusive
@@ -471,6 +481,56 @@ export function systemExclusive(messageData, channelOffset = 0)
                 notRecognized();
                 return;
             }
+            else if (messageData[2] === 0x45 && messageData[3] === 0x12)
+            {
+                // 0x45: GS Display Data, 0x12: DT1 (Device Transmit)
+                // check for embedded copyright
+                // (roland SC display sysex) http://www.bandtrax.com.au/sysex.htm
+                
+                if (
+                    messageData[4] === 0x10 && // Sound Canvas Display
+                    messageData[6] === 0x00    // Data follows
+                )
+                {
+                    if (messageData[5] === 0x00) // Display letters
+                    {
+                        // get the text
+                        // and header ends with (checksum) F7
+                        const text = new Uint8Array(messageData.slice(7, messageData.length - 2));
+                        this.callEvent(
+                            "synthdisplay",
+                            {
+                                displayData: text,
+                                displayType: SynthDisplayType.SoundCanvasText
+                            }
+                        );
+                    }
+                    else if (messageData[5] === 0x01) // Matrix display
+                    {
+                        // get the data
+                        // and header ends with (checksum) F7
+                        const dotMatrixData = new Uint8Array(messageData.slice(7, messageData.length - 3));
+                        this.callEvent(
+                            "synthdisplay",
+                            {
+                                displayData: dotMatrixData,
+                                displayType: SynthDisplayType.SoundCanvasDotDisplay
+                            }
+                        );
+                        SpessaSynthInfo(
+                            `%cRoland SC Display Dot Matrix via: %c${arrayToHexString(
+                                messageData)}`,
+                            consoleColors.info,
+                            consoleColors.value
+                        );
+                    }
+                    else
+                    {
+                        // this is some other GS sysex...
+                        notRecognized();
+                    }
+                }
+            }
             else if (messageData[2] === 0x16 && messageData[3] === 0x12 && messageData[4] === 0x10)
             {
                 // this is a roland master volume message
@@ -495,6 +555,7 @@ export function systemExclusive(messageData, channelOffset = 0)
                 );
                 return;
             }
+            break;
         
         // yamaha
         // http://www.studio4all.de/htmle/main91.html
@@ -615,6 +676,22 @@ export function systemExclusive(messageData, channelOffset = 0)
                             );
                     }
                 }
+                else if (
+                    messageData[3] === 0x06 && // XG System parameter
+                    messageData[4] === 0x00    // System Byte
+                )
+                {
+                    // displayed letters (remove F7 at the end)
+                    // include byte 5 as it seems to be line information (useful)
+                    const textData = new Uint8Array(messageData.slice(5, messageData.length - 1));
+                    this.callEvent(
+                        "synthdisplay",
+                        {
+                            displayData: textData,
+                            displayType: SynthDisplayType.XGText
+                        }
+                    );
+                }
                 else if (this.system === "xg")
                 {
                     SpessaSynthWarn(

package/utils/other.js

@@ -29,8 +29,10 @@ export function formatTitle(fileName)
     return fileName
         .trim()
         .replaceAll(".mid", "")
+        .replaceAll(".kar", "")
         .replaceAll(".rmi", "")
-        .replaceAll("_", " ");
+        .replaceAll("_", " ")
+        .trim();
 }
 
 /**
@@ -52,6 +54,31 @@ export function arrayToHexString(arr)
     return hexString;
 }
 
+/**
+ * @param eventData {Uint8Array}
+ * @returns {Uint8Array}
+ */
+export function sanitizeKarLyrics(eventData)
+{
+    // for KAR files:
+    // https://www.mixagesoftware.com/en/midikit/help/HTML/karaoke_formats.html
+    // "/" is the newline character
+    // "\" is also the newline character
+    // "\" ASCII code is 92
+    // "/" ASCII code is 47
+    // newline ASCII code is 10
+    const sanitized = [];
+    for (let byte of eventData)
+    {
+        if (byte === 47 || byte === 92)
+        {
+            byte = 10;
+        }
+        sanitized.push(byte);
+    }
+    return new Uint8Array(sanitized);
+}
+
 export const consoleColors = {
     warn: "color: orange;",
     unrecognized: "color: red;",