avprobe - מקוון בענן

תָכְנִית:

שֵׁם

ffprobe - ffprobe media prober

תַקצִיר

ffprobe [אפשרויות] [input_file]

תיאור

ffprobe אוסף מידע מזרמי מולטימדיה ומדפיס אותו באדם ובמכונה-
אופנה קריא.

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

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

ניתן להשתמש ב-ffprobe הן כיישום עצמאי או בשילוב עם טקסטואלי
מסנן, שעשוי לבצע עיבוד מתוחכם יותר, למשל עיבוד סטטיסטי או
הִתנַכְּלוּת.

האפשרויות משמשות לרשימת חלק מהפורמטים הנתמכים על ידי ffprobe או לציון אילו
מידע לתצוגה, ולהגדרה כיצד ffprobe יציג אותו.

פלט ffprobe מתוכנן לנתח בקלות על ידי מסנן טקסטואלי, והוא מורכב מאחד
או יותר קטעים בטופס שהוגדר על ידי הכותב שנבחר, אשר מצוין על ידי
print_format אוֹפְּצִיָה.

קטעים עשויים להכיל קטעים מקוננים אחרים, והם מזוהים בשם (שעשוי להיות
משותף לחלקים אחרים), ושם ייחודי. ראה את הפלט של סעיפים.

תגיות מטא נתונים המאוחסנות במיכל או בזרמים מזוהים ומודפסים ב-
המדור התואם "FORMAT", "STREAM" או "PROGRAM_STREAM".

אפשרויות

כל האפשרויות המספריות, אם לא צוין אחרת, מקבלים מחרוזת המייצגת את a
מספר כקלט, שאחריו עשויה להיות אחת מקידומות יחידת SI, לדוגמה: 'K',
'M' או 'G'.

אם 'i' מצורף לקידומת יחידת SI, הקידומת המלאה תתפרש כ-a
קידומת יחידה לכפולות בינאריות, המבוססות על חזקות של 1024 במקום חזקות של
1000. הוספת 'B' לקידומת יחידת SI מכפילה את הערך ב-8. זה מאפשר שימוש,
לדוגמה: 'KB', 'MiB', 'G' ו-'B' בתור סיומות מספר.

אפשרויות שאינן לוקחות ארגומנטים הן אפשרויות בוליאניות, וקובעות את הערך המתאים
לאמיתי. ניתן להגדיר אותם כ-false על ידי הקדמת שם האופציה ב"לא". לדוגמה
שימוש ב-"-nofoo" יקבע את האפשרות הבוליאנית עם השם "foo" ל-false.

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

מפרט זרם הוא מחרוזת המצורפת בדרך כלל לשם האופציה ומופרדת ממנו
על ידי נקודתיים. למשל "-codec:a:1 ac3" מכיל את מפרט הזרם "a:1", התואם את
זרם שמע שני. לכן, זה יבחר את ה-codec ac3 עבור זרם האודיו השני.

מפרט זרמים יכול להתאים למספר זרמים, כך שהאפשרות תחול על כולם
אוֹתָם. לדוגמה, מפרט הזרם ב-"-b:a 128k" מתאים לכל זרמי האודיו.

מפרט זרם ריק מתאים לכל הזרמים. לדוגמה, "-codec copy" או "-codec:
העתק" יעתיק את כל הזרמים ללא קידוד מחדש.

צורות אפשריות של מפרטי זרמים הן:

stream_index
מתאים את הזרם לאינדקס הזה. למשל "-threads:1 4" יקבע את ספירת השרשורים עבור
הזרם השני ל-4.

סוג_זרם[:stream_index]
סוג_זרם הוא אחד מהבאים: 'v' או 'V' עבור וידאו, 'a' עבור אודיו, 's' עבור
כותרת משנה, 'd' עבור נתונים ו-'t' עבור קבצים מצורפים. 'v' מתאים לכל זרמי הווידאו, 'V'
מתאים רק לזרמי וידאו שאינם מצורפים תמונות, תמונות ממוזערות או כריכה
אומנויות. אם stream_index נתון, אז זה מתאים למספר הזרם stream_index של זה
סוּג. אחרת, זה מתאים לכל הזרמים מהסוג הזה.

