shncat - מקוון בענן

תָכְנִית:

שֵׁם

shntool - כלי רב תכליתי לעיבוד ודיווח נתונים של WAVE

תַקצִיר

shntool מצב ...
shntool [CORE אוֹפְּצִיָה]

תיאור

shntool הוא כלי שורת פקודה לצפייה ו/או שינוי של נתוני ומאפייני WAVE. זה רץ
בכמה מצבי הפעלה שונים, ותומך בפורמטי אודיו שונים ללא הפסדים.

shntool מורכב משלושה חלקים - הליבה שלו, מצב מודולים, ו פוּרמָט מודולים. זֶה
עוזר להקל על התחזוקה של הקוד, כמו גם מסייע למתכנתים אחרים בפיתוח
פונקציונליות חדשה. ארכיון ההפצה מכיל קובץ בשם 'modules.howto'
מתאר כיצד ליצור מודול מצב או פורמט חדש, למי שנוטה כל כך.

מצב מודולים
shntool מבצע פונקציות שונות על נתוני WAVE באמצעות שימוש במודולי מצב. הליבה
of shntool הוא פשוט מעטפת סביב מודולי המצב. למעשה, מתי shntool מתנהל עם
מצב תקף כטיעון הראשון שלו, הוא בעצם מריץ את ההליך העיקרי עבור
מצב שצוין, ויוצא. shntool מגיע עם מספר מצבים מובנים, המתוארים להלן:

לן מציג אורך, גודל ומאפיינים של נתוני PCM WAVE

קבוע מתקן בעיות בגבול המגזר עם נתוני PCM WAVE באיכות CD

שירים מחשב את טביעת האצבע של MD5 או SHA1 של נתוני PCM WAVE

