תחביר MIDI

OnSong משתמש בתחביר מבוסס-טקסט להבעת פקודות MIDI. למרות שאתה יכול להשתמש בMIDI Events בעורך המטא-נתונים, אתה יכול גם להבעת פקודות 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 היא פקודת המשך.
• F0 הקדים הודעת SysEx.
• WAIT מיישם השהיה.

ערכים

ערך הפקודה מופיע ממש לפני הסמל @ או בסוף הערך אם לא ניתן @. זהו הערך של שינוי התוכנית, שינוי הבקרה, ההערה, או בחירת השיר על בסיס הקידומת. במקרה של ערכי SysEx, הערך ההקסדצימלי של SysEx ניתן ישירות אחרי קידומת F0 המשמשת כחוזה לכל פקודות SysEx.

ערכים-משנים

בחלק מהמקרים, מידע נוסף מועביר בפקודת MIDI כערכים-משנים. לדוגמה, MSB ו-LSB, כמו גם מהירות של ערכי בקרה יכולה להישלח בדרך זו. זה מתבטא באמצעות הוספת קולון בחלק הערך. לערך-משני יש הקשר שונה בהתאם לסוג פקודת MIDI המשלוחה:

• שינוי תוכנית כולל ערכים-משנים המיושרים עם ה-MSB/LSB של שינוי התוכנית. ערכים אלה מופרדים על ידי נקודה כשה-MSB בצד שמאל וה-LSB בצד ימין.
• שינוי בקרה כולל את הערך של הבקרה המוגדרת בעזרת זה. המספר יכול להיות בין 0 ל-127. אם מושמט, הערך של 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 עם מספר. המספר יכול להיות ערך מספר שלם. אתה יכול להגדיר שניות להמתנה כ-1-10, או להגדיר כמילישניות. הדברים הבאים מראים כיצד להמתין 2 שניות, 10 שניות וחצי שנייה.

WAIT2, WAIT10, WAIT500