p:program_id[:stream_index]
If stream_index נתון, אז זה מתאים לזרם עם מספר stream_index ב
תוכנית עם המזהה program_id. אחרת, זה מתאים לכל הזרמים בתוכנית.

#stream_id or i:stream_id
התאם את הזרם לפי מזהה זרם (למשל PID במיכל MPEG-TS).

m:מפתח[:ערך]
מתאים לזרמים עם תג המטא נתונים מפתח בעל הערך שצוין. אם ערך לא
given, מתאים לזרמים המכילים את התג הנתון עם ערך כלשהו.

u מתאים לזרמים עם תצורה שמישה, ה-Codec חייב להיות מוגדר והחיוני
מידע כגון ממד וידאו או קצב דגימת אודיו חייב להיות נוכח.

שים לב כי ב ffmpeg, התאמה לפי מטא נתונים תפעל כראוי רק עבור קבצי קלט.

כללי אפשרויות
אפשרויות אלה משותפות בין הכלים ff*.

-L הצג רישיון.

-ח, -?, -עֶזרָה, - עזרה [גדול מ]
הצג עזרה. ניתן לציין פרמטר אופציונלי להדפסת עזרה לגבי פריט ספציפי.
אם לא צוין ארגומנט, מוצגות רק אפשרויות כלים בסיסיות (לא מתקדמות).

ערכים אפשריים של גדול מ הם:

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

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

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

מקודד=שם_קודד
הדפס מידע מפורט על המקודד בשם שם_קודד. להשתמש ב -מקודדים
אפשרות לקבל רשימה של כל המקודדים.

דמוקסר=demuxer_name
הדפס מידע מפורט על ה-demuxer בשם demuxer_name. להשתמש ב פורמטים
אפשרות לקבל רשימה של כל המקסרים והמוקסרים.

muxer=muxer_name
הדפס מידע מפורט על המוקסר ששמו muxer_name. להשתמש ב פורמטים
אפשרות לקבל רשימה של כל המוקסרים והמוקסרים.

מסנן=filter_name
הדפס מידע מפורט על שם המסנן filter_name. להשתמש ב מסננים
אפשרות לקבל רשימה של כל המסננים.

-הפך
הצג גרסה.

פורמטים
הצג פורמטים זמינים (כולל מכשירים).

מכשירים
הצג מכשירים זמינים.

-קודקים
הצג את כל הקודקים המוכרים לlibavcodec.

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

-מפענחים
הצג מפענחים זמינים.

-מקודדים
הצג את כל המקודדים הזמינים.

-bsfs
הצג מסנני זרם סיביות זמינים.

-פרוטוקולים
הצג פרוטוקולים זמינים.

מסננים
הצג מסנני libavfilter זמינים.

-pix_fmts
הצג פורמטים זמינים של פיקסלים.

-sample_fmts
הצג פורמטים זמינים לדוגמה.

-פריסות
הצג שמות ערוצים ופריסות ערוצים סטנדרטיות.

-צבעים
הצג שמות צבעים מוכרים.

מקורות מכשיר[,opt1=val1[,opt2=val2]...]
הצג מקורות שזוהו אוטומטית של התקן הקלט. התקנים מסוימים עשויים לספק מערכת-
שמות מקור תלויים שלא ניתן לזהות אוטומטית. הרשימה המוחזרת לא יכולה להיות
ההנחה היא שהיא תמיד מלאה.

ffmpeg -sources pulse,server=192.168.0.4

-כיורים מכשיר[,opt1=val1[,opt2=val2]...]
הצג כיורים שזוהו אוטומטית של התקן הפלט. התקנים מסוימים עשויים לספק מערכת-
שמות כיורים תלויים שלא ניתן לזהות אוטומטית. לא ניתן להניח את הרשימה המוחזרת
להיות תמיד שלם.

ffmpeg -מכניס דופק,שרת=192.168.0.4

-לוגרמה [חזרה+]רמת יומן | -v [חזרה+]רמת יומן
הגדר את רמת הרישום המשמשת את הספרייה. הוספת "repeat+" מציינת כי חזר על עצמו
אין לדחוס פלט יומן לשורה הראשונה ול"ההודעה האחרונה שחוזרת על עצמה n
שורת פעמים" תושמט. ניתן להשתמש ב-"repeat" גם לבד. אם נעשה שימוש ב-"repeat"
לבד, וללא הגדרה קודמת של loglevel, תשמש ברירת המחדל של loglevel. אם מרובים
ניתנים פרמטרים של loglevel, שימוש ב-'repeat' לא ישנה את loglevel. רמת יומן
הוא מחרוזת או מספר המכילים אחד מהערכים הבאים:

