מדריך המשתמש
תחביר MIDI
OnSong משתמש בתחביר מבוסס-טקסט לביטוי פקודות MIDI. אמנם אתה יכול להשתמש בMIDI Events בMetadata Editor, אך אתה יכול גם לבטא פקודות 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 נשלח במקום זאת. אנו נשלח Control Change 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
