Σύνταξη MIDI

Το OnSong χρησιμοποιεί μια σύνταξη βάσης κειμένου για την έκφραση εντολών MIDI. Ενώ μπορείτε να χρησιμοποιήσετε τα Γεγονότα MIDI στον Επεξεργαστή Μεταδεδομένων, μπορείτε επίσης να εκφράσετε εντολές MIDI σε κείμενο.

Οριοθετημένες Τιμές

Πρώτα και κύρια, πολλαπλές εντολές MIDI μπορούν να διαχωριστούν από διάφορους χαρακτήρες συμπεριλαμβανομένων: ενός χαρακτήρα tab, κόμματος, ερωτηματικού, κατακόρυφης γραμμής ή νέας γραμμής. Το κόμμα είναι ο πιο κοινός διαχωριστής. Για παράδειγμα:

1.2:0@0, PC1.2:3@0, N67@1, START, SS8

Κανάλι

Κάθε καταχώρηση μπορεί να περιέχει ένα σύμβολο @. Η αριθμητική τιμή μετά το σύμβολο είναι το κανάλι στο οποίο πρόκειται να σταλεί η εντολή. Δεδομένου ότι τα κανάλια στο MIDI ξεκινούν από το μηδέν, το κανάλι ένα θα ήταν ένα μηδέν (0), το κανάλι δύο ένα (1), κ.λπ.

Εάν δεν χρησιμοποιηθεί το σύμβολο @, η εντολή αποστέλλεται ή λαμβάνεται σε όλα τα κανάλια.

Προθέματα

Κάθε καταχώρηση στη λίστα περιέχει ένα πρόθεμα. Αυτό το πρόθεμα καθορίζει τι είδος εντολής MIDI θα αποσταλεί. Αυτά περιλαμβάνουν:

• PC ή Χωρίς Πρόθεμα είναι ένα γεγονός αλλαγής προγράμματος.
• N είναι ένα γεγονός σημείωσης
• CC είναι ένα γεγονός αλλαγής ελέγχου.
• NRPN είναι ένας αριθμός μη εγγεγραμμένης παραμέτρου.
• SS είναι ένα γεγονός επιλογής τραγουδιού.
• START είναι εντολή έναρξης.
• STOP είναι εντολή διακοπής.
• CONTINUE είναι εντολή συνέχειας.
• WAIT περιμένει ένα συγκεκριμένο χρονικό διάστημα πριν αποστείλει περισσότερα γεγονότα.
• F0 προθέτει ένα μήνυμα SysEx.
• @ προθέτει μια ετικέτα καθολικού MIDI.

Τιμές

Η τιμή της εντολής εμφανίζεται ακριβώς πριν το σύμβολο @ ή στο τέλος της καταχώρησης εάν δεν δοθεί @. Αυτή είναι η τιμή της αλλαγής προγράμματος, αλλαγής ελέγχου, σημείωσης ή επιλογής τραγουδιού με βάση το πρόθεμα. Στην περίπτωση καταχωρήσεων SysEx, η δεκαεξαδική τιμή του SysEx παρέχεται απευθείας μετά το πρόθεμα F0 το οποίο χρησιμοποιείται ως κεφαλίδα για όλες τις εντολές SysEx.

Δευτερεύουσες Τιμές

Σε ορισμένες περιπτώσεις, πρόσθετες πληροφορίες μεταφέρονται στην εντολή MIDI ως δευτερεύουσες τιμές. Για παράδειγμα, MSB και LSB, καθώς και ταχύτητα τιμών ελέγχου μπορούν να σταλούν με αυτόν τον τρόπο. Αυτό εκφράζεται μέσω της προσθήκης ενός κόλονου στο τμήμα τιμής. Η δευτερεύουσα τιμή έχει διαφορετικό πλαίσιο ανάλογα με τον τύπο της εντολής MIDI που αποστέλλεται:

