תחביר 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