נתיב תקליטור רפידות (קבצי איכות לא מיושרים על גבולות המגזר עם שקט

להצטרף מצטרף לנתוני PCM WAVE ממספר קבצים לאחד

לפצל מפצל נתוני PCM WAVE מקובץ אחד למספר קבצים

חתול כותב נתוני PCM WAVE מקובץ אחד או יותר למסוף

CMP משווה נתוני PCM WAVE בשני קבצים

אות יוצר גיליון CUE או נקודות מפוצלות מקבוצה של קבצים

המרה ממיר קבצים מפורמט אחד לאחר

מידע מציג מידע מפורט על נתוני PCM WAVE

להפשיט מסיר נתחי RIFF נוספים ו/או כותב כותרות קנוניות

סוג יוצר קבצי נתונים PCM WAVE באיכות CD המכילים שקט

מְטוּפָּח מקצץ את השקט של PCM WAVE מקצוות הקבצים

למידע נוסף על המשמעות של אפשרויות שורת הפקודה השונות עבור כל מצב, ראה
מה היא מצב-ספציפי אפשרויות להלן.

מטעמי נוחות, כל מצב יכול לציין שם חלופי או כינוי שיפעיל אותו
(תכונה זו זמינה כרגע רק במערכות התומכות בסמליות או במערכות קשות
מְקַשֵׁר). בפרט, כל מצב הוא כינוי 'shn '. למשל, ריצה
שנלן שווה לריצה shntool לן - ובכך לחסוך כמה הקשות.

פוּרמָט מודולים
פורמטים של קבצים מופשטים מ shntool באמצעות שימוש במודולי פורמט. הם מספקים
אמצעי ל shntool לקרוא ו/או לכתוב פורמטים שונים של קבצים באופן שקוף. זֶה
הפשטה מאפשרת shntool להתרכז בתפקידה מבלי לדאוג לפרטים של
כל פורמט קובץ.

הפורמטים הבאים נתמכים בשלב זה:

wav פורמט קובץ RIFF WAVE

אייף פורמט קובץ החלפת אודיו (AIFF ו-AIFF-C לא דחוס/זורה בלבד) (דרך
'סוקס'):
<http://sox.sourceforge.net/>

שן קיצור קודן צורות גל במורכבות נמוכה (באמצעות 'לקצר'):
<http://www.softsound.com/Shorten.html>
<http://www.etree.org/shnutils/shorten/>

flac Codec אודיו ללא אובדן חינם (באמצעות 'flac'):
<http://flac.sourceforge.net/>

קוף מדחס השמע של Monkey (דרך 'mac'):
<http://www.monkeysaudio.com/>
<http://supermmx.org/linux/mac/>

אלק Codec אודיו ללא אובדן של Apple (באמצעות 'alac'):
<http://craz.net/programs/itunes/alac.html>

tak המדחס ללא הפסדים (A) אודיו (K) של (T)om (באמצעות 'takc'):
<http://www.thbeck.de/Tak/Tak.html>

אופר OptimFROG Lossless WAVE קודן אודיו (באמצעות 'ofr'):
<http://www.losslessaudio.org/>

tta Codec אודיו ללא אובדן TTA (דרך 'ttaenc'):
<http://tta.sourceforge.net/>

כמו קידוד MPEG-4 ללא אובדן אודיו (באמצעות 'mp4als'):
<http://www.nue.tu-berlin.de/forschung/projekte/ -
lossless/mp4als.html>

wv דחיסת אודיו היברידית ללא אובדן WavPack (באמצעות 'wavpack' ו-'wvunpack'):
<http://www.wavpack.com/>

lpac דחיסת אודיו חזויה ללא אובדן (באמצעות 'lpac'):
<http://www.nue.tu-berlin.de/wer/liebchen/lpac.html>

la אודיו ללא אובדן (באמצעות 'la'):
<http://www.lossless-audio.com/>

בונק מדחס אודיו נטול אובדן של בונק (באמצעות 'בונק'):
<http://www.logarithmic.net/pfh/bonk>

kxs מדחס קבצי WAV ללא אובדן של Kexis (דרך 'kexis'):
<http://www.sourceforge.net/projects/kexis/>

מקוו פורמט דחיסת שמע MKW (דרך 'mkwcon'):
<http://www.etree.org/shnutils/mkwcon/>

משמורת מודול פורמט פלט מותאם אישית (פלט בלבד, שימושי לקידוד לפורמט
זֶה shntool עדיין לא תומך)

טווח שולח פלט למסוף

ריק שולח פלט אל /dev/null (פלט בלבד, שימושי עבור ריצות יבשות במספר
מצבים, כגון קבוע מצב או להפשיט מצב)

בעת קריאת קבצים לקלט, shntool מגלה אוטומטית איזה מודול פורמט, אם בכלל
מטפל בכל קובץ. במצבים שבהם קבצים נוצרים כפלט, אתה יכול לציין מה
פורמט הפלט צריך להיות - אחרת, shntool מחליט בשבילך על ידי בחירת הפורמט הראשון
מודול שהוא מוצא שתומך בפלט (בהתקנת ברירת מחדל, זה יהיה wav
תבנית).

CORE אפשרויות

חסר מודל
כאשר פועל ללא מצב, shntool לוקח את האפשרויות הבאות:

-m הצג מידע מפורט על מודול מצב

-f הצג מידע מפורט על מודול פורמט

-a הצג ארגומנטים של מודול פורמט ברירת מחדל

-v הצג מידע על גרסה

-h הצג מסך עזרה

גלובלי אפשרויות

תעשיות מצבי
כל המצבים תומכים באפשרויות הבאות:

-D הדפס מידע על ניפוי באגים

-F פילה
ציין קובץ המכיל רשימה של שמות קבצים לעיבוד. זה עוקף את כל הקבצים
שצוין בשורת הפקודה או בטרמינל.

הערה: רוב המצבים יקבלו שמות קבצים קלט ממקור יחיד, על פי
סדר העדיפויות הבא: קובץ שצוין על ידי -F אפשרות, אחרת שמות קבצים
בשורת הפקודה, אחרת שמות קבצים נקראים מהמסוף.

-H הדפס זמנים בפורמט h:mm:ss.{ff,nnn}, במקום m:ss.{ff,nnn}

-P סוג
ציין את סוג מחוון התקדמות. סוג אחד מ: {PCT, נקודה, לסובב, פנים, אף לא אחד}.
PCT מציג את אחוז ההשלמה של כל פעולה. נקודה מראה את ההתקדמות של
כל פעולה על ידי הצגת '.' לאחר כל צעד של 10% לקראת ההשלמה. לסובב
מציג מחוון התקדמות מסתובב. פנים מציג את ההתקדמות של כל פעולה לפי
מציג שישה אמוטיקונים שהופכים שמחים יותר ויותר ככל שהניתוח מתקרב
סִיוּם. אף לא אחד מונעת מלהיות מידע על השלמת התקדמות
מוצגת. ברירת המחדל היא PCT.

-h הצג את מסך העזרה עבור מצב זה

-i fmt ציין מפענח פורמט קובץ קלט ו/או ארגומנטים. הפורמט הוא: "מפענח fmt
[arg1 ... argN]", ועליו להיות מוקף במירכאות. אם ניתנים טיעונים, אז
אחד מהם חייב להכיל "%f", אשר יוחלף בשם קובץ הקלט.
דוגמאות:

-i 'שן לקצר-2.3ב' (השתמש ב- Shorten-2.3b הרשמי במקום בגרסאות מאוחרות יותר; עזוב
ארגומנטים של ברירת מחדל לא נגעו)

-i 'שן לקצר -x -d 2048 %f -' (אלץ לקצר כדי לדלג על 2048 הבתים הראשונים של
כל קובץ)

-q דיכוי פלט לא קריטי (מצב שקט). פלט שבדרך כלל עובר ל-stderr
לא יוצג, מלבד שגיאות או מידע ניפוי באגים (אם צוין).

-r val לסדר מחדש את קבצי הקלט? val אחד מ: {לשאול, ASCII, טִבעִי, אף לא אחד}. ברירת המחדל היא
טִבעִי.

-v הצג מידע על גרסה

-w דכא אזהרות

-- מציין שכל מה שאחריו הוא שם קובץ

תְפוּקָה מצבי
בנוסף, כל מצב שיוצר קובצי פלט תומך באפשרויות הבאות:

-O val להחליף קבצים קיימים? val אחד מ: {לשאול, תמיד, לעולם לא}. ברירת המחדל היא
לשאול.

-a str קידומת str לבסיס חלק משמות קבצי הפלט

-d dir ציין את ספריית הפלט

-o str ציין סיומת פורמט קובץ פלט, מקודד ו/או ארגומנטים. הפורמט הוא: "fmt
[ext=abc] [מקודד [arg1 ... argN (%f = שם קובץ)]]", ועליו להיות מוקף ב-
ציטוטים. אם ניתנים ארגומנטים, אז אחד מהם חייב להכיל "%f", אשר יהיה
הוחלף בשם קובץ הפלט. דוגמאות:

-o 'שן לקצר -v2 - %f' (צור קבצים קצרים ללא טבלאות חיפוש)

-o 'flac לְהִתְקַלֵף - %f' (השתמש במקודד flac חלופי)

-o 'אייף ext=aif' (עקוף את ברירת המחדל של הרחבת aiff של 'aiff' עם 'aif')

-o 'משמורת ext=mp3 צוֹלֵעַ --שֶׁקֶט - %f' (צור קבצי mp3 באמצעות lame)

-z str פוסט תיקון str לבסיס חלק משמות קבצי הפלט

מצב-ספציפי אפשרויות

לן מצב אפשרויות
-U יחידה
מציין את היחידה שבה יודפסו הסכומים. יחידה אחד מ: {b, kb,
mb, gb, tb}. ברירת המחדל היא b.

-c אל תציג שמות עמודות

-t אל תראה שורת סיכומים

-u יחידה
מציין את היחידה שבה כל קובץ יודפס. יחידה אחד מ: {b, kb, mb,
gb, tb}. ברירת המחדל היא b.

לן מצב תפוקה

הפלט של מצב len עשוי להיראות סתמי בהתחלה, מכיוון שהוא מנסה להעביר א
הרבה מידע במעט מקום. אבל זה די קל לקריאה
ברגע שאתה יודע מה העמודות מייצגות; ובעמודות מסוימות, מה כל אחד
תו בעמודה פירושו. כל עמודה מוסברת להלן.

אורך מציג את אורך נתוני ה-WAVE, בפורמט m:ss.nnn (מילישניות). אם ה
הנתונים הם באיכות CD, ואז m:ss.ff מוצג במקום, כאשר ff הוא מספר מ
00 עד 74 שמעריך בצורה הטובה ביותר את מספר הפריימים (בלוקים של 2352 בתים)
נשאר אחרי m:ss. אם כל הקבצים הם באיכות CD, האורך הכולל יהיה
מוצג בפורמט m:ss.ff; אחרת זה יהיה בפורמט m:ss.nnn. הערה: תקליטור
קבצי איכות מעוגלים למסגרת הקרובה ביותר; כל שאר הקבצים מעוגלים
לאלפית השנייה הקרובה ביותר.

מורחב גודל
מציג את הגודל הכולל של כל נתחי WAVE בתוך הקובץ (כותרת, נתונים ו
כל נתחי RIFF נוספים). בעיקרון זה הגודל שהקובץ יהיה
אם הוא הומר לפורמט .wav, למשל עם shntool המרה.

הערה: אל תסתמך על שדה זה עבור גודל השמע! אם אתה פשוט רוצה לדעת
כמה בתים של שמע יש בקובץ, הפעל אותו מידע מצב, ותסתכל על
השדה "גודל נתונים" בפלט שלו.

cdr מציג מאפיינים הקשורים לקבצים באיכות CD. 'c' בחריץ הראשון
מציין שנתוני ה-WAVE אינם באיכות [C]D. א 'ב' במשבצת השנייה
מציין שנתוני WAVE באיכות CD אינם נחתכים על סקטור [b]boundary.
סימן 's' בחריץ השלישי מציין שגם נתוני WAVE באיכות CD
כואב להישרף.

'-' בכל אחד מהמשבצות הללו מציין שהמאפיין המסוים בסדר או
נוֹרמָלִי. 'x' בכל אחד מהחריצים הללו מציין שהמאפיין המסוים
לא חל על קובץ זה, או שלא ניתן לקבוע.

גַל מציג מאפיינים של נתוני WAVE. 'h' במשבצת הראשונה מציינת זאת
ה-WAVE [h]eader אינו קנוני. 'e' בחריץ השני מציין
שקובץ ה-WAVE מכיל [e]xtra RIFF chunks.

'-' בכל אחד מהמשבצות הללו מציין שהמאפיין המסוים בסדר או
נוֹרמָלִי. 'x' בכל אחד מהחריצים הללו מציין שהמאפיין המסוים
לא חל על קובץ זה, או שלא ניתן לקבוע.

בעיות
מציג בעיות שזוהו בכותרת WAVE, נתוני WAVE או הקובץ עצמו.
'3' בחריץ הראשון מציין שהקובץ מכיל כותרת ID[3]v2.
'a' בחריץ השני מציין שנתוני השמע אינם
block‐[a]aligned. 'i' בחריץ השלישי מציין שכותרת WAVE היא
[אי]לא עקבי לגבי גודל הנתונים ו/או גודל הקובץ. 't' במשבצת הרביעית
מציין שנראה כי קובץ ה-WAVE [t]מופץ. א 'י' בחמישי
חריץ מציין שנראה שלקובץ WAVE צורף אליו [j]unk.

'-' בכל אחד מהחריצים הללו מציין שהבעיה המסוימת לא הייתה
זוהה. 'x' בכל אחד מהחריצים הללו מציין שהפרט
הבעיה לא חלה על קובץ זה, או שלא ניתן לקבוע.

fmt מראה באיזה פורמט קובץ טיפל בקובץ זה.

יחס מציג את יחס הדחיסה עבור קובץ זה.

שם הקובץ
מציג את שם הקובץ שנבדק.

קבוע מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב קבוע המצב יתבסס על שם קובץ הקלט עם
המחרוזת '-fixed' שצורפה אליה, והסיומת תהיה סיומת ברירת המחדל של ה-
פורמט קובץ הפלט. לדוגמה, עם פורמט קובץ פלט של שן הקובץ 'foo.wav'
יהפוך ל-'foo-fixed.shn'. ניתן לעקוף זאת עם ה- -a ו / או -z אפשרויות גלובליות
מתואר לעיל.

-b מסלול Shift נשבר אחורה לגבול הסקטור הקודם. זוהי ברירת המחדל.

-c בדוק אם יש צורך בתיקון, מבלי לתקן דבר בפועל. shntool יצטרך
צא עם סטטוס 0 אם יש צורך בתיקון, ומצב 1 אחרת. זה יכול להיות שימושי
בסקריפטים של מעטפת, למשל: "if shntool fix -c *; then shntool fix *; else ...; fi"

-f מסלול Shift פורץ קדימה לגבול המגזר הבא.

-k מציין שיש לעבד את כל הקבצים, גם אם הקבצים הראשונים שבהם
לא ישתנה, מלבד שינוי אפשרי בפורמט הקובץ. ברירת המחדל היא ל
דלג על N הקבצים הראשונים שלא ישתנו מנקודת מבט של נתוני WAVE ב
כדי למנוע עבודה מיותרת.

-n מציין כי אין לרפד את הקובץ האחרון שנוצר בשתיקה כדי להפוך אותו
גודל נתוני WAVE כפולה של 2352 בתים. ברירת המחדל היא ריפוד הקובץ האחרון.

-u מסלול עגול פורץ לגבול הגזרה הקרוב ביותר.

שירים מצב אפשרויות
-c מציין שיש ליצור את טביעת האצבע המרוכבת עבור כל קבצי הקלט,
במקום ברירת המחדל של טביעת אצבע אחת לכל קובץ. טביעת האצבע המרוכבת היא
פשוט טביעת האצבע של נתוני ה-WAVE מכל קבצי הקלט שנלקחו כמכלול
הסדר שניתן, וזהה לזה שייווצר מה-
קובץ joined אם אותם קבצים צורפו לקובץ אחד גדול, ללא ריפוד
הוסיף. אפשרות זו יכולה לשמש לערכות טביעת אצבע, או לזיהוי ערכות קבצים
שבו הפסקות רצועות הועברו, אך לא שונה אודיו באף אחת
דרך (לדוגמה, לא הוספה ריפוד, לא בוצעה דגימה חוזרת וכו').

-m צור טביעות אצבע של MD5. זוהי ברירת המחדל.

-s צור טביעות אצבע SHA1.

נתיב מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב נתיב המצב יתבסס על שם קובץ הקלט עם
המחרוזת '-prepadded' או '-postpadded' שצורפה אליה, והסיומת תהיה
סיומת ברירת המחדל של פורמט קובץ הפלט. לדוגמה, עם פורמט קובץ פלט של
שן וריפוד מראש שצוין בשורת הפקודה, הקובץ 'foo.wav' יהפוך
'foo-prepadded.shn'. ניתן לעקוף זאת עם ה- -a ו / או -z אפשרויות גלובליות
מתואר לעיל.

שים לב שחלק ממקודדי פורמט הפלט (למשל flac, ape) מפשירים אוטומטית כותרות
ו/או נתחי RIFF נוספים.

-b מציין שהקובץ שנוצר צריך להיות מרופד בהתחלה עם שקט ל
להפוך את גודל נתוני ה-WAVE שלו לכפולה של 2352 בתים.

-e מציין שהקובץ שנוצר צריך להיות מרופד בסופו עם שקט כדי ליצור
גודל נתוני ה-WAVE שלו כפולה של 2352 בתים. זוהי פעולת ברירת המחדל.

להצטרף מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב להצטרף הקידומת של מצב תהיה 'joined.', וה-
סיומת תהיה סיומת ברירת המחדל של פורמט קובץ הפלט. לדוגמה, עם an
פורמט קובץ הפלט של wav הקבצים 'files*.wav' יהפכו ל-'joined.wav'. זה יכול להיות
נדחק עם ה -a ו / או -z אפשרויות גלובליות שתוארו לעיל.

-b מציין שהקובץ שנוצר צריך להיות מרופד בהתחלה עם שקט ל
להפוך את גודל נתוני ה-WAVE שלו לכפולה של 2352 בתים. שימו לב שאופציה זו לא
חל אם קבצי הקלט אינם באיכות CD, מכיוון שהריפוד אינו מוגדר בכך
מקרה.

-e מציין שהקובץ שנוצר צריך להיות מרופד בסופו עם שקט כדי ליצור
גודל נתוני ה-WAVE שלו כפולה של 2352 בתים. זוהי פעולת ברירת המחדל. הערה
אפשרות זו אינה חלה אם קבצי הקלט אינם באיכות CD, שכן
הריפוד אינו מוגדר במקרה זה.

-n מציין שאסור לרפד את הקובץ שנוצר בשתיקה כדי להפוך את ה-WAVE שלו
גודל הנתונים כפולה של 2352 בתים. שים לב שהאפשרות הזו לא חלה אם
קבצי הקלט אינם באיכות CD, מכיוון שהריפוד אינו מוגדר במקרה זה.

לפצל מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב לפצל מצב הם בצורת prefixNNN.ext, כאשר NNN
הוא מספר קובץ הפלט, ו-'ext' הוא סיומת ברירת המחדל של פורמט קובץ הפלט.
אם נעשה שימוש בפורמט קובץ פלט של 'wav', והקידומת לא משתנה באמצעות -n להחליף
המתואר להלן, אז שמות קבצי הפלט יהיו "split-track01.wav",
"split-track02.wav", וכו'. ניתן לעקוף זאת עם ה- -a ו / או -z אפשרויות גלובליות
מתואר לעיל.

למידע על ציון נקודות פיצול, ראה את מפרט לפצל נקודות להלן.

-c NUM מציין את המספר שמתחיל לספור ממנו בעת מתן שמות לקבצי הפלט. ברירת המחדל
הוא 1.

-e לן קידומת כל רצועה עם לן כמות ההובלה שנלקחה מהמסלול הקודם. לן
חייב להינתן בפורמט בתים, m:ss, m:ss.ff או m:ss.nnn.

-f פילה
מציין קובץ שממנו יש לקרוא נתוני נקודת פיצול. אם לא ניתן, אז תפצל
נקודות נקראות מהמסוף.

-l לן מציין כי יש לפצל את קובץ הקלט לקבצים קטנים יותר על סמך כפולות
של לן מרווח זמן. לן חייב להינתן בבתים, m:ss, m:ss.ff או m:ss.nnn
פורמט.

-m str מציין מחרוזת מניפולציה של תווים עבור שמות קבצים שנוצרו מגיליונות CUE.
תווים אלה, שנלקחו אחד אחד, מייצגים מ/אל תרגום תווים. הֵם
חייב להיות תמיד בזוגות. כמה דוגמאות:

:- תרגם את כל המופעים של ':' ל-'-'

:-/- תרגם גם את ':' וגם '/' ל-'-'

:-/_*איקס תרגם את ':' ל-'-', '/' ל-'_' ו-'*' ל-'x'

-n fmt מציין את פורמט הפלט של ספירת הקבצים. ברירת המחדל היא %02d, מה שנותן דו ספרתי
מספרים מרופדים באפס (01, 02, 03, ...).

-t fmt תן שם לקובצי הפלט בפורמט שצוין על ידי המשתמש בהתבסס על שדות גיליון CUE. ה
מחרוזות העיצוב הבאות מזוהות:

%p Performer

%a אַלבּוֹם

%t כותרת הרצועה

%n מספר מעקב

-u לן Postfix כל רצועה עם לן כמות ההובלה שנלקחה מהמסלול הבא. לן צריך
ניתן בפורמט בתים, m:ss, m:ss.ff או m:ss.nnn.

-x רשימה
חלץ רק רצועות פנימה רשימה (מופרדים בפסיקים, עשויים להכיל טווחים). דוגמאות
כוללות:

7 רק לחלץ את רצועה 7

3-5 חלץ רק רצועות 3 עד 5

2-6,9,11-13
חלץ רק רצועות 2 עד 6, 9 ו-11 עד 13

מפרט לפצל נקודות
נקודות פיצול פשוט מסמנות מקומות בתוך נתוני ה-WAVE של קובץ הקלט שבהם רצועות
יפוצל. ניתן לציין אותם בכל שילוב של הפורמטים הבאים:

בתים כאשר בתים הוא היסט בייט ספציפי

m:ss כאשר m = דקות ו-ss = שניות

m:ss.ff
כאשר m = דקות, ss = שניות ו-ff = פריימים (75 לשנייה, אז טווחי ff
מ -00 עד 74)

m:ss.nnn
כאשר m = דקות, ss = שניות ו-nnn = אלפיות שניות (יעוגל ל
גבול המגזר הקרוב ביותר, או גבול הסקטור הראשון אם הקרוב ביותר
זה במקרה ההתחלה של הקובץ)

CUE גיליון
- גיליון CUE פשוט, שבו כל קו "INDEX 01 m:ss:ff" מומר ל-
נקודת פיצול am:ss.ff

נקודות פיצול חייבות להינתן בסדר עולה, וצריכות להופיע אחת בכל שורה. אם
היסט הבתים המחושב מנקודת הפיצול הסופית שווה ל-WAVE של קובץ הקלט
גודל הנתונים, אז הוא מתעלם. מאז פיצול נקודות לציין מיקומים בתוך
קובץ קלט שבו הרצועות יפוצלו, N נקודות פיצול ייצרו N+1 קבצי פלט.
כל הפורמטים של m:ss ייצרו פיצולים על גבולות המגזר בכל פעם שקובץ הקלט נמצא
איכות CD; כדי לכפות פיצולים שאינם מיושרים למגזר, השתמש בפורמט הבתים המדויק.

חתול מצב אפשרויות
-c מציין שיש לדכא נתחי RIFF נוספים מהפלט. ברירת המחדל
זה לכתוב את נתחי ה-RIFF הנוספים.

-d מציין שיש לדכא את נתוני ה-WAVE מהפלט. ברירת המחדל היא
לכתוב את הנתונים.

-e מציין שיש לדכא את כותרת WAVE מהפלט. ברירת המחדל
זה לכתוב את הכותרת.

-n מציין ש- NULL pad byte בקצה של נתחי נתונים בגודל מוזר צריך להיות
מודחק מהפלט, אם קיים. ברירת המחדל היא לכתוב את ה- NULL byte.
אפשרות זו חלה רק כאשר נכתבים גם נתוני WAVE, אחרת מתעלמים מהם.

CMP מצב אפשרויות
-c שניות
מגדיר את מספר השניות של אודיו לשימוש עבור מאגר ההשוואה בתים-shift.
אפשרות זו הגיונית רק עם -s אוֹפְּצִיָה. ברירת המחדל היא 3 שניות.

-f פלומה
מגדיר את "גורם הפושט" לקביעה אם נתונים שהועברו בתים זהים.
פלומה הוא מספר שלם חיובי המייצג את המספר המרבי של בתים המותרים
אי התאמה בין שני הקבצים באזור שחיפשו על ידי ה -s אוֹפְּצִיָה. זֶה
מאפשר לבדוק בתים שונים בין קבצים ש(a) מועברו בתים
ו-(ב) מכילים לפחות שגיאה אחת באזור שחיפשו אותו -s אוֹפְּצִיָה. ה
גורם ה-fuzz גבוה יותר, ככל שהחיפוש אורך זמן רב יותר, אז הגדר אותו נמוך מלכתחילה (8
או כך), ולהגדיל אותו בצעדים קטנים במידת הצורך. הערה: מתג זה יכול להיות רק
משמש עם -s מתג.

-l רשום קיזוזים וערכים של כל הבתים השונים. הפלט דומה ל-'cmp -l'; ב
במיוחד, הקיזוזים מבוססים על 1. ניתן להשתמש עם -s מתג.

-s בדוק אם נתוני ה-WAVE הכלולים בקבצי הקלט זהים
modulo a byte-shift. נכון לעכשיו, זה יזהה הבדלים רק עד הראשון
529200 בתים (שווה ל-3 שניות של נתונים באיכות CD). אפשר להשתמש בזה כדי להשוות
נתוני WAVE בתוך קובץ שנצרב מראש לנתוני WAVE במסלול המתאים נקרע
מהתקליטור הצרוב, וזה שימושי אם הרצועה שנקרעה הגיעה מתקליטור צרוב TAO,
ובכך עשוי להיות פער של שתיקה של 2 שניות בהתחלה. אפשרות זו יכולה
גם לעזור לזהות צורב תקליטורים/קורא תקליטורים משולב קריאה/כתיבה.

אות מצב אפשרויות
-c מציין שיש לפלט גיליון CUE פשוט. זוהי פעולת ברירת המחדל.
הערה: כל קבצי הקלט חייבים להיות באיכות CD כדי שגליונות CUE יהיו תקפים.

-s מציין שיש לפלט נקודות פיצול בפורמט היסט מפורש של בתים.

המרה מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב המרה מצב יקבל שם על סמך קובץ הקלט
שֵׁם. באופן ספציפי, אם שם קובץ הקלט מסתיים בסיומת הקובץ המוגדרת כברירת מחדל עבור זה
פורמט הקובץ, אז סיומת ברירת המחדל עבור פורמט הפלט הרצוי תחליף אותו;
אחרת, הוא יצורף אליו. לדוגמה, עבור פורמט פלט של שן וכן wav
קובץ קלט בשם 'file.wav', הקובץ שהומר יקרא 'file.shn', שכן '.wav' הוא
סיומת ברירת המחדל עבור wav פוּרמָט. מצד שני, בהינתן אותו מצב
למעלה, אבל עם קובץ קלט בשם 'file.wave', הקובץ שהומר יקבל את השם
'file.wave.shn', מכיוון ש-'.wave' אינו תואם ל-'.wav'. ניתן לעקוף זאת עם ה- -a
ו / או -z אפשרויות גלובליות שתוארו לעיל.

שים לב שחלק ממקודדי פורמט הפלט (למשל flac, ape) מפשירים אוטומטית כותרות
ו/או נתחי RIFF נוספים, בעוד שאחרים (למשל sox) עשויים להתאים גדלי נתוני WAVE באופן נדיר
מופעים כדי ליישר את האודיו על גבול בלוק.

-t קרא נתוני WAVE מהמסוף.

מידע מצב אפשרויות
מצב זה אינו תומך באפשרויות נוספות.

להפשיט מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב להפשיט המצב יתבסס על שם קובץ הקלט עם
המחרוזת '-stripped' שצורפה אליו, והסיומת תהיה ברירת המחדל של
פורמט קובץ הפלט. לדוגמה, עם פורמט קובץ פלט של wav הקובץ 'bar.shn'
יהפוך ל-'bar-stripped.wav'. ניתן לעקוף זאת עם ה- -a ו / או -z גלוֹבָּלִי
אפשרויות שתוארו לעיל.

שים לב שחלק ממקודדי פורמט הפלט (למשל flac, ape) מפשירים אוטומטית כותרות
ו/או נתחי RIFF נוספים, בעוד שאחרים (למשל sox) עשויים להתאים גדלי נתוני WAVE באופן נדיר
מופעים כדי ליישר את האודיו על גבול בלוק.

-c מציין שאסור להסיר נתחי RIFF נוספים. ברירת המחדל היא להסיר
כל מה שמופיע אחרי נתח הנתונים הראשון.

-e מציין שאסור להפוך את כותרות WAVE לקנוניות. ברירת המחדל היא ל
לעשות קנוניזציה של כותרות.

סוג מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב סוג מצב יקבל את הקדמת 'שתיקה', ואת
סיומת תהיה סיומת ברירת המחדל של פורמט קובץ הפלט. לדוגמה, עם an
פורמט קובץ הפלט של wav הקובץ שנוצר יהפוך ל-'silence.wav'. זה יכול להיות
נדחק עם ה -a ו / או -z אפשרויות גלובליות שתוארו לעיל.

-l לן צור קבצים המכילים לן כמות של שקט. לן חייב להינתן בבתים, m:ss,
תבנית m:ss.ff או m:ss.nnn.

מְטוּפָּח מצב אפשרויות
הערה: שמות קבצים לקבצים שנוצרו ב מְטוּפָּח המצב יתבסס על שם קובץ הקלט עם
המחרוזת '-trimmed' שצורפה אליו, והסיומת תהיה ברירת המחדל של
פורמט קובץ הפלט. לדוגמה, עם פורמט קובץ פלט של שן הקובץ 'foo.wav'
יהפוך ל-'foo-trimmed.shn'. ניתן לעקוף זאת עם ה- -a ו / או -z גלוֹבָּלִי
אפשרויות שתוארו לעיל.

-b חתוך את השקט רק מתחילת הקבצים

-e חתוך את השקט רק מסוף הקבצים

הסביבה וריאציות

ST_DEBUG
אם מוגדר, shntool ידפיס מידע על ניפוי באגים. זה מקביל ל- -D
אפשרות גלובלית, עם החריג שאיתור באגים מופעל באופן מיידי, במקום
כאשר שורת הפקודה מנותחת.

רחוב_ _DEC
ציין מפענח פורמט קובץ קלט ו/או ארגומנטים. החלף עם
פורמט שברצונך לשנות, למשל ST_SHN_DEC. הפורמט של משתנה זה הוא
אנלוגי ל -i אפשרות גלובלית, אלא שהפורמט הראשוני אינו כלול.
דוגמאות:

ST_SHN_DEC='לקצר-2.3ב'

ST_SHN_DEC='לקצר -x -d 2048 %f -'

רחוב_ _ENC
ציין סיומת פורמט קובץ פלט, מקודד ו/או ארגומנטים. החלף
עם הפורמט שברצונך לשנות, למשל ST_SHN_ENC. הפורמט של המשתנה הזה
הוא אנלוגי ל- -o אפשרות גלובלית, אלא שהפורמט הראשוני אינו
כלול. דוגמאות:

ST_SHN_ENC='לקצר -v2 - %f'

ST_FLAC_ENC='לְהִתְקַלֵף - %f'

ST_AIFF_ENC='ext=aif'

ST_CUST_ENC='ext=mp3 צוֹלֵעַ --שֶׁקֶט - %f'

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

יְצִיאָה סטָטוּס

באופן כללי, shntool ייצא עם סטטוס 0 עם הצלחה, ומצב 1 אם כן
נתקל בשגיאה. החריג היחיד הוא כאשר האפשרות 'צא' נבחרת מבפנים
תפריט סידור מחדש של הקבצים האינטראקטיבי, ובמקרה זה המצב הקיים יהיה 255.

אורים

shntool הוא כינוי שגוי, מכיוון שהוא מעבד נתוני WAVE, לא מקצר נתונים. השם הוא א
החזקה מימיה הראשונים בתור 'שנלן', תוכנית שנוצרה במיוחד כדי לחלץ
מידע על נתוני WAVE המאוחסנים בתוך קבצי .shn.

כינויים עבור shntool קידומת 'shn' במקום 'wav' כדי למנוע התנגשויות אפשריות
עם תוכניות קיימות.

השתמש ב-shncat באינטרנט באמצעות שירותי onworks.net