ONSONG CHARTS AVAILABLE NOW! LEARN MORE HERE
מדריך המשתמש
תחביר 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 היא פקודת המשך.
- F0 מקדימה הודעת SysEx.
ערכים
ערך הפקודה מופיע ממש לפני סמל @ או בסוף הערך אם לא ניתן @. זה הערך של שינוי התוכנית, שינוי בקרה, הערה, או בחירת שיר בהתאם לקידומת. במקרה של ערכי 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% בכל הערוצים.