שקט, -8
לא להראות כלום בכלל; היה בשקט.

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

קָטלָנִי, 8
הצג רק שגיאות קטלניות. אלה שגיאות שלאחריהן התהליך בהחלט לא יכול
להמשיך אחרי.

שְׁגִיאָה, 16
הצג את כל השגיאות, כולל השגיאות שניתן לשחזר מהן.

אַזהָרָה, 24
הצג את כל האזהרות והשגיאות. כל הודעה הקשורה אולי לא נכונה או
אירועים בלתי צפויים יוצגו.

מידע, 32
הצג הודעות אינפורמטיביות במהלך העיבוד. זה בנוסף לאזהרות ו
שגיאות. זהו ערך ברירת המחדל.

מִלוּלִי, 40
זהה ל"מידע", למעט מילולי יותר.

לנפות, 48
הצג הכל, כולל מידע על ניפוי באגים.

זֵכֶר, 56

כברירת מחדל, התוכנית נכנסת ל-stderr, אם הצביעה נתמכת על ידי הטרמינל,
צבעים משמשים לסימון שגיאות ואזהרות. ניתן לבטל את צביעה ביומן בהגדרת
משתנה הסביבה AV_LOG_FORCE_NOCOLOR or בלי צבע, או ניתן לאלץ להגדיר את
משתנה הסביבה AV_LOG_FORCE_COLOR. השימוש במשתנה הסביבה בלי צבע
הוצא משימוש והוא יוסר בגרסת FFmpeg הבאה.

-להגיש תלונה
זרוק את שורת הפקודה המלאה ואת פלט המסוף לקובץ בשם
"program-YYYYMMDD-HHMMSS.log" בספרייה הנוכחית. קובץ זה יכול להיות שימושי עבור
דיווחי שגיאות. זה גם מרמז על "-loglevel מילולי".

הגדרת משתנה הסביבה FFREPORT לכל ערך יש את אותה השפעה. אם ה
הערך הוא רצף מפתח=ערך מופרד ':', אפשרויות אלו ישפיעו על הדוח;
יש להשתמש ב-escape של ערכי אפשרויות אם הם מכילים תווים מיוחדים או את האפשרויות
מפריד ':' (ראה את הסעיף ``ציטוט ובריחה'' במדריך ffmpeg-utils).

האפשרויות הבאות מוכרות:

פילה
הגדר את שם הקובץ לשימוש עבור הדוח; %p מורחב לשם של
תוכנית, %t מורחב לחותמת זמן, "%%" מורחב ל"%" רגיל

רָמָה
הגדר את רמת מילולי הרישום באמצעות ערך מספרי (ראה "-loglevel").

לדוגמה, כדי להוציא דוח לקובץ בשם ffreport.log באמצעות רמת יומן של 32
(כינוי לרמת יומן "מידע"):

FFREPORT=file=ffreport.log:level=32 פלט קלט ffmpeg -i

שגיאות בניתוח משתנה הסביבה אינן קטלניות, ולא יופיעו ב-
לדווח.

-הסתר_באנר
דכא הדפסת באנר.

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

-cpuflags דגלים (גלוֹבָּלִי)
מאפשר הגדרה וניקוי של דגלי מעבד. אפשרות זו מיועדת לבדיקה. אל תשתמש
אלא אם כן אתה יודע מה אתה עושה.

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

דגלים אפשריים עבור אפשרות זו הם:

x86
Mmx
mmxext
ESS
2
sse2slow
3
sse3slow
ssse3
אטום
4.1
4.2
AVX
avx2
xop
fma3
fma4
3dnow
3dnowext
bmi1
bmi2
cmov
זרוע
armv5te
armv6
armv6t2
vfp
vfpv3
נאון
setend
AAArch64
armv8
vfp
נאון
PowerPC
altivec
ספציפי מעבדים
פנטיום2
פנטיום3
פנטיום4
k6
k62
אתלון
athlonxp
k8
-opencl_bench
אפשרות זו משמשת למבחן השוואת כל מכשירי OpenCL הזמינים והדפסת התוצאות.
אפשרות זו זמינה רק כאשר FFmpeg הידור עם "--enable-opencl".

