Σύνταξη MIDI

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

Διαχωρισμένες Τιμές

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

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

Κανάλι

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

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

Προθέματα

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

• PC ή Χωρίς Πρόθεμα είναι ένα γεγονός αλλαγής προγράμματος.
• N είναι ένα γεγονός σημείωσης
• CC είναι ένα γεγονός αλλαγής ελέγχου.
• 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