• Αλλαγή Προγράμματος έχει δευτερεύουσες τιμές που ευθυγραμμίζονται με το MSB/LSB της αλλαγής προγράμματος. Αυτές οι τιμές διαχωρίζονται με μια τελεία με το MSB στα αριστερά και το LSB στα δεξιά.
• Αλλαγή Ελέγχου έχει την τιμή του ελέγχου που ορίστηκε χρησιμοποιώντας αυτό. Ο αριθμός μπορεί να είναι μεταξύ 0 και 127. Εάν παραλειφθεί, συμπεραίνεται η τιμή 127. Μπορείτε επίσης να διαχωρίσετε πολλαπλές τιμές με ένα κάτω κάτω για να προχωρήσετε σε τιμές. Για παράδειγμα, 127-0 θα κλειδώσει την τιμή 127 μεταξύ καταστάσεων ενεργοποίησης και απενεργοποίησης.
• Γεγονός Σημείωσης έχει μια δευτερεύουσα τιμή που σχετίζεται με την ταχύτητα με την οποία πρέπει να παίξει η σημείωση. Αυτό μπορεί να οριστεί σε αριθμητική τιμή μεταξύ 0 και 127. Μπορείτε να προχωρήσετε σε πολλαπλές ταχύτητες σημειώσεων διαχωρίζοντάς τες με ένα κάτω κάτω.

Παραδείγματα

Ας ξεκινήσουμε με μια απλή αλλαγή προγράμματος. Σε αυτό το σενάριο χρησιμοποιούμε αλλαγή προγράμματος 8 που αποστέλλει επίσης ένα MSB 4 και ένα LSB 2 στο κανάλι 1. Το παράδειγμα ξεκινά με τη μεγαλύτερη σύνθετη παραλλαγή αυτής και αφαιρεί την επιλογή τράπεζας και το κανάλι για να γίνει πιο ευρύ:

PC3.1:7@0, 3.1:7@0, 3:7@0, 3:7, 7@0, 7

Οι αλλαγές ελέγχου είναι παρόμοιες εκτός ότι η αριστερή πλευρά της σύνταξης είναι ο αριθμός αλλαγής ελέγχου και η δεξιά πλευρά είναι μια προαιρετική τιμή. Εάν η τιμή δεν παρέχεται, αποστέλλεται αντί αυτού το 127. Θα στείλουμε την Αλλαγή Ελέγχου 106 με τιμή 64 στο κανάλι 3.

CC105:63@2, CC105:63. CC105@2, CC105

Τώρα ας ρίξουμε μια ματιά στα γεγονότα σημειώσεων. Θέλουμε να παίξουμε C4 στο κανάλι 8 με ταχύτητα 75%, θα εισάγαμε τα εξής επειδή το OnSong ξεκινά την καταμέτρηση MIDI C0 ως 0 στην κλίμακα σημειώσεων MIDI:

N60:95@7, N60@7, N60:95, N60

Και πάλι, είναι σημαντικό να θυμόμαστε ότι καθώς αφαιρούνται τιμές από τη σύνταξη MIDI, η δήλωση MIDI γίνεται ευρύτερη και λιγότερο συγκεκριμένη. Για παράδειγμα, η τελευταία έκδοση του γεγονότος σημείωσης θα στείλει C4 με ταχύτητα 100% σε όλα τα κανάλια.

Μπορούμε επίσης να καθυστερήσουμε MIDI προσθέτοντας μια εντολή WAIT. Το εξής θα καθυστερήσει το MIDI για 2 δευτερόλεπτα καθώς και 500 ms (μισό δευτερόλεπτο). Μπορείτε να καθορίσετε δευτερόλεπτα ως 1-10 δευτερόλεπτα ή σε χιλιοστά του δευτερολέπτου.

WAIT2, WAIT500

Τέλος, μπορούμε να αναφορά καθολικών MIDI τα οποία είναι προρυθμισμένες λίστες γεγονότων MIDI που μπορούν να αναφορά. Εάν έχετε ένα καθολικό MIDI με "on" ως ετικέτα (χωρίς εισαγωγικά), τότε μπορείτε να αναφορά αυτό το καθολικό με τα εξής:

@on