כאשר FFmpeg מוגדר עם "--enable-opencl", האפשרויות עבור OpenCL העולמי
ההקשר נקבעים באמצעות -opencl_options. עיין בסעיף "אפשרויות OpenCL" ב-ffmpeg-
utils manual עבור הרשימה המלאה של האפשרויות הנתמכות. בין היתר, אפשרויות אלו
כוללים את היכולת לבחור פלטפורמה ומכשיר ספציפיים להפעלת קוד OpenCL
עַל. כברירת מחדל, FFmpeg יפעל במכשיר הראשון של הפלטפורמה הראשונה. בזמן ש
אפשרויות עבור ההקשר העולמי OpenCL מספקות גמישות למשתמש בבחירת ה-
מכשיר OpenCL לפי בחירתם, רוב המשתמשים כנראה ירצו לבחור את המהיר ביותר
מכשיר OpenCL עבור המערכת שלהם.

אפשרות זו מסייעת בבחירת התצורה היעילה ביותר על ידי זיהוי
המכשיר המתאים למערכת של המשתמש. ה-benchmark המובנה מופעל על כל
מכשירי OpenCL והביצועים נמדדים עבור כל מכשיר. המכשירים ב
רשימת התוצאות ממוינת על סמך הביצועים שלהן עם המכשיר המהיר ביותר שרשום
ראשון. המשתמש יכול להפעיל לאחר מכן ffmpeg באמצעות המכשיר הנחשב ביותר
מתאים דרך -opencl_options כדי להשיג את הביצועים הטובים ביותר עבור ה-OpenCL
קוד מואץ.

שימוש אופייני לשימוש במכשיר ה-OpenCL המהיר ביותר כולל את השלבים הבאים.

הפעל את הפקודה:

ffmpeg -opencl_bench

רשום את מזהה הפלטפורמה (pidx) ומזהה מכשיר (דידקס) של המכשיר הראשון כלומר המהיר ביותר
ברשימה. בחר את הפלטפורמה והמכשיר באמצעות הפקודה:

ffmpeg -opencl_options platform_idx= :device_idx= ...

-opencl_options אפשרויות (גלוֹבָּלִי)
הגדר אפשרויות סביבת OpenCL. אפשרות זו זמינה רק כאשר FFmpeg היה
הידור עם "--enable-opencl".

אפשרויות חייבת להיות רשימה של מפתח=ערך צמדי אפשרויות מופרדים על ידי ':'. ראה את ``OpenCL
קטע 'אפשרויות' במדריך ffmpeg-utils עבור רשימת האפשרויות הנתמכות.

AVOptions
אפשרויות אלה מסופקות ישירות על ידי libavformat, libavdevice ו-libavcodec
ספריות. כדי לראות את רשימת ה-AVOptions הזמינות, השתמש ב- עזרה אוֹפְּצִיָה. הם
מופרדים לשתי קטגוריות:

גנרית
ניתן להגדיר אפשרויות אלו עבור כל מיכל, codec או מכשיר. אפשרויות גנריות הן
מופיע תחת אפשרויות AVFormatContext עבור מכולות/מכשירים ותחת AVCodecContext
אפשרויות לקודקים.

פְּרָטִי
אפשרויות אלה ספציפיות למיכל, למכשיר או ל-codec הנתונים. אפשרויות פרטיות
רשומים תחת המכילים/ההתקנים/הקודקים המתאימים להם.

לדוגמה כדי לכתוב כותרת ID3v2.3 במקום ID3v2.4 ברירת מחדל לקובץ MP3, השתמש
מה היא id3v2_version אפשרות פרטית של ה-MP3 muxer:

ffmpeg -i input.flac -id3v2_version 3 out.mp3

כל ה-codec AVOptions הם לכל זרם, ולכן יש לצרף מפרט זרם
אותם.

הערה: -אין אפשרות לא ניתן להשתמש בתחביר עבור AVOptions בוליאני, השתמש -אוֹפְּצִיָה 0/-אוֹפְּצִיָה 1.

הערה: הדרך הישנה הלא מתועדת של ציון AVOptions לכל זרם על ידי הנחת v/a/s ל-
שם האפשרויות מיושן כעת והוא יוסר בקרוב.

ראשי אפשרויות
-f פוּרמָט
כפה על שימוש בפורמט.

-יחידה
הצג את יחידת הערכים המוצגים.

-קידומת
השתמש בקידומות SI עבור הערכים המוצגים. אלא אם כן האפשרות "-byte_binary_prefix" היא
בשימוש כל הקידומות הן עשרוניות.

-byte_binary_prefix
כפה את השימוש בקידומות בינאריות עבור ערכי בתים.

-סקסג'ימלי
השתמש בפורמט סקסאגסימלי HH:MM:SS.MICROSECONDS עבור ערכי זמן.

-יפה
הגדר את הפורמט של הערכים המוצגים, זה מתאים לאפשרויות "-unit
-prefix -byte_binary_prefix -sexagesimal".

-שֶׁל, -פורמט_הדפס שם_סופר[=סופר_אפשרויות]
הגדר את פורמט הדפסת הפלט.

שם_סופר מציין את שם הכותב, ו סופר_אפשרויות מפרט את האפשרויות
שיועבר לסופר.

לדוגמה עבור הדפסת הפלט בפורמט JSON, ציין:

-print_format json

לפרטים נוספים על פורמטי ההדפסה הזמינים של הפלט, עיין בסעיף כותבים
לְהַלָן.

-מקטעים
הדפס מבנה ומידע על קטעים וצא. הפלט לא נועד
להיות מנותח על ידי מכונה.

-בחר_זרמים מפרט_זרם
בחר רק את הזרמים שצוינו על ידי מפרט_זרם. אפשרות זו משפיעה רק על
אפשרויות הקשורות לזרמים (למשל "show_streams", "show_packets" וכו').

לדוגמה כדי להציג רק זרמי אודיו, אתה יכול להשתמש בפקודה:

ffprobe -show_streams -select_streams a INPUT

כדי להציג רק מנות וידאו השייכות לזרם הווידאו עם אינדקס 1:

ffprobe -show_packets -select_streams v:1 INPUT

-show_data
הצג נתוני מטען, כמו dump הקסדצימלי ו-ASCII. בשילוב עם -show_packets, זה
יזרוק את נתוני החבילות. בשילוב עם -show_streams, זה יזרוק את ה-codec
נתונים נוספים.

ה-dump מודפס כשדה "נתונים". הוא עשוי להכיל שורות חדשות.

-show_data_hash אַלגוֹרִיתְם
הצג גיבוב של נתוני מטען, עבור מנות עם -show_packets ועבור נתונים מיותרים של codec
עם -show_streams.

-show_error
הצג מידע על השגיאה שנמצאה בעת ניסיון לחקור את הקלט.

פרטי השגיאה מודפסים בתוך קטע עם השם "ERROR".

-show_format
הצג מידע על פורמט המכולה של זרם המולטימדיה הקלט.

כל המידע על פורמט המכולה מודפס בתוך קטע עם השם "FORMAT".

-הצגת_פורמט_entry שם
כמו -show_format, אך מדפיס רק את הערך שצוין של פורמט המכולה
מידע, ולא הכל. אפשרות זו עשויה להינתן יותר מפעם אחת, ואז כולם
ערכים שצוינו יוצגו.

אפשרות זו הוצאה משימוש, השתמש ב-"show_entries" במקום זאת.

-הצג_ערכים ערכים_קטע
הגדר רשימה של ערכים להצגה.

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

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

שימו לב שסדר המפרט של ערכי המדור המקומי אינו מכובד
הפלט וסדר התצוגה הרגיל יישמרו.

התחביר הפורמלי ניתן על ידי:

::= [, ]
::= [=[ ]]
::= [: ]

לדוגמה, כדי להציג רק את האינדקס והסוג של כל זרם, ואת זמן ה-PTS,
משך זמן ואינדקס הזרם של החבילות, אתה יכול לציין את הארגומנט:

packet=pts_time,duration_time,stream_index : stream=index,codec_type

כדי להציג את כל הערכים בקטע "פורמט", אבל רק את ה-Codec סוג ב-
סעיף "זרם", ציין את הארגומנט:

פורמט: stream=codec_type

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

stream_tags: format_tags

כדי להציג רק את תג "כותרת" (אם זמין) במקטעי הזרם:

stream_tags=כותרת

-show_packets
הצג מידע על כל חבילה הכלול בזרם המולטימדיה הקלט.

המידע עבור כל חבילה בודדת מודפס בתוך חלק ייעודי עם שם
"חֲבִילָה".

-show_frames
הצג מידע על כל מסגרת וכתובית הכלולים במולטימדיה הקלט
זרם.

המידע עבור כל מסגרת בודדת מודפס בתוך חלק ייעודי עם שם
"FRAME" או "SUBTITLE".

-show_streams
הצג מידע על כל זרם מדיה הכלול בזרם המולטימדיה הקלט.

כל מידע על זרם מדיה מודפס בתוך חלק ייעודי עם שם
"זרם".

-show_programs
הצג מידע על תוכניות והזרמים שלהן הכלולים במולטימדיה הקלט
זרם.

כל מידע על זרם מדיה מודפס בתוך חלק ייעודי עם שם
"PROGRAM_STREAM".

-הצג_פרקים
הצג מידע על פרקים המאוחסנים בפורמט.

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

-ספירת_פריימים
ספור את מספר הפריימים לכל זרם ודווח על כך בזרם המתאים
סָעִיף.

-ספירת_מנות
ספור את מספר החבילות בכל זרם ודווח על כך בזרם המתאים
סָעִיף.

-מרווחי_קריאה מרווחי_קריאה
קרא רק את המרווחים שצוינו. מרווחי_קריאה חייב להיות רצף של מרווחים
מפרטים מופרדים על ידי ",". ff בדיקה יחפש לנקודת ההתחלה של המרווח,
ואמשיך לקרוא מזה.

כל מרווח מצוין על ידי שני חלקים אופציונליים, מופרדים על ידי "%".

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

החלק השני מציין את מיקום סיום המרווחים. זה מתפרש כמוחלט
מיקום, או כהיסט יחסי מהמיקום הנוכחי אם לפניו ה-
תו "+". אם מפרט ההיסט מתחיל ב-"#", הוא מתפרש כ-
מספר החבילות לקריאה (לא כולל מנות ההדחה) מהמרווח
הַתחָלָה. אם לא צוין חלק שני, התוכנית תקרא עד לסוף
קֶלֶט.

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

התחביר הפורמלי ניתן על ידי:

::= [ |+ ][%[ |+ ]]
::= [, ]

להלן מספר דוגמאות.

· חפש לזמן 10, קרא מנות עד 20 שניות לאחר נקודת החיפוש שנמצאה, לאחר מכן
חפש למקם "01:30" (דקה ושלושים שניות) וקרא מנות עד
עמדה "01:45".

10%+20,01:30%01:45

· קרא רק 42 מנות לאחר שביקשת למצב "01:23":

01:23%+#42

· קרא רק את 20 השניות הראשונות מההתחלה:

%+20

· קרא מההתחלה ועד למצב "02:30":

%02:30

-show_private_data, -פְּרָטִי
הצג נתונים פרטיים, כלומר נתונים בהתאם לפורמט של המוצג המסוים
אֵלֵמֶנט. אפשרות זו מופעלת כברירת מחדל, אך ייתכן שיהיה עליך להשבית אותה עבור
שימושים ספציפיים, למשל בעת יצירת פלט XML תואם XSD.

-show_program_version
הצג מידע הקשור לגרסת התוכנית.

פרטי הגרסה מודפסים בתוך חלק בשם "PROGRAM_VERSION".

-show_library_versions
הצג מידע הקשור לגרסאות ספרייה.

מידע גרסה עבור כל ספרייה מודפס בתוך חלק עם שם
"LIBRARY_VERSION".

-show_versions
הצג מידע הקשור לגרסאות תוכנית וספרייה. זו המקבילה ל
הגדרת שניהם -show_program_version ו -show_library_versions אפשרויות.

-show_pixel_formats
הצג מידע על כל פורמטי הפיקסלים הנתמכים על ידי FFmpeg.

מידע על פורמט פיקסל עבור כל פורמט מודפס בתוך קטע עם שם
"PIXEL_FORMAT".

-בדיוק
כפה פלט ביט מדויק, שימושי להפקת פלט שאינו תלוי בספציפי
לִבנוֹת.

-i input_file
חומר עיוני input_file.

כותבים

כותב מגדיר את פורמט הפלט שאומץ על ידי ff בדיקה, וישמש להדפסת הכל
החלקים של הפלט.

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

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

string_validation, sv
הגדר מצב אימות מחרוזת.

הערכים הבאים מתקבלים.

להיכשל
הכותב ייכשל באופן מיידי במקרה של מחרוזת לא חוקית (UTF-8) או
נקודת קוד נמצאת בקלט. זה שימושי במיוחד לאימות קלט
מטא נתונים.

להתעלם
כל שגיאת אימות תתעלם. זה יגרום לפלט אולי שבור,
במיוחד עם ה-json או ה-xml writer.

להחליף
הכותב יחליף במחרוזת רצפי UTF-8 לא חוקיים או נקודות קוד
שצוין עם ה string_validation_replacement.

ערך ברירת המחדל הוא להחליף.

string_validation_replacement, svr
הגדר מחרוזת החלפה לשימוש במקרה string_validation מוגדר להחליף.

במקרה שהאפשרות לא צוינה, הכותב יניח את המחרוזת הריקה, כלומר
זה יסיר את הרצפים הלא חוקיים ממחרוזות הקלט.

להלן תיאור של הכותבים הזמינים כעת.

ברירת מחדל
פורמט ברירת מחדל.

הדפס כל חלק בטופס:

[סָעִיף]
key1=val1
...
keyN=valN
[/סָעִיף]

תגיות מטא נתונים מודפסות כשורה ב-FORMAT, STREAM או PROGRAM_STREAM התואמים
מקטע, ובקדמת המחרוזת "TAG:".

להלן תיאור של האפשרויות המקובלות.

אין מפתח, nk
אם מוגדר ל-1, ציין לא להדפיס את המפתח של כל שדה. ערך ברירת המחדל הוא 0.

noprint_wrappers, nw
אם מוגדר ל-1, ציין לא להדפיס את הכותרת העליונה והתחתונה של הקטע. ערך ברירת המחדל הוא 0.

קוֹמפָּקטִי, csv
פורמט קומפקטי ו-CSV.

הכותב "csv" שווה ערך ל"קומפקטי", אך תומך בברירות מחדל שונות.

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

קטע|מפתח1=val1| ... |keyN=valN

תגיות מטא נתונים מודפסות בקטע "פורמט" או "זרם" המקביל. מטא נתונים
מפתח תג, אם מודפס, הוא קידומת המחרוזת "תג:".

להלן תיאור האפשרויות המקובלות.

item_sep, s
ציין את התו לשימוש להפרדת שדות בשורת הפלט. זה חייב להיות א
תו יחיד שניתן להדפסה, זה "|" כברירת מחדל ("," לכותב "csv").

אין מפתח, nk
אם מוגדר ל-1, ציין לא להדפיס את המפתח של כל שדה. ערך ברירת המחדל שלו הוא 0 (1 עבור
כותב ה-"csv").

בריחה, e
הגדר את מצב הבריחה לשימוש, ברירת המחדל היא "c" ("csv" לכותב "csv").

זה יכול להניח אחד מהערכים הבאים:

c בצע בריחה כמו C. מחרוזות המכילות שורה חדשה (\n), החזרת מרכבה (\r),
כרטיסייה (\t), עדכון טופס (\f), הדמות הבורחת (\) או מפריד הפריטים
אופי ספטמבר נמלטים באמצעות בריחה מעוצבת דמויית C, כך שקו חדש הוא
הומר לרצף \n, חזרת כרכרה ל \r, \ ל \\ והמפריד
ספטמבר מומר \ספטמבר.

csv בצע בריחה דמוית CSV, כמתואר ב-RFC4180. מחרוזות המכילות שורה חדשה
(\n), החזרת כרכרה (\r), מרכאה כפולה ("), או ספטמבר מוקפים בכפול-
ציטוטים.

אף לא אחד
אין לבצע בריחה.

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

דירה
פורמט שטוח.

פלט בצורה חופשית כאשר כל שורה מכילה מפתח=ערך מפורש, כגון
"streams.stream.3.tags.foo=bar". הפלט הוא מעטפת בריחה, אז זה יכול להיות ישירות
מוטבע בסקריפטים של sh כל עוד תו המפריד הוא תו אלפאנומרי או
קו תחתון (ראה sep_char אוֹפְּצִיָה).

להלן תיאור האפשרויות המקובלות.

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

ערך ברירת המחדל הוא ..

היררכי, h
ציין אם מפרט שם המקטע צריך להיות היררכי. אם מוגדר ל-1, ואם
יש יותר מקטע אחד בפרק הנוכחי, שם המדור יהיה
עם קידומת שם הפרק. ערך 0 ישבית התנהגות זו.

ערך ברירת המחדל הוא 1.

INI
פלט בפורמט INI.

הדפס פלט בפורמט מבוסס INI.

האמנות הבאות מאומצות:

· כל המפתח והערכים הם UTF-8

· . הוא מפריד תת-הקבוצות

· שורה חדשה, \t, \f, \b והדמויות הבאות נמלטו

· \ הוא דמות הבריחה

· # הוא מחוון ההערות

· = הוא מפריד המפתח/ערך

· : אינו בשימוש אך בדרך כלל מנותח כמפריד מפתח/ערך

כותב זה מקבל אפשרויות כרשימה של מפתח=ערך זוגות, מופרדים על ידי :.

להלן תיאור האפשרויות המקובלות.

היררכי, h
ציין אם מפרט שם המקטע צריך להיות היררכי. אם מוגדר ל-1, ואם
יש יותר מקטע אחד בפרק הנוכחי, שם המדור יהיה
עם קידומת שם הפרק. ערך 0 ישבית התנהגות זו.

ערך ברירת המחדל הוא 1.

ג'סון
פורמט מבוסס JSON.

כל חלק מודפס באמצעות סימון JSON.

להלן תיאור האפשרויות המקובלות.

קוֹמפָּקטִי, c
אם מוגדר ל-1 אפשר פלט קומפקטי, כלומר כל חלק יודפס על יחיד
קַו. ערך ברירת המחדל הוא 0.

למידע נוסף על JSON, ראהhttp://www.json.org/>.

xml
פורמט מבוסס XML.

פלט ה-XML מתואר בקובץ תיאור סכימת ה-XML ffprobe.xsd מותקן ב -
FFmpeg datadir.

ניתן לאחזר גרסה מעודכנת של הסכימה בכתובת האתר
<http://www.ffmpeg.org/schema/ffprobe.xsd>, שמפנה לסכימה האחרונה שבוצעה
לתוך עץ קוד המקור של פיתוח FFmpeg.

שימו לב שהפלט שיונפק יהיה תואם ל- ffprobe.xsd סכימה רק כאשר לא
אפשרויות פלט גלובליות מיוחדות (יחידה, קידומת, byte_binary_prefix, מיני סקסאלי וכו') הם
נָקוּב.

להלן תיאור האפשרויות המקובלות.

מלא_מוסמך, q
אם מוגדר ל-1, ציין אם הפלט צריך להיות כשיר במלואו. ערך ברירת המחדל הוא 0. זה
נדרש ליצירת קובץ XML שניתן לאמת באמצעות קובץ XSD.

xsd_compliant, x
אם מוגדר ל-1, בצע בדיקות נוספות כדי לוודא שהפלט תואם XSD. בְּרִירַת מֶחדָל
הערך הוא 0. אפשרות זו מוגדרת אוטומטית מלאה_מוסמכת אל 1.

למידע נוסף על פורמט ה-XML, ראהhttp://www.w3.org/XML/>.

קוד זמן

ff בדיקה תומך בחילוץ Timecode:

· קוד זמן MPEG1/2 מופק מה-GOP וזמין בזרם הווידאו
פרטים (-show_streamsראה קוד זמן).

· קוד זמן MOV מופק מרצועת tmcd, ולכן זמין במטא נתונים של זרם tmcd
(-show_streamsראה תגית: קוד זמן).

· קודי זמן DV, GXF ו-AVI זמינים במטא נתונים בפורמט (-show_formatראה
תגית: קוד זמן).

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