מדריך המשתמש

תחביר MIDI

OnSong משתמש בתחביר מבוסס-טקסט להבעת פקודות MIDI. בעוד שאתה יכול להשתמש בתוך אירועי MIDI בעורך המטא-דאטה, אתה יכול גם להבע פקודות MIDI בטקסט.

ערכים מתוחמים

בראש ובראשונה, ניתן להפריד בין מספר פקודות MIDI בתווים שונים כולל: תו tab, פסיק, נקודה-פסיק, צינור אנכי, או שורה חדשה. הפסיק הוא התוחם הנפוץ ביותר. לדוגמה:

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

ערוץ

כל רשומה עשויה להכיל סמל @. הערך המספרי אחרי הסמל הוא הערוץ שעליו יש לשלוח את הפקודה. מכיוון שערוצים ב-MIDI מתחילים בעל, ערוץ אחד יהיה אפס (0), ערוץ שניים יהיה אחד (1), וכו'.

אם לא משתמשים בסמל @, הפקודה משולחת או מתקבלת בכל הערוצים.

קידומות

כל רשומה ברשימה מכילה קידומת. קידומת זו קובעת איזה סוג של פקודת MIDI לשלוח. אלה כוללות:

PC או ללא קידומת הוא אירוע שינוי תוכנית.
N הוא אירוע הערה
CC הוא אירוע שינוי בקרה.
NRPN הוא מספר פרמטר שאינו רשום.
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

OnSong 2023 — עדכון אחרון ב-March 11, 2020