Add dedicated message type for MIDI Show Control messages

Applications/MIDIMonitor/SMMMonitorWindowController.m

@@ -633,6 +633,8 @@ - (void)trivialWindowSettingsDidChange
 
 - (void)displayPreferencesDidChange:(NSNotification *)notification
 {
+    [self.displayedMessages makeObjectsPerformSelector:@selector(invalidateDisplayCache)];
+
     [self.messagesTableView reloadData];
 }
 

Frameworks/SnoizeMIDI/SMMessage.h

@@ -151,4 +151,6 @@ extern NSString *SMProgramChangeBaseIndexPreferenceKey;
 - (NSString *)expertDataForDisplay;
 - (NSString *)originatingEndpointForDisplay;
 
+- (void)invalidateDisplayCache;
+
 @end

Frameworks/SnoizeMIDI/SMMessage.m

@@ -530,6 +530,11 @@ - (NSString *)originatingEndpointForDisplay
     }
 }
 
+- (void)invalidateDisplayCache
+{
+    // Do nothing by default. Subclasses that cache results that depend on display preferences should override to invalidate their cache.
+}
+
 @end
 
 

Frameworks/SnoizeMIDI/SMShowControlUtilities.h

@@ -0,0 +1,51 @@
+//
+//  SMShowControlUtilities.h
+//  SnoizeMIDI
+//
+//  Created by Hugo Trippaers on 22/12/2018.
+//
+
+#import <Foundation/Foundation.h>
+
+// Based on the structure described in
+// MIDI Show Control 1.1 pg 6
+typedef struct {
+    int timecodeType;
+    int hours;
+    int minutes;
+    int seconds;
+    int frames;
+    int subframes;
+    int colorFrameBit;
+    int form; // 0 = fractional frames, 1 = status
+    int sign; // 0 = positive, 1 = negative
+    int statusEstimatedCodeFlag;
+    int statusInvalidCode;
+    int statusVideoFieldIndentification;
+} SMTimecode;
+
+/*
+ * Parses the provided bytes into a timecode structure
+ * according to the Timecode format in the MIDI Show
+ * Control 1.1 specification
+ *
+ * Parameters
+ *   NSData *timecodeBytes, object with 5 bytes of timecode data
+ *
+ * Returns
+ *   Timecode, struct with all components contains in the timecode data
+ */
+extern SMTimecode parseTimecodeData(NSData *timecodeData);
+
+/*
+ * Parses the provided bytes into an array with one
+ * string per cue item in the list
+ *
+ * Parameters
+ *   NSData *cueItemsData, object with a variable number of bytes terminated by 0xF7
+ *
+ * Returns
+ *   NSArray *, array containing an NSString * for every cueitem found in the data
+ */
+extern NSArray *parseCueItemsData(NSData *cueItemsData);
+

Frameworks/SnoizeMIDI/SMShowControlUtilities.m

@@ -0,0 +1,52 @@
+//
+//  SMShowControlUtilities.m
+//  SnoizeMIDI
+//
+//  Created by Hugo Trippaers on 22/12/2018.
+//
+
+#import <Foundation/Foundation.h>
+
+#import "SMShowControlUtilities.h"
+
+#define BIT(n)                  ( 1<<(n) )
+#define BIT_MASK(len)           ( BIT(len)-1 )
+#define BITFIELD_MASK(start, len)     ( BIT_MASK(len)<<(start) )
+#define BITFIELD_GET(y, start, len)   ( ((y)>>(start)) & BIT_MASK(len) )
+
+SMTimecode parseTimecodeData(NSData *timecodeData) {
+    SMTimecode timecode;
+    const Byte *byte = timecodeData.bytes;
+    // Hours and type: 0 tt hhhhh
+    timecode.timecodeType = BITFIELD_GET(*byte, 5, 2);
+    timecode.hours = BITFIELD_GET(*byte++, 0, 5);
+
+    // Minutes and color frame bit: 0 c mmmmmm
+    timecode.colorFrameBit = BITFIELD_GET(*byte, 6, 1);
+    timecode.minutes = BITFIELD_GET(*byte++, 0, 5);
+
+    // Seconds: 0 k ssssss
+    timecode.seconds = BITFIELD_GET(*byte++, 0, 5);
+
+    // Frames, byte 5 ident and sign: 0 g i fffff
+    timecode.sign = BITFIELD_GET(*byte, 6, 1);
+    timecode.form = BITFIELD_GET(*byte, 5, 1);
+    timecode.frames = BITFIELD_GET(*byte++, 0, 5);
+
+    if (timecode.form) {
+        // code status bit map:0 e v d xxxx
+        timecode.statusEstimatedCodeFlag = BITFIELD_GET(*byte, 6, 1);
+        timecode.statusInvalidCode = BITFIELD_GET(*byte, 5, 1);
+        timecode.statusVideoFieldIndentification = BITFIELD_GET(*byte, 4, 1);
+    } else {
+        // fractional frames: 0 bbbbbbb
+        timecode.subframes = BITFIELD_GET(*byte, 0, 7);
+    }
+
+    return timecode;
+}
+
+NSArray *parseCueItemsData(NSData *cueItemsData) {
+    NSString *cueItemString = [[NSString alloc] initWithData:cueItemsData encoding:NSASCIIStringEncoding];
+    return cueItemString.length > 0 ? [cueItemString componentsSeparatedByString:@"\0"] : @[];
+}

Frameworks/SnoizeMIDI/SMSystemExclusiveMessage.h

@@ -18,16 +18,6 @@
 
 @interface SMSystemExclusiveMessage : SMMessage
     // TODO Should this be a SMSystemCommonMessage too? Would we gain anything from that?
-{
-    NSData *data;
-    // data does not include the starting 0xF0 or the ending 0xF7 (EOX)
-
-    struct {
-        unsigned int wasReceivedWithEOX:1;
-    } flags;
-
-    NSMutableData *cachedDataWithEOX;
-}
 
 + (SMSystemExclusiveMessage *)systemExclusiveMessageWithTimeStamp:(MIDITimeStamp)aTimeStamp data:(NSData *)aData;
     // data should NOT include the starting 0xF0 or the ending 0xF7 (EOX)