mpv - מקוון בענן

תָכְנִית:

שֵׁם

mpv - נגן מדיה

תַקצִיר

Mpv [אפשרויות] [קובץ|כתובת אתר|פלייליסט|-]
Mpv [אפשרויות] קבצים

תיאור

Mpv הוא נגן מדיה המבוסס על MPlayer ו-mplayer2. זה תומך במגוון רחב של וידאו
פורמטים של קבצים, קודקים של שמע ווידאו וסוגי כתוביות. סוגים מיוחדים של כתובת URL לקלט הם
זמין לקריאת קלט ממגוון מקורות מלבד קבצי דיסק. תלוי ב
פלטפורמה, מגוון שיטות שונות של פלט וידאו ושמע נתמכות.

דוגמאות לשימוש כדי להתחיל במהירות ניתן למצוא בסוף דף האיש הזה.

אינטראקטיבי בקרה לפני ואחרי הטיפול

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

ראה --קֶלֶט- אפשרויות לדרכים להתאים אותו.

מקלדת שליטה
נשאר ו ימינה
חפש אחורה/קדימה 5 שניות. Shift+חץ עושה חיפוש מדויק של שנייה אחת (ראה
--hr-חפש).

UP ו מטה
חפש קדימה/אחורה דקה אחת. Shift+חץ עושה חיפוש מדויק של 1 שניות (ראה
--hr-חפש).

Ctrl+שמאל ו Ctrl+ימין
חפש לכתובית הקודמת/הבאה. כפוף להגבלות מסוימות ואולי לא יעבוד
תמיד; לִרְאוֹת sub_seek פקודה.

[ ו ]
הקטנת/הגדלה של מהירות ההשמעה הנוכחית ב-10%.

{ ו }
חצי/כפול את מהירות ההשמעה הנוכחית.

BACKSPACE
אפס את מהירות ההשמעה לנורמלי.

< ו >
עבור אחורה/קדימה ברשימת ההשמעה.

ENTER המשך קדימה ברשימת ההשמעה.

p / SPACE
השהה (לחיצה נוספת מבטלת את ההשהיה).

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

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

q תפסיק לשחק ותפסיק.

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

/ ו *
הקטנת/הגברת עוצמת הקול.

9 ו 0
הקטנת/הגברת עוצמת הקול.

m השתקת צליל.

_ דפדף בין רצועות הווידאו הזמינות.

# דפדף בין רצועות האודיו הזמינות.

f החלף מסך מלא (ראה גם --fs).

ESC צא ממצב מסך מלא.

T החלף את השהייה בראש (ראה גם --עליון).

w ו e
הקטנת/הגדלה של טווח פאן וסריקה.

o (גַם P)
הצג את סרגל ההתקדמות, הזמן שחלף ומשך הזמן הכולל ב-OSD.

O החלף מצבי OSD בין רגיל לזמן/משך השמעה.

v החלף את נראות הכתוביות.

j ו J
עברו על הכתוביות הזמינות.

x ו z
התאם את השהיית הכתוביות ב-+/- 0.1 שניות.

l קבע/נקה נקודות לולאה AB. לִרְאוֹת ab-loop פקודה לפרטים.

L החלף לולאה אינסופית.

Ctrl + ו Ctrl -
התאם את השהיית השמע ב-+/- 0.1 שניות.

u החלף בין החלת סרבנות של סגנון על כתוביות SSA/ASS, לבין דריסה
אותם כמעט לגמרי עם סגנון הכתוביות הרגיל. לִרְאוֹת --עקיפה בסגנון התחת ל
עוד מידע.

V החלף מצב תאימות היבט של כתוביות VSFilter. לִרְאוֹת
--ass-vsfilter-aspect-compat למידע נוסף.

r ו t
הזז כתוביות למעלה/למטה.

s צלם מסך.

S צלם צילום מסך, ללא כתוביות. (האם זה עובד תלוי בנהג VO
תמיכה.)

Ctrl s צלם צילום מסך, כפי שהחלון מציג זאת (עם כתוביות, OSD ווידאו מוקטן).

I הצג את שם הקובץ ב-OSD.

PGUP ו PGDWN
חפשו לתחילת הפרק הקודם/הבא. ברוב המקרים, "קודם" יהיה
ממש ללכת לתחילת הפרק הנוכחי; לִרְאוֹת --פרק-חיפוש-סף.

Shift+PGUP ו Shift+PGDWN
חפש אחורה או קדימה ב-10 דקות. (פעם זה היה מופה ל-PGUP/PGDWN
ללא Shift.)

d הפעל/השבת את ה-deinterlacer.

A ביטול יחס רוחב-גובה של מחזור.

(המפתחות הבאים תקפים רק בעת שימוש בפלט וידאו התומך ב-
התאמה מתאימה, או האקולייזר של התוכנה (--vf=eq).)

1 ו 2
התאם את הניגודיות.

3 ו 4
התאם את הבהירות.

5 ו 6
התאם גמא.

7 ו 8
התאם את הרוויה.

Alt + 0 (ו פקודה+0 on OSX)
שנה את גודל חלון הווידאו לחצי מגודלו המקורי.

Alt + 1 (ו פקודה+1 on OSX)
שנה את גודל חלון הווידאו לגודלו המקורי.

Alt + 2 (ו פקודה+2 on OSX)
שנה את גודל חלון הווידאו כדי להכפיל את גודלו המקורי.

הפקודה + f (OSX בלבד)
החלף מסך מלא (ראה גם --fs).

הפקודה + [ ו הפקודה + ] (OSX בלבד)
הגדר אלפא חלון וידאו.

(המקשים הבאים תקפים אם יש לך מקלדת עם מקשי מולטימדיה.)

פוגה הַפסָקָה.

עצור תפסיק לשחק ותפסיק.

הקודם ו הבא
חפש אחורה/קדימה דקה אחת.

(המפתחות הבאים תקפים רק אם הידור עם תמיכה בקלט טלוויזיה או DVB.)

h ו k
בחר בערוץ הקודם/הבא.

עכבר שליטה
לַחְצָן 3 ו לַחְצָן 4
חפש אחורה/קדימה דקה אחת.

לַחְצָן 5 ו לַחְצָן 6
הקטנת/הגברת עוצמת הקול.

נוהג

כל דגל לאופציה יש א ללא דגל מקביל, למשל ההפך מ- --fs האפשרות היא
--לא-fs. --fs=כן זהה ל --fs, --fs=לא הוא זהה --לא-fs.

אם אפשרות מסומנת כ (XXX בלבד), זה יעבוד רק בשילוב עם XXX אוֹפְּצִיָה
או אם XXX מורכב ב.

בריחה רווחים ו אַחֵר מיוחד תווים
זכור שהמעטפת תנתח ותקלקל חלקית את הטיעונים שאתה מעביר ל-mpv.
לדוגמה, ייתכן שיהיה עליך לצטט או לברוח אפשרויות ושמות קבצים:
Mpv "שם קובץ עם spaces.mkv" --title="חלון כותרת"

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

מנתח אפשרויות המשנה יכול לצטט איתם מחרוזות " ו [...]. בנוסף, יש מיוחד
צורת ציטוט עם %n% המתואר להלן.

לדוגמה, פתוח VO יכול לקחת מספר אפשרויות:
Mpv test.mkv --vo=opengl:scale=lanczos:icc-profile=file.icc,xv

זה עובר קנה מידה=לנצ'וס ו icc-profile=file.icc ל פתוח, וגם מפרט xv as
fallback VO. אם הנתיב של פרופיל icc מכיל רווחים או תווים כמו , or :, אתה צריך
לצטט אותם:
Mpv '--vo=opengl:icc-profile="קובץ עם spaces.icc",xv'

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

השמיים [...] צורת המרכאות עוטפת הכל [ ו ]. זה שימושי עם קונכיות זה
אל תפרש את הדמויות האלה באמצע ויכוח (כמו bash). הציטוטים האלה
מאוזנים (מאז mpv 0.9.0): ה [ ו ] קן, והציטוט מסתיים על האחרון ]
שאין לו התאמה [ בתוך המחרוזת. (לדוגמה, [א ב ג] תוצאות ב א ב ג.)

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

זה מתחיל עם % ויש לו את הפורמט הבא:

%n%string_of_length_n

דוגמאות

Mpv --ao=pcm:file=%10%C:test.wav test.avi

או בתסריט:

Mpv --ao=pcm:file=%`expr אורך "$NAME"`%"$NAME" test.avi

אפשרויות משנה המועברות לממשק ה-API של הלקוח כפופות אף הן ל-Escape. באמצעות
mpv_set_option_string() זה בדיוק כמו לעבור --שם=נתונים לשורת הפקודה (אבל
ללא עיבוד מעטפת של המחרוזת). חלק מהאפשרויות תומכות בהעברת ערכים ב- more
דרך מובנית במקום מחרוזות שטוחות, ויכולה להימנע מהבלגן של תת-אפשרות ניתוח. ל
דוגמא, --vf תומך MPV_FORMAT_NODE, המאפשר לך להעביר אפשרויות משנה כנתונים מקוננים
מבנה של מפות ומערכים. (--ו תומך בכך באותו אופן, למרות שעובדה זו כן
לא מתועד.)

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

שם - עצמו מתפרש כ-stdin, ויגרום ל-mpv להשבית את בקרות המסוף.
(מה שהופך אותו למתאים להפעלת נתונים בצינור ל-stdin.)

עבור שבילים המועברים לאפשרויות משנה, המצב מסובך עוד יותר בגלל הצורך לברוח
תווים מיוחדים. כדי לעקוף זאת, ניתן לעטוף את השביל בנוסף ב-
תחביר באורך קבוע, למשל %n%string_of_length_n (ראה לעיל).

כמה אפשרויות mpv מפרשנות נתיבים שמתחילים ב ~. נכון לעכשיו, הקידומת ~~/ מתרחב ל
ספריית תצורת mpv (בדרך כלל ~/.config/mpv/). ~/ מתרחב לבית המשתמש
מַדרִיך. (הנגרר / נדרש תמיד.) ישנם גם הנתיבים הבאים:

┌──יתוח
│שם │ משמעות │
└──יתוח

│~~בית/ │ אותו דבר כמו ~~/ │
├──יתוח
│~~גלובלי/ │ נתיב התצורה הגלובלי, אם │
│ │ זמין (לא ב-win32) │
├──יתוח
│~~osxbundle/ │ נתיב המשאבים של צרור OSX │
│ │ (OSX בלבד) │
├──יתוח
│~~שולחן עבודה/ │ הנתיב לשולחן העבודה (win32, │
│ │ OSX) │
└──יתוח

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

mpv --a file1.mkv --b file2.mkv --c

┌──────────┬────────────────┐
│קובץ │ אפשרויות פעילות │
├──────────┼────────────────┤
│file1.mkv │ --א --ב --ג │
├──────────┼────────────────┤
│file2.mkv │ --א --ב --ג │
└──────────┴────────────────┘

(זה שונה מ-MPlayer ו-mplayer2.)

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

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

mpv --a file1.mkv --b --\{ --c file2.mkv --d file3.mkv --e --\} file4.mkv --f

┌──────────┬────────────────────────
│קובץ │ אפשרויות פעילות │
├──────────┼───────────────────────
│file1.mkv │ --א --ב - ו │
├──────────┼───────────────────────
│file2.mkv │ --א --ב - ו --ג -ד - │
├──────────┼───────────────────────
│file3.mkv │ --א --ב - ו --ג -ד - │
├──────────┼───────────────────────
│file4.mkv │ --א --ב - ו │
└──────────┴─────────────────────────

בנוסף, כל אפשרות קובץ מקומית שמשתנה בזמן הריצה מאופסת כאשר הקובץ הנוכחי
מפסיק לשחק. אם אפשרות --ג משתנה במהלך השמעה של file2.mkv, הוא מאופס כאשר
מתקדמים ל file3.mkv. זה משפיע רק על אפשרויות מקומיות של קבצים. האפשרות --א זה אף פעם
לאפס כאן.

תְצוּרָה קבצים

מקום ו תחביר
אתה יכול לשים את כל האפשרויות בקבצי תצורה שייקראו בכל פעם ש-mpv נמצא
לָרוּץ. קובץ התצורה של כל המערכת 'mpv.conf' נמצא בספריית התצורה שלך
(לְמָשָׁל /etc/mpv or /usr/local/etc/mpv), הספציפי למשתמש הוא ~/.config/mpv/mpv.conf.
לפרטים ופרטי פלטפורמה (בפרט נתיבי Windows) עיין ב- קבצים סָעִיף.

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

קובץ תצורה לדוגמה

# השתמש בפלט וידאו opengl כברירת מחדל.
vo=opengl
# השתמש במירכאות לטקסט שיכול להכיל רווחים:
status-msg="זמן: ${time-pos}"

בריחה רווחים ו מיוחד תווים
זה נעשה כמו עם אפשרויות שורת הפקודה. הקליפה לא מעורבת כאן, אלא אפשרות
עדיין צריך לצטט ערכים כמכלול אם הוא מכיל תווים מסוימים כמו רווחים. א
ניתן לצטט את ערך התצורה ", כמו גם עם התחביר באורך קבוע (%n%) מוזכר
לפני. זה כמו להעביר את התוכן המדויק של המחרוזת המצוטטת בתור שורת פקודה
אוֹפְּצִיָה. בריחה בסגנון C כרגע _לא_ מתפרשות ברמה זו, אם כי חלקן
אפשרויות לעשות זאת באופן ידני. (זה בלגן וכנראה צריך לשנות אותו בשלב מסוים.)

מכניס פיקוד קו אפשרויות אל תוך מה היא תְצוּרָה שלח
ניתן להכניס כמעט את כל אפשרויות שורת הפקודה לקובץ התצורה. הנה קטן
להנחות:

───────────────────┬────────────────
│אפשרות │ הזנת קובץ תצורה │
├──────────────────┼────────────────────────
│--דֶגֶל │ דגל │
├──────────────────┼────────────────────────
│-העדיף val │ opt=val │
├──────────────────┼────────────────────────
│--opt=val │ opt=val │
├──────────────────┼────────────────────────
│-העדיף "יש ל רווחים" │ opt="יש רווחים" │
└──────────────────┴────────────────────

ספציפי לקובץ תְצוּרָה קבצים
אתה יכול גם לכתוב קובצי תצורה ספציפיים לקובץ. אם אתה רוצה לקבל תצורה
קובץ עבור קובץ בשם 'video.avi', צור קובץ בשם 'video.avi.conf' עם
אפשרויות ספציפיות לקובץ בו ולהכניס אותו ~/.config/mpv/. אתה יכול גם לשים את
קובץ התצורה באותה ספרייה כמו הקובץ שיש לנגן. שניהם דורשים ממך להגדיר
מה היא --use-filedir-conf אפשרות (בשורת הפקודה או בקובץ התצורה הגלובלי שלך).
אם נמצא קובץ תצורה ספציפי לקובץ באותה ספרייה, אין קובץ ספציפי
התצורה נטענת מ ~/.config/mpv. בנוסף --use-filedir-conf אוֹפְּצִיָה
מאפשר קובצי תצורה ספציפיים לספרייה. לשם כך, mpv מנסה תחילה לטעון את a
mpv.conf מאותה ספרייה שבה הקובץ מושמע ולאחר מכן מנסה לטעון כל
תצורה ספציפית לקובץ.

פרופילים
כדי להקל על העבודה עם תצורות שונות, ניתן להגדיר פרופילים ב-
קבצי תצורה. פרופיל מתחיל בשמו בסוגריים מרובעים, למשל [הפרופיל שלי].
כל האפשרויות הבאות יהיו חלק מהפרופיל. תיאור (מוצג על ידי --פרופיל=עזרה)
ניתן להגדיר עם ה פרופיל-תיאור אוֹפְּצִיָה. כדי לסיים את הפרופיל, התחל עוד אחד או השתמש
שם הפרופיל ברירת מחדל להמשיך עם אפשרויות רגילות.

דוגמה לקובץ תצורה של mpv עם פרופילים

# אפשרות רגילה ברמה העליונה
מסך מלא=כן

# פרופיל שניתן להפעיל באמצעות --profile=big-cache
[מטמון גדול]
cache=123400
demuxer-readahead-secs=20

[לְהַאֵט]
profile-desc="שם פרופיל כלשהו"
vo=opengl:scale=ewa_lanczos:scale-radius=16

[מָהִיר]
vo=vdpau

# שימוש בפרופיל שוב מרחיב אותו
[לְהַאֵט]
framedrop=לא
# אתה יכול גם לכלול פרופילים אחרים
profile=big-cache

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

טעינת פרופיל אוטומטית

[vo.vdpau]
# השתמש בפענוח חומרה
hwdec=vdpau

[protocol.dvd]
profile-desc="profile for dvd:// streams"
alang=en

[extension.flv]
profile-desc="פרופיל עבור קבצי .flv"
vf=היפוך

[ao.alsa]
device=spdif

שם הפרופיל עוקב אחר הסכמה סוג שם, שבו סוג יכול להיות vo כדי להתאים את הערך של
--ו האפשרות מוגדרת ל, ao ל --ao, פרוטוקול עבור פרוטוקול הקלט/פלט שנמצא בשימוש (ראה
-- רשימה-פרוטוקולים,) ו הארכה להרחבת הנתיב של המופע המנוגן כעת
קובץ (לֹא פורמט הקובץ).

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

לְקִיחָה בצילומי מסך

ניתן לצלם צילומי מסך של הקובץ המושמע כעת באמצעות מצב הקלט 'צילום מסך'
הפקודה, המחוברת כברירת מחדל ל- s מַפְתֵחַ. קבצים עם שם shotNNNN.jpg יישמר ב
ספריית העבודה, תוך שימוש במספר הזמין הראשון - שום קבצים לא יוחלפו.

צילום מסך יכיל בדרך כלל את תוכן הווידאו ללא קנה מידה בסוף הסרטון
שרשרת סינון וכתוביות. כברירת מחדל, S מצלם צילומי מסך ללא כתוביות, תוך כדי s
כולל כתוביות.

בניגוד ל-MPlayer, ה צילום מסך מסנן וידאו אינו נדרש. המסנן הזה מעולם לא היה
נדרש ב-mpv, והוסר.

TERMINAL סטָטוּס קו

במהלך השמעה, mpv מציג את מצב ההשמעה במסוף. זה נראה כמו משהו
ככה:
AV: 00:03:12 / 00:24:25 (% 13) אָב: -0.000

ניתן לעקוף את שורת המצב באמצעות ה- --term-status-sg אוֹפְּצִיָה.

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

· AV: or V: (סרטון בלבד) או A: (אודיו בלבד)

· מיקום הזמן הנוכחי ב HH: MM: SS פורמט (זמן השמעה תכונה)

· משך הקובץ הכולל (נעדר אם לא ידוע) (אורך תכונה)

· מהירות השמעה, למשל `` x2.0``. נראה רק אם המהירות אינה תקינה. זה
מהירות בקשת המשתמש, ולא המהירות בפועל (בדרך כלל הם צריכים להיות זהים, אלא אם כן
ההשמעה איטית מדי). (מְהִירוּת תכונה.)

· אחוז השמעה, למשל (% 13). כמה מהקובץ הושמע. בדרך כלל
מחושב מתוך מיקום ומשך ההשמעה, אך יכול לחזור לשיטות אחרות
(כמו מיקום בתים) אם אלה אינם זמינים. (אחוז-פוז תכונה.)

· סינכרון האודיו/וידאו כ אָב: 0.000. זה ההבדל בין אודיו ווידאו
זְמַן. בדרך כלל זה צריך להיות 0 או קרוב ל-0. אם זה גדל, זה עשוי להצביע על א
בעיית השמעה. (avsync תכונה.)

· שינוי כולל של סינכרון A/V, למשל ct: -0.417. בדרך כלל בלתי נראה. יכול להופיע אם יש
אודיו "חסר", או שלא ניתן להוריד מספיק פריימים. בדרך כלל זה יצביע על א
בְּעָיָה. (total-avsync-change תכונה.)

· מצב קידוד ב {...}, מוצג רק במצב קידוד.

· הצגת מצב סנכרון. אם סנכרון התצוגה פעיל (display-sync-active נכס), זה מראה
DS: 2.500/13, כאשר המספר הראשון הוא המספר הממוצע של vsyncs לכל מסגרת וידאו (למשל
2.5 בעת הפעלת סרטוני 24Hz על מסכי 60Hz), שעלולים לרעוד אם היחס אינו
לסגור, או שיש מסגרות שגוי בזמן (vsync-ratio), והמספר השני של
מספר משוער של vsyncs שלקח יותר מדי זמן (vo-delayed-frame-count תכונה). ה
האחרון הוא היוריסטי, מכיוון שבדרך כלל לא ניתן לקבוע זאת בוודאות.

· מסגרות שנשרו, למשל ירד: 4. מופיע רק אם הספירה אינה 0. יכול לגדול אם
קצב פריימים של וידאו גבוה מזה של התצוגה, או אם עיבוד הווידאו איטי מדי.
ניתן גם להגדיל על "שיהוקים" וכאשר לא ניתן היה להציג את מסגרת הווידאו ב-
זְמַן. (vo-drop-frame-count נכס.) אם המפענח מפיל מסגרות, המספר של
מסגרות שנפלו מהמפענח מצורפות לתצוגה גם כן, למשל: ירד: 4/34. זֶה
קורה רק אם הפלת המסגרת של המפענח מופעלת עם --framedrop אפשרויות.
(drop-frame-count תכונה.)

· מצב מטמון, למשל מטמון: 2s+134KB. גלוי אם מטמון הזרם מופעל. הראשון
הערך מציג את כמות הווידאו המאוחסן ב-demuxer בשניות, הערך השני
מופעים נוסף נתונים מאוחסנים במטמון הזרם בקילו-בייט. (דמקס-מטמון-משך
ו בשימוש במטמון נכסים.)

פרוטוקולים

http://..., https://, ...
פרוטוקולי רשת רבים נתמכים, אך קידומת הפרוטוקול חייבת להיות תמיד
נָקוּב. mpv לעולם לא ינסה לנחש אם שם קובץ הוא למעשה רשת
כתובת. תמיד נדרשת קידומת פרוטוקול.

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

- הפעל נתונים מ-stdin.

smb://PATH
שחק נתיב משיתוף סמבה.

bd://[title][/device] --bluray-device=PATH
הפעל תקליטור Blu-Ray. נכון לעכשיו, זה לא מקבל קבצי ISO. במקום זאת, אתה חייב
העלו את קובץ ה-ISO כמערכת קבצים, והצביעו --bluray-device אל הרכוב
ספרייה ישירות.

dvd://[title|[starttitle]-endtitle][/device] --dvd-device=PATH
הפעל DVD. תפריטי DVD אינם נתמכים. אם לא ניתן כותרת, הכותרת הארוכה ביותר היא
נבחר אוטומטית.

dvdnav:// הוא כינוי ישן עבור DVD:// ועושה בדיוק אותו דבר.

dvdread://...:
הפעל DVD באמצעות קוד libdvdread הישן. זה מה MPlayer ומעלה mpv
גרסאות להשתמש עבור DVD://. השימוש אינו מונע. זה מסופק רק לצורך תאימות
ולמעבר.

tv://[ערוץ][/input_id] --טֵלֶוִיזִיָה-...
טלוויזיה אנלוגית דרך V4L. שימושי גם עבור מצלמות אינטרנט. (לינוקס בלבד.)

pvr:// --pvr-...
PVR. (לינוקס בלבד.)

dvb://[cardnumber@]ערוץ --dvbin-...
טלוויזיה דיגיטלית דרך DVB. (לינוקס בלבד.)

mf://[filemask|@listfile] --mf-...
הפעל סדרה של תמונות כווידאו.

cdda://track[-endtrack][:speed][/device] --cdrom-device=PATH --cdda-...
הפעל תקליטור.

lavf://...
גש לכל פרוטוקול FFmpeg/Libav libavformat. בעיקרון, זה עבר את המיתר
לאחר // ישירות ל-libavformat.

av://type:options
זה מיועד לשימוש בכניסות libavdevice. סוג הוא libavdevice demuxer
שם, ו אפשרויות הוא שם הקובץ (פסאודו-) המועבר ל-demuxer.

לדוגמה, Mpv av://lavfi:mandelbrot עושה שימוש בעטיפת libavfilter
כלול ב-libavdevice, וישתמש ב- מנדלברוט מסנן מקור להפקה
נתוני קלט.

avdevice:// הוא כינוי.

file://PATH
נתיב מקומי ככתובת URL. עשוי להיות שימושי בכמה מקרי שימוש מיוחדים. ציין זאת נתיב
עצמו צריך להתחיל בשליש / להפוך את השביל לנתיב מוחלט.

fd://123
קרא נתונים מה-UNIX FD הנתון (לדוגמה 123). זה דומה לנתוני צנרת
לסטדין דרך -, אבל יכול להשתמש במתאר קובץ שרירותי. לא יעבוד כמו שצריך
ב- MS Windows.

edl://[edl מפרט as in edl-mpv.rst]
חבר חלקים ממספר קבצים והפעל אותם.

ריק://
הדמיית קובץ ריק.

memory://data
השתמש נתונים חלק כנתוני מקור.

מדומה GUI MODE

ל-mpv אין GUI רשמי, מלבד OSC (ON מסך בקר), שאינו מלא
GUI והוא לא אמור להיות. עם זאת, כדי לפצות על היעדר התנהגות GUI צפויה,
mpv במקרים מסוימים יתחיל עם כמה הגדרות ששונו כדי להתנהג מעט יותר כמו GUI
מצב.

כרגע זה קורה רק במקרים הבאים:

· אם התחילו להשתמש ב- mpv.desktop קובץ בלינוקס (למשל התחיל מתפריטים או קובץ
אסוציאציות שמסופקות על ידי סביבות שולחן עבודה)

· אם הופעל מ- explorer.exe ב-Windows (טכנית, אם הוא הופעל ב-Windows, ו
כל נקודות האחיזה של stdout/stderr/stdin לא מוגדרות)

· הוספה ידנית --profile=pseudo-gui לשורת הפקודה

מצב זה מוסיף באופן מרומז --profile=pseudo-gui לשורת הפקודה, עם ה- פסאודו-גוי
פרופיל מוגדר מראש עם התכנים הבאים:

[פסאודו-גוי]
טרמינל=לא
חלון כוח=כן
בטלה = פעם אחת
מדריך צילום מסך=~~שולחן עבודה/

זה עוקב אחר פורמט קובץ התצורה mpv. כדי להתאים אישית מצב פסאודו-GUI, אתה יכול לשים את
שֶׁלוֹ פסאודו-גוי פרופיל לתוך שלך mpv.conf. פרופיל זה ישפר את פרופיל ברירת המחדל,
במקום לדרוס אותו.

הפרופיל תמיד עוקף הגדרות אחרות ב mpv.conf.

אפשרויות

לעקוב בחירה
--alang=
ציין רשימת עדיפות של שפות שמע לשימוש. פורמטים שונים של מיכל
להשתמש בקודי שפה שונים. תקליטורי DVD משתמשים בקודי שפה של שתי אותיות ISO 639-1,
Matroska, MPEG-TS ו-NUT משתמשות בקודי שפה בני שלוש אותיות ISO 639-2, בעוד OGM משתמש
מזהה בצורה חופשית. ראה גם --סיוע.

דוגמאות

Mpv dvd://1 --alang=hu,en
בוחר את הרצועה בשפה ההונגרית ב-DVD ונופל אחורה באנגלית
אם הונגרית אינה זמינה.

Mpv --alang=jpn example.mkv
מנגן קובץ Matroska ביפנית.

--סלנג=
ציין רשימת עדיפות של שפות כתוביות לשימוש. פורמטים שונים של מיכל
להשתמש בקודי שפה שונים. תקליטורי DVD משתמשים בקודי שפה בשתי אותיות ISO 639-1,
Matroska משתמש בקודי שפה של שלוש אותיות ISO 639-2 בעוד OGM משתמש בצורה חופשית
מזהה. ראה גם --סיד.

דוגמאות

· Mpv dvd://1 --slang=hu,en בוחר ברצועת הכתוביות ההונגרית ב-DVD ו
נופל באנגלית אם הונגרית אינה זמינה.

· Mpv --slang=jpn example.mkv מנגן קובץ Matroska עם כתוביות ביפנית.

--עזרה=
בחר רצועת שמע. המכונית בוחר את ברירת המחדל, לא משבית את האודיו. ראה גם --אלנג.
mpv מדפיס בדרך כלל רצועות שמע זמינות במסוף בעת תחילת ההשמעה
של קובץ.

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

ראה גם --סְלֶנְג, --לא-משנה.

--vid=
בחר ערוץ וידאו. המכונית בוחר את ברירת המחדל, לא משבית וידאו.

--ff-aid= , --ff-sid= , --ff-vid=
בחר זרמי אודיו/כתוביות/וידאו לפי אינדקס הזרם של FFmpeg. זרם FFmpeg
האינדקס הוא שרירותי יחסית, אך שימושי בעת אינטראקציה עם תוכנות אחרות
באמצעות FFmpeg (שקול ff בדיקה).

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

--מהדורה=
(רק קבצי Matroska) ציין את המהדורה (קבוצת הפרקים) לשימוש, כאשר 0 הוא ה-
ראשון. אם מוגדר ל המכונית (ברירת המחדל), mpv יבחר את המהדורה הראשונה שהוכרזה כ
ברירת מחדל, או אם אין ברירת מחדל, המהדורה הראשונה מוגדרת.

פלייבק שליטה
--התחל= זמן>
חפש לעמדת זמן נתונה.

הפורמט הכללי לזמנים מוחלטים הוא [[hh:]mm:]ss[.ms]. אם ניתן הזמן
עם קידומת של + or -, החיפוש הוא יחסי מההתחלה או הסוף של הקובץ.
(מאז mpv 0.14, תחילת הקובץ נחשבת תמיד ל-0.)

עמ% מבקש לאחוז מיקום עמודים (0-100).

#c מבקש לפרק מספר ג. (הפרקים מתחילים מ-1.)

דוגמאות

--start=+56, --start=+00:56
מבקש לזמן ההתחלה + 56 שניות.

--start=-56, --start=-00:56
מחפש לזמן הסיום - 56 שניות.

--start=01:10:00
מבקש עד שעה 1 דקות.

--התחלה=50%
מחפש לאמצע הקובץ.

--התחלה=30 --end=40
מחפש עד 30 שניות, משחק 10 שניות ויוצא.

--start=-3:20 --אורך=10
מחפש עד 3 דקות ו-20 שניות לפני סוף הקובץ, מנגן 10
שניות, ויוצא.

--start='#2' --end='#4'
מנגן את פרקים 2 ו-3, ויוצא.

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

--אורך= זמן>
עצור לאחר זמן נתון ביחס לזמן ההתחלה. לִרְאוֹת --הַתחָלָה לאופציה חוקית
ערכים ודוגמאות.

--rebase-start-time=
האם להעביר את שעת ההתחלה של הקובץ ל 00:00:00 (ברירת מחדל: כן). זה פחות
מביך עבור קבצים שמתחילים בחותמת זמן אקראית, כגון זרמי תחבורה. עַל
מצד שני, אם יש איפוסי חותמת זמן, ההתנהגות המתקבלת יכולה להיות די
מְשׁוּנֶה. מסיבה זו, ולמקרה שאתה באמת מתעניין במציאות
חותמות זמן, ניתן להשבית את ההתנהגות הזו לא.

--speed=<0.01-100>
האטו או האצו את ההשמעה לפי הפקטור שניתן כפרמטר.

If --תיקון גובה-שמע (מופעל כברירת מחדל) משמש, משחק עם מהירות גבוהה יותר
מהרגיל מכניס אוטומטית את scaletempo מסנן שמע.

--לולאה=
השמעת לולאות N פִּי. ערך של 1 מנגן אותו פעם אחת (ברירת מחדל), 2 פעמיים וכו'.
inf פירושו לנצח. לא הוא זהה 1 ומשבית לולאה. אם יש כמה קבצים
המצוין בשורת הפקודה, רשימת ההשמעה כולה מופעלת בלולאה.

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

--הַפסָקָה
הפעל את הנגן במצב מושהה.

--לְעַרְבֵּב
הפעל קבצים בסדר אקראי.

--פרק=
ציין באיזה פרק להתחיל לשחק. אופציונלי ציין איזה פרק לסיים
משחק ב. ראה גם --הַתחָלָה.

--playlist-pos=
הגדר עם איזה קובץ ברשימת ההשמעה הפנימית להתחיל את ההשמעה. המדד הוא an
מספר שלם, כאשר 0 משמעותו הקובץ הראשון. הערך לא פירושו שהבחירה של
הערך להפעלה נותר למנגנון חידוש ההשמעה (ברירת מחדל). אם ערך
כאשר האינדקס הנתון אינו קיים, ההתנהגות אינה מוגדרת ועשויה להשתנות
גרסאות mpv עתידיות. כך גם אם רשימת ההשמעה מכילה רשימות השמעה נוספות
(אל תצפו להתנהגות סבירה). העברת קובץ פלייליסט ל-mpv אמור לעבוד
עם אפשרות זו, אבל. לְמָשָׁל Mpv playlist.m3u --playlist-pos=123 יעבוד כמו
צפוי, כל עוד playlist.m3u אינו מקשר לרשימות השמעה נוספות.

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

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

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

רשימת השמעה יכולה להכיל ערכים באמצעות פרוטוקולים אחרים, כגון קבצים מקומיים, או
(החמור ביותר), פרוטוקולים מיוחדים כמו avdevice://, שהם מטבעם
מְסוּכָּן.

--chapter-merge-threshold=
סף למיזוג חלקי פרק מסודרים כמעט ברצף באלפיות שניות
(ברירת מחדל: 100). לחלק מקבצי Matroska עם פרקים מסודרים יש פרקים לא מדויקים
חותמות זמן סיום, מה שגורם לפער קטן בין סוף פרק אחד לתחילתו של
הבא כשהם צריכים להתאים. אם סוף חלק השמעה אחד קטן מ
הסף הנתון הרחק מההתחלה של הסף הבא ואז המשך לנגן וידאו
בדרך כלל החלפת פרק במקום לעשות חיפוש.

--chapter-seek-threshold=
מרחק בשניות מתחילת פרק שבתוכו פרק אחורה
seek יעבור לפרק הקודם (ברירת מחדל: 5.0). מעבר לסף זה, א
חיפוש פרק אחורה יעבור במקום זאת לתחילת הפרק הנוכחי. א
ערך שלילי פירושו תמיד לחזור לפרק הקודם.

--hr-seek=
בחר מתי להשתמש בחיפושים מדויקים שאינם מוגבלים לפריימים מפתח. מחפשות כאלה
דורשים פענוח וידאו מהפריים המפתח הקודם ועד למיקום היעד וכך
יכול לקחת קצת זמן בהתאם לביצועי הפענוח. עבור כמה פורמטי וידאו,
חיפושים מדויקים מושבתים. אפשרות זו בוחרת את בחירת ברירת המחדל לשימוש עבורה
מחפש; ניתן לעקוף במפורש את ברירת המחדל בהגדרת המפתח
כריכות ופקודות במצב עבד.

לא לעולם אל תשתמש בחיפושים מדויקים.

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

כן השתמש בחיפושים מדויקים במידת האפשר.

תמיד כמו כן (לצורך תאימות).

--hr-seek-demuxer-offset=
אפשרות זו קיימת כדי לעקוף כשלים בביצוע חיפושים מדויקים (כמו ב --hr-חפש)
נגרמת על ידי באגים או מגבלות ב-demuxers עבור פורמטים מסוימים של קבצים. כמה דגמי דגמים
לא מצליחים לחפש פריים מפתח לפני מיקום היעד הנתון, מעבר למאוחר יותר
עמדה במקום. הערך של אפשרות זו מופחת מחותמת הזמן שניתנה
ל-demuxer. לפיכך, אם תגדיר אפשרות זו ל-1.5 ותנסה לבצע חיפוש מדויק
60 שניות, נאמר ל-deluxer לחפש זמן 58.5, מה שבתקווה מקטין את
סיכוי שהוא עובר בטעות לזמן מה מאוחר מ-60 שניות. החיסרון של
הגדרת אפשרות זו היא שחיפושים מדויקים נעשים איטיים יותר, כמו וידאו בין ה
ייתכן שעמדה מוקדמת יותר של ה-Deuxer והמטרה האמיתית יפוענחו שלא לצורך.

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

ברירת מחדל: כן

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

ברירת מחדל
השתמש באינדקס אם לקובץ יש כזה, או בנה אותו אם חסר

ליצור מחדש
אל תקרא ואל תשתמש באינדקס של הקובץ

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

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

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

--loop-file=
גלגל קובץ בודד N פעמים. inf פירושו לנצח, לא פירושו השמעה רגילה. ל
תְאִימוּת, --לולאה-קובץ ו --לולאה-קובץ=כן מתקבלים גם הם, והם זהים
as --loop-file=inf.

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

--ab-loop-a= , --ab-loop-b=
הגדר נקודות לולאה. אם ההשמעה עוברת את b חותמת זמן, הוא יחפש את a
חותמת זמן. מחפש מעבר ל b הנקודה לא עוברת לולאה (זה מכוון). ה
ניתן לכוונן נקודות לולאה בזמן ריצה עם המאפיינים המתאימים. ראה גם
ab_loop פקודה.

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

--ordered-chapters-files=
טוען את הקובץ הנתון כפלייליסט, ומנסה להשתמש בקבצים הכלולים בו בתור
קבצי הפניה בעת פתיחת קובץ Matroska המשתמש בפרקים מסודרים. זֶה
עוקף את המנגנון הרגיל לטעינת קבצים עם הפניה על ידי סריקת אותם
ספרייה בה נמצא הקובץ הראשי.

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

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

--chapters-file=
טען פרקים מקובץ זה, במקום להשתמש במטא נתונים של הפרקים שנמצאים ב-
הקובץ הראשי.

--שלב=
לדלג שניות אחרי כל פריים.

הערה:
ללא --hr-חפש, דילוג יצמד לפריימים מפתח.

--stop-playback-on-init-failure=
הפסק את ההשמעה אם אודיו או וידאו לא מצליחים לאתחל. נכון לעכשיו, ברירת המחדל
התנהגות היא לא עבור נגן שורת הפקודה, אבל כן עבור libmpv. עם לא, השמעה
ימשיך במצב וידאו בלבד או אודיו בלבד אם אחד מהם נכשל. זה לא
להשפיע על השמעה של קבצי אודיו בלבד או וידאו בלבד.

תָכְנִית התנהגות
- עזרה הצג סיכום קצר של אפשרויות.

-v הגדל את רמת הדיבור, רמה אחת לכל אחד -v נמצא בשורת הפקודה.

--גִרְסָה, -V
מחרוזת גרסת הדפסה ויציאה.

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

הערה:
קבצים שהתבקשו במפורש על ידי אפשרויות שורת הפקודה, כמו --לִכלוֹל or
--use-filedir-conf, עדיין ייטען.

ראה גם --config-dir.

--אפשרויות רשימה
מדפיס את כל האפשרויות הזמינות.

--רשימה-מאפיינים
הדפס רשימה של הנכסים הזמינים.

-- רשימה-פרוטוקולים
הדפס רשימה של הפרוטוקולים הנתמכים.

--log-file=
פותח את הנתיב הנתון לכתיבה והדפס אליו הודעות יומן. קבצים קיימים יעשו זאת
להיות קטוע. רמת היומן תמיד תואמת -v, ללא קשר למסוף
רמות מילוליות.

--config-dir=
כפה ספריית תצורה אחרת. אם זה מוגדר, הספרייה הנתונה היא
משמש לטעינת קובצי תצורה, וכל ספריות התצורה האחרות כן
התעלמו. משמעות הדבר היא ספריית תצורת mpv העולמית וכן לכל משתמש
מתעלמים מהספריות והן עוקפות באמצעות משתני סביבה (MPV_HOME) הם
גם התעלמו.

שים לב כי --ללא תצורה אפשרות עדיפות על אפשרות זו.

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

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

--dump-stats=
כתוב נתונים סטטיסטיים מסוימים לקובץ הנתון. הקובץ נחתך בפתיחה. ה
הקובץ יכיל דוגמאות גולמיות, כל אחת עם חותמת זמן. כדי להפוך את הקובץ הזה ל-a
קריא, התסריט TOOLS/stats-conv.py ניתן להשתמש (שמציג אותו כעת
בתור גרף).

אפשרות זו שימושית עבור ניפוי באגים בלבד.

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

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

--include=
ציין את קובץ התצורה שיש לנתח לאחר ברירת המחדל.

--load-scripts=
אם מוגדר ל לא, אל תטען אוטומטית סקריפטים מה- סקריפטים ספריית משנה של תצורה
(בדרך כלל ~/.config/mpv/scripts/). (בְּרִירַת מֶחדָל: כן)

--script=
טען סקריפט Lua. אתה יכול לטעון סקריפטים מרובים על ידי הפרדתם באמצעות פסיקים
(,).

--script-opts=key1=value1,key2=value2,...
הגדר אפשרויות עבור סקריפטים. סקריפט יכול לשאול אפשרות באמצעות מפתח. אם נעשה שימוש באופציה
ואיזו סמנטיקה יש לערך האופציה תלויה לחלוטין בסקריפטים הטעונים.
מתעלמים מערכים שלא נתבעו על ידי סקריפטים.

--מיזוג קבצים
העמד פנים שכל הקבצים המועברים ל-mpv משורשרים לקובץ אחד וגדול. זֶה
משתמש בתמיכה בציר זמן/EDL באופן פנימי. שימו לב שזה לא יעבוד עבור פרקים שהוזמנו
קבצים.

--ללא הפעלה מחדש
אין לשחזר את מיקום ההשמעה מה- צפה מאוחר יותר ספריית משנה של תצורה
(בדרך כלל ~/.config/mpv/watch_later/). ראה צא_לצפייה_מאוחר יותר פקודת קלט.

--פרופיל=
השתמש בפרופיל/ים הנתונים, --פרופיל=עזרה מציג רשימה של הפרופילים המוגדרים.

--reset-on-next-file=
בדרך כלל, mpv ינסה לשמור את כל ההגדרות בעת הפעלת הקובץ הבא ב-
רשימת השמעה, גם אם הם שונו על ידי המשתמש במהלך ההשמעה. (התנהגות זו היא
ההפך מזה של MPlayer, שמנסה לאפס את כל ההגדרות בעת ההפעלה הבאה
קוֹבֶץ.)

ברירת מחדל: אל תאפס שום דבר.

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

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

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

דוגמאות

· --reset-on-next-file=pause אפס את מצב ההשהיה בעת מעבר לקובץ הבא.

· --reset-on-next-file=מסך מלא, מהירות אפס מסך מלא ומהירות השמעה
הגדרות אם הם שונו במהלך ההשמעה.

· --reset-on-next-file=all נסה לאפס את כל ההגדרות ששונו במהלך
השמעה.

--write-filename-in-watch-later-config
הכנס את קובצי התצורה של השעון מאוחר יותר עם שם הקובץ שאליו הם מתייחסים. זֶה
פשוט נכתב כהערה בחלק העליון של הקובץ.

אזהרה:
אפשרות זו עלולה לחשוף מידע רגיש לפרטיות ולכן מושבתת על ידי
ברירת המחדל.

--ignore-path-in-watch-later-config
התעלם מנתיב (כלומר השתמש בשם הקובץ בלבד) בעת שימוש בתכונת צפה מאוחר יותר.

--show-profile=
הצג את התיאור והתוכן של פרופיל.

--use-filedir-conf
חפש קובץ תצורה ספציפי לקובץ באותה ספרייה כמו הקובץ
משחק. לִרְאוֹת ספציפי לקובץ תְצוּרָה קבצים.

אזהרה:
עלול להיות מסוכן אם משחקים ממדיה לא מהימנה.

--ytdl, --no-ytdl
אפשר את youtube-dl hook-script. זה יסתכל בכתובת ה-URL של הקלט, וינגן את
סרטון הממוקם באתר. זה עובד עם אתרי סטרימינג רבים, לא רק עם
כזה שעל שמו נקרא התסריט. זה דורש גרסה עדכנית של youtube-dl ל
להיות מותקן על המערכת. (מופעל כברירת מחדל, למעט כאשר ה-API של הלקוח /
נעשה שימוש ב-libmpv.)

אם הסקריפט לא יכול לעשות שום דבר עם כתובת URL, הוא לא יעשה כלום.

--ytdl-format=
פורמט/איכות וידאו שמועבר ישירות ל-youtube-dl. הערכים האפשריים הם
ספציפית לאתר ולסרטון, עבור כתובת אתר נתונה הפורמטים הזמינים יכולים להיות
נמצא עם הפקודה youtube-dl --פורמטים של רשימה כתובת האתר. ראה youtube-dl's
תיעוד עבור כינויים זמינים. (ברירת מחדל: ברירת המחדל של youtube-dl, כרגע
bestvideo+bestaudio/best)

--ytdl-raw-options= = [, = [,...]]
העבר אפשרויות שרירותיות ל-youtube-dl. יש להעביר פרמטר וארגומנט כ-a
צמד מפתח-ערך. אפשרויות ללא ארגומנט חייבות לכלול =.

אין בדיקת שפיות ולכן אפשר לשבור דברים (כלומר מעבר פסול
פרמטרים ל-youtube-dl).

דוגמה

--ytdl-raw-options=username=user, password=pass
--ytdl-raw-options=force-ipv6=

וִידֵאוֹ
--vo=
ציין רשימת עדיפות של מנהלי התקנים של פלט וידאו לשימוש. לשימוש אינטראקטיבי,
בדרך כלל יש לציין אחד לשימוש, אבל בקבצי תצורה,
ציון רשימה של תקלות עשוי להיות הגיוני. לִרְאוֹת וידאו תפוקה נהגים לפרטים
ותיאורים של מנהלי התקנים זמינים.

--vd=<[+|-]משפחה1:(*|מפענח1),[+|-]משפחה2:(*|מפענח2),...[-]>
ציין רשימת עדיפות של מפענחי וידאו שבהם יש להשתמש, לפי משפחתם ו
שֵׁם. לִרְאוֹת --מוֹדָעָה לפרטים נוספים. שתי האפשרויות הללו משתמשות באותו תחביר ו
סֵמַנטִיקָה; ההבדל היחיד הוא שהם פועלים על רשימות codec שונות.

הערה:
לִרְאוֹת --vd=עזרה לרשימה מלאה של מפענחים זמינים.

--vf=
ציין רשימה של מסנני וידאו להחלה על זרם הווידאו. לִרְאוֹת וידאו מסננים ל
פרטים ותיאורים של המסננים הזמינים. גרסאות האופציות --vf-add,
--vf-pre, --vf-del ו --vf-clr קיים כדי לשנות רשימה שצוינה קודם לכן, אבל
אתה לא צריך להזדקק לאלה לשימוש טיפוסי.

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

mpv ינסה להוריד את האודיו רק אם המדיה מוזרמת עם youtube-dl,
כי זה חוסך רוחב פס. זה נעשה על ידי הגדרת ytdl_format ל
"bestaudio/best" בסקריפט ytdl_hook.lua.

--ללא זמן
אל תישן בעת ​​הוצאת מסגרות וידאו. שימושי עבור אמות מידה כאשר נעשה שימוש עם
--אין שמע.

--framedrop=
דלג על הצגת כמה פריימים כדי לשמור על סינכרון A/V במערכות איטיות, או משחק גבוה
וידאו בקצב פריימים ביציאות וידאו שיש להם מגבלת קצב פריימים עליון.

הארגומנט בוחר את שיטות השחרור ויכול להיות אחד מהבאים:

השבת כל שחרור מסגרות.

זרוק פריימים מאוחרים בפלט וידאו (ברירת מחדל). זה עדיין מפענח ומסנן
כל הפריימים, אבל לא מעבד אותם ב-VO. הוא מנסה לשאול את התצוגה
FPS (X11 בלבד, לא נכון במערכות מרובות צגים), או מניח אינסופי
הצג FPS אם זה נכשל. נפילות מסומנות בשורת המצב של הטרמינל
as D: שדה. אם המפענח איטי מדי, בתיאוריה כל הפריימים יצטרכו לעשות זאת
להפיל (כי כל הפריימים מאוחר מדי) - כדי למנוע זאת, נפילת פריימים
מפסיק אם קצב המסגרות האפקטיבי נמוך מ-10 FPS.


מצב מסגרת ישן, מבוסס מפענח. (זה אותו דבר כמו --framedrop=כן in
mpv 0.5.x ומעלה.) זה אומר למפענח לדלג על פריימים (אלא אם כן
נחוצים כדי לפענח מסגרות עתידיות). יכול לעזור עם מערכות איטיות, אבל יכול
לייצר פלט קצוץ בלתי ניתן לצפייה, או אפילו להקפיא את התצוגה לחלוטין.
לא מומלץ. ה --vd-lavc-framedrop אפשרות שולטת לאילו מסגרות
טיפה.


אפשר את שני המצבים. לא מומלץ.

הערה:
--vo=vdpau יש קוד משלו עבור vo מצב פריימדרופ. הבדלים קלים ל
VOs אחרים אפשריים.

--display-fps=
הגדר את ה-FPS לתצוגה בשימוש עם --video-sync=display-* מצבים. כברירת מחדל א
נעשה שימוש בערך מזוהה (X11 בלבד, לא נכון במערכות מרובות צגים). לשמור ב
שימו לב שהגדרת ערך שגוי (גם אם מעט שגוי) עלולה להרוס את הסרטון
השמעה.

--hwdec=
ציין את ה-API של פענוח וידאו החומרה שבו יש להשתמש במידת האפשר. האם
פענוח החומרה מתבצע למעשה תלוי ב-codec הווידאו. אם פענוח חומרה
אינו אפשרי, mpv יחזור על פענוח תוכנה.

יכול להיות אחד מהבאים:

לא השתמש תמיד בפענוח תוכנה (ברירת מחדל)

המכונית ראה להלן

vdpau דורש --vo=vdpau or --vo=opengl (לינוקס בלבד)

ואפי דורש --vo=opengl or --vo=vaapi (לינוקס בלבד)

vaapi-copy
מעתיק וידאו חזרה ל-RAM של המערכת (לינוקס עם מעבדי Intel GPU בלבד)

ארגז כלי וידאו
דורש --vo=opengl (OS X 10.8 ומעלה בלבד)

dxva2-copy
מעתיק וידאו בחזרה ל-RAM של המערכת (Windows בלבד)

rpi דורש --vo=rpi (Raspberry Pi בלבד - ברירת מחדל אם זמינה)

המכונית מנסה לאפשר אוטומטית פענוח חומרה באמצעות הראשון הזמין
שיטה. זה עדיין תלוי באיזה VO אתה משתמש. לדוגמה, אם אתה לא משתמש
--vo=vdpau or --vo=opengl, פענוח vdpau לעולם לא יופעל. שימו לב גם שאם
השיטה הראשונה שנמצאה לא באמת עובדת, היא תמיד תחזור לתוכנה
פענוח, במקום לנסות את השיטה הבאה (ייתכן שישנה במערכות לינוקס מסוימות).

השמיים ואפי מצב, אם נעשה בו שימוש עם --vo=opengl, דורש Mesa 11 וכנראה עובד
עם GPUs של אינטל בלבד. זה גם דורש את ה-opengl EGL backend (בשימוש אוטומטי
אם זמין). אתה יכול גם לנסות את הקצה האחורי הישן של GLX על ידי כפייתו
--vo=opengl:backend=x11, אבל אומרים שהאינטררופ vaapi/GLX איטי יותר מ
vaapi-copy.

השמיים vaapi-copy מצב מאפשר לך להשתמש ב-vaapi עם כל VO. כי זה מעתיק את
וידאו מפענח בחזרה ל-RAM של המערכת, סביר להניח שהוא פחות יעיל מה- ואפי מצב.

הערה:
בעת שימוש במתג זה, פענוח החומרה עדיין נעשה רק עבור רכיבי קודקים מסוימים.
לִרְאוֹת --hwdec-codec כדי לאפשר פענוח חומרה עבור רכיבי קודקים נוספים.

--hwdec-preload=
זה שימושי עבור פתוח ו opengl-cb VOs ליצירת פענוח החומרה
הקשר אינטררופ של OpenGL, אך מבלי לאפשר למעשה פענוח החומרה עצמו
(כמו --hwdec עושה).

אם מוגדר ל לא (ברירת מחדל), ה --hwdec נעשה שימוש באופציה.

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

בעד opengl-cb, אם מוגדר, טען את ההקשר האינטררופי ברגע שהקשר OpenGL הוא
נוצר. מאז opengl-cb אין טעינה לפי דרישה, זה מאפשר הפעלת חומרה
פענוח בזמן ריצה בכלל, ללא צורך להגדיר באופן זמני את hwdec אוֹפְּצִיָה
רק במהלך אתחול ההקשר של OpenGL עם mpv_opengl_cb_init_gl().

--videotoolbox-format=
הגדר את פורמט הפיקסלים הפנימי שבו נעשה שימוש --hwdec=ארגז כלי וידאו ב-OSX. הבחירה של
הפורמט יכול להשפיע במידה ניכרת על הביצועים. מצד שני, אין
נראה כדרך טובה לזהות את הפורמט הטוב ביותר עבור החומרה הנתונה. Nv12, ה
ברירת מחדל, עובד טוב יותר בחומרה מודרנית, בעוד uyvy422 נראה טוב יותר עבור
חומרה ישנה. rgb0 גם עובד.

--panscan=<0.0-1.0>
מאפשר פונקציונליות פאן וסריקה (חיתוך צדדים של סרטון 16:9 למשל כדי ליצור
זה מתאים לתצוגה של 4:3 ללא פסים שחורים). הטווח שולט בכמה מהתמונה
נחתך. ייתכן שלא יפעל עם כל מנהלי ההתקן של פלט הווידאו.

--video-aspect=
לעקוף את יחס הגובה-רוחב של הסרטון, במקרה שמידע גובה-רוחב שגוי או חסר
הקובץ המושמע. ראה גם --ללא היבט וידאו.

לשני ערכים יש משמעות מיוחדת:

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

-1 השתמש בהיבט של זרם הווידאו או המכולה (ברירת מחדל)

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

דוגמאות

· --video-aspect=4:3 or --video-aspect=1.3333

· --video-aspect=16:9 or --video-aspect=1.7777

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

--video-aspect-method=
זה מגדיר את ברירת המחדל של שיטת קביעת היבט הווידאו (אם ההיבט הוא _לא_
עוקף על ידי המשתמש עם --היבט וידאו או אחרים).

כלאים העדיפו את יחס הגובה-רוחב של מיכל. אם היבט זרם הסיביות משתנה
באמצע הזרם, עבור להעדפת היבט זרם הסיביות. זוהי ברירת המחדל
התנהגות ב-mpv ו-mplayer2.

מכולה
העדיפו בהחלט את יחס הגובה-רוחב של מיכל. זו כנראה ברירת המחדל
התנהגות עם VLC, לפחות עם Matroska.

זרם סיביות
העדיפו בהחלט את יחס הגובה-רוחב של זרם הסיביות, אלא אם כן היבט של זרם הסיביות
היחס לא נקבע. זו כנראה התנהגות ברירת המחדל עם XBMC/kodi, ב
לפחות עם מאטרוסקה.

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

-- וידאו ללא קנה מידה
השבת את קנה המידה של הסרטון. אם החלון גדול מהסרטון, פסים שחורים
מתווספים. אחרת, הסרטון נחתך. הסרטון עדיין יכול להיות מושפע
האחרים --וִידֵאוֹ-... אפשרויות. (אבל לא כולם; למשל -- וידאו-זום לא עושה כלום
אם אפשרות זו מופעלת.)

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

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

אפשרות זו מושבתת אם --ללא שמירה נעשה שימוש באופציה.

--video-pan-x= , --video-pan-y=
מזיז את מלבן הווידאו המוצג בערך הנתון לכיוון X או Y. ה
היחידה היא בחלקים מהגודל של הסרטון המוקטן (בגודל מלא, גם אם חלקים
מהסרטון אינם גלויים עקב panscan או אפשרויות אחרות).

לדוגמה, הצגת סרטון 1280x720 מסך מלא על מסך 1680x1050 עם
--video-pan-x=-0.1 יעביר את הסרטון 168 פיקסלים שמאלה (מה שהופך 128 פיקסלים
של סרטון המקור בלתי נראה).

אפשרות זו מושבתת אם --ללא שמירה נעשה שימוש באופציה.

--video-rotate=<0-360|לא>
סובב את הסרטון בכיוון השעון, במעלות. כרגע תומך בצעדים של 90° בלבד. אם לא
נתון, הסרטון לעולם אינו מסובב, גם אם לקובץ יש מטא נתונים של סיבוב. (ה
ערך הסיבוב מתווסף למטא נתונים של הסיבוב, כלומר הערך 0 היה
סובב את הסרטון בהתאם למטא נתונים של הסיבוב.)

--video-stereo-mode=
הגדר את מצב פלט 3D סטריאו (ברירת מחדל: מונו). זה נעשה על ידי הכנסת ה-
stereo3d מסנן המרות.

המצב הפסאודו לא משבית את ההמרה האוטומטית לחלוטין.

המצב מונו הוא כינוי ל- ml, המתייחס למסגרת השמאלית ב-2D. זה
ברירת המחדל, כלומר mpv ינסה להציג סרטי תלת מימד בדו מימד, במקום המנוגד
תמונה תלת מימדית לא מיועדת לצריכה (כגון הצגת המסגרת השמאלית והימנית
זה לצד זה וכו').

השתמש --video-stereo-mode=עזרה לרשימת כל המצבים הזמינים. בדוק עם stereo3d
סנן תיעוד כדי לראות מה משמעות השמות. שימו לב שכמה שמות מתייחסים אליהם
מצבים שאינם נתמכים על ידי stereo3d - מצבים אלה יכולים להופיע בקבצים, אך אינם יכולים להיות
מטופל כהלכה על ידי mpv.

--video-zoom=
התאם את מקדם קנה המידה של תצוגת הווידאו לפי הערך הנתון. היחידה נמצאת בשברים
של גודל הווידאו של החלון (בקנה מידה).

לדוגמה, בהינתן סרטון 1280x720 המוצג בחלון 1280x720, --video-zoom=-0.1
יקטן את הסרטון ב-128 פיקסלים בכיוון X, ו-72 פיקסלים ב-Y
כיוון.

אפשרות זו מושבתת אם --ללא שמירה נעשה שימוש באופציה.

--video-align-x=<-1-1>, --video-align-y=<-1-1>
מזיז את מלבן הווידאו בתוך הגבולות השחורים, שבדרך כלל מתווספים לרפידה
הסרטון למסך אם יחסי הגובה-רוחב של הווידאו והמסך שונים.
--video-align-y=-1 יעביר את הסרטון לחלק העליון של המסך (משאיר גבול
רק בתחתית), ערך של 0 מרכז אותו (ברירת מחדל), וערך של 1 היה שם
הסרטון בתחתית המסך.

אם היבט הווידאו והמסך תואמים בצורה מושלמת, אפשרויות אלה לא עושות דבר.

אפשרות זו מושבתת אם --ללא שמירה נעשה שימוש באופציה.

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

--fps=
לעקוף את קצב פריימים של וידאו. שימושי אם הערך המקורי שגוי או חסר.

הערה:
עובד ב --לא-נכונות-נקודות מצב בלבד.

--deinterlace=
הפעל או השבת את השזירה (ברירת מחדל: אוטומטי, כלומר בדרך כלל לא). שלובים
הסרטון מציג חפצים דמויי מסרק מכוערים, הנראים בתנועה מהירה. מפעיל
זה בדרך כלל מכניס את מסנן הווידאו של yadif כדי לבטל את השזירה של הסרטון, או
מאפשר לפלט הווידאו להחיל deinterlacing אם הוא נתמך.

זה מתנהג בדיוק כמו ה deinterlace מאפיין קלט (בדרך כלל ממופה ל d).

המכונית הוא עניין טכני. באופן קפדני, ברירת המחדל עבור אפשרות זו היא
deinterlacing מושבת, אבל המכונית יש צורך במקרה אם yadif נוסף ל
שרשרת סינון ידנית עם --vf. אז הליבה לא אמורה להשבית את ה-deinterlacing רק
בגלל --deinterlace לא נקבע.

--שדה-דומיננטיות=
הגדר שדה ראשון עבור תוכן משולב. שימושי עבור deinterlacers להכפיל את
קצב מסגרת: --vf=yadif=שדה ו --vo=vdpau:deint.

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

חלק עליון שדה עליון ראשון

תחתית שדה תחתון ראשון

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

--מסגרות=
הפעל/המר רק תחילה מסגרות וידאו ואז צא.

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

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

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

לא כל VOs תומכים באפשרות זו. חלקם יתעלמו מזה בשקט.

טווחי הצבעים הזמינים הם:

המכונית בחירה אוטומטית (שווה לטווח מלא) (ברירת מחדל)

מוגבל
טווח מוגבל (16-235 לכל רכיב), רמות סטודיו

מלא טווח מלא (0-255 לכל רכיב), רמות PC

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

--hwdec-codecs=
אפשר פענוח חומרה עבור רשימה נתונה של codec בלבד. הערך המיוחד את כל
תמיד מאפשר את כל הקודקים.

אתה יכול לקבל את רשימת ה-codec המותרים עם Mpv --vd=עזרה. הסר את הקידומת, למשל
במקום lavc:h264 להשתמש h264.

כברירת מחדל זה מוגדר ל h264,vc1,wmv3,hevc,mpeg2video. שימו לב שהחומרה
תאוצה קודקים מיוחדים כמו h264_vdpau לא רלוונטיים יותר, ולמעשה
הוסרו מליבב בצורה זו.

זה בדרך כלל נחוץ רק עם GPUs שבורים, שבהם דווח על codec
נתמך, אבל פענוח גורם ליותר בעיות ממה שהוא פותר.

דוגמה

Mpv --hwdec=vdpau --vo=vdpau --hwdec-codecs=h264,mpeg2video
אפשר פענוח vdpau עבור h264 ו-mpeg2 בלבד.

--vd-lavc-check-hw-profile=
בדוק את פרופיל מפענח החומרה (ברירת מחדל: כן). אם לא מוגדר, הפרופיל הגבוה ביותר של
מפענח החומרה נבחר ללא תנאי, והפענוח נאלץ גם אם
הפרופיל של הסרטון גבוה מזה. סביר להניח שהתוצאה שבורה
פענוח, אבל עשוי גם לעזור אם הפרופילים שזוהו או המדווחים הם איכשהו
לֹא נָכוֹן.

--vd-lavc-software-fallback=
חזרה לפענוח תוכנה אם המפענח המואץ בחומרה נכשל (ברירת מחדל:
3). אם זה מספר, אזי תופעל נפילה אם N מסגרות לא מצליחות לפענח
ברצף. 1 שווה ערך ל כן.

--vd-lavc-bitexact
השתמש רק באלגוריתמים מדויקים לסיביות בכל שלבי הפענוח (לבדיקת Codec).

--vd-lavc-fast (MPEG-2, MPEG-4, ו H.264 בלבד)
אפשר אופטימיזציות שאינן תואמות למפרט הפורמט ו
עלול לגרום לבעיות, כמו דה-קוונטיזציה פשוטה יותר, תנועה פשוטה יותר
פיצוי, בהנחה ששימוש במטריצת הקוונטיזציה המוגדרת כברירת מחדל, בהנחה של YUV 4:2:0
ודילוג על כמה בדיקות כדי לזהות זרמי סיביות פגומים.

--vd-lavc-o= = [, = [,...]]
העבר AVOptions למפענח libavcodec. שימו לב, תיקון להכנת o= מיותר ו
להעביר את כל האפשרויות הלא ידועות דרך מערכת AVOption יתקבל בברכה. רשימה מלאה של
AVOptions ניתן למצוא במדריך FFmpeg.

ניתן להגדיר כמה אפשרויות שבעבר היו אפשרויות ישירות באמצעות מנגנון זה, כמו
באג, אפור, idct, ec, vismv, skip_top (היה st), skip_bottom (היה sb), באגים.

דוגמה

--vd-lavc-o=debug=תמונה

--vd-lavc-show-all=
הצג אפילו מסגרות שבורות/פגומות (ברירת מחדל: לא). אם אפשרות זו מוגדרת לא,
libavcodec לא יוציא מסגרות שפוענחו לפני מסגרת מפתח ראשונית
פוענח, או מסגרות שזוהו כפגומות.

--vd-lavc-skiploopfilter= (H.264 בלבד)
דילוג על מסנן הלולאה (AKA deblocking) במהלך פענוח H.264. מאז המסונן
המסגרת אמורה לשמש כרפרנס לפענוח פריימים תלויים, יש לזה א
השפעה גרועה יותר על האיכות מאשר לא לבצע ביטול חסימה בווידאו MPEG-2 למשל. אבל ב
לפחות עבור HDTV בקצב סיביות גבוה, זה מספק מהירות מוגברת עם מעט גלוי
אובדן איכות.

יכול להיות אחד מהבאים:

אף לא אחד לעולם אל תדלג.

ברירת מחדל
דלג על שלבי עיבוד חסרי תועלת (למשל חבילות בגודל 0 ב-AVI).

nonref דלג על מסגרות שאין להן הפניות (כלומר אינן משמשות לפענוח אחרות
מסגרות, השגיאה לא יכולה "להיבנות").

בדיר דלג על B-Frames.

ננקי דלג על כל המסגרות למעט מסגרות מפתח.

את כל דלג על כל המסגרות.

--vd-lavc-skipidct= (MPEG-1/2 בלבד)
מדלג על שלב ה-IDCT. זה פוגע מאוד באיכות כמעט בכל המקרים (ראה
skiploopfilter עבור ערכי דילוג זמינים).

--vd-lavc-skipframe=
מדלג לחלוטין על פענוח מסגרות. מהירות גדולה, אבל תנועה קופצנית ולפעמים
חפצים רעים (ראה skiploopfilter לערכי דילוג זמינים).

--vd-lavc-framedrop=
הגדר מצב שחרור מסגרות בשימוש עם --framedrop (ראה skiploopfilter לדילוג זמין
ערכים).

--vd-lavc-threads=
מספר החוטים לשימוש לפיענוח. האם השרשור אכן נתמך
תלוי ב-codec (ברירת מחדל: 0). 0 פירושו זיהוי אוטומטי של מספר הליבות במכונה
והשתמש בזה, עד למקסימום של 16. אתה יכול להגדיר יותר מ-16 שרשורים באופן ידני.

אודיו
--audio-pitch-correction=
אם זה מופעל (ברירת מחדל), משחק במהירות שונה מהרגיל
מכניס אוטומטית את scaletempo מסנן שמע. לפרטים, ראה מסנן שמע
סָעִיף.

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

אתה יכול לרשום התקני שמע עם --audio-device=help. זה מוציא את שם המכשיר
במרכאות, ואחריו תיאור. שם המכשיר הוא מה שאתה צריך להעביר אליו
מה היא --מכשיר אודיו אוֹפְּצִיָה.

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

שים לב שלהרבה AOs יש א מכשיר אפשרות משנה, אשר עוקפת את בחירת המכשיר
של אפשרות זו (אך לא בחירת פלט השמע). באופן דומה, לכפות AO עם
--ao יעקוף את בחירת פלט האודיו של --מכשיר אודיו (אבל לא המכשיר
בְּחִירָה).

כרגע לא מיושם עבור רוב ה-AOs.

--audio-fallback-to-null=
אם לא ניתן לפתוח מכשיר שמע, התנהג כאילו --ao=null ניתנה. זה שימושי
בקומבינציה עם --מכשיר אודיו: במקום לגרום לשגיאה אם ​​נבחר
המכשיר אינו קיים, משתמש ה-API של הלקוח (או סקריפט Lua) יכול לאפשר השמעה
המשך כרגיל, ובדוק את הנוכחי-ao ו רשימת התקני שמע נכסים ל
לקבל החלטות ברמה גבוהה כיצד להמשיך.

--ao=
ציין רשימת עדיפות של מנהלי התקנים של פלט אודיו לשימוש. לשימוש אינטראקטיבי אחד
בדרך כלל יציין אחד לשימוש, אך בקובצי תצורה מציינים את א
רשימת הנפילות עשויה להיות הגיונית. לִרְאוֹת שמע תפוקה נהגים לפרטים ו
תיאורים של מנהלי התקנים זמינים.

--af=
ציין רשימה של מסנני אודיו להחלה על זרם האודיו. לִרְאוֹת שמע מסננים ל
פרטים ותיאורים של המסננים הזמינים. גרסאות האופציות --af-add,
--af-pre, --אף-דל ו --af-clr קיים כדי לשנות רשימה שצוינה קודם לכן, אבל
אתה לא צריך להזדקק לאלה לשימוש טיפוסי.

--audio-spdif=
רשימת קודקים שעבורם יש להשתמש במעבר שמע דחוס. זה עובד
הן עבור S/PDIF הקלאסי והן עבור HDMI.

קודקים אפשריים הם ac3, dts, dts-hd. ניתן לציין מספר קודקים על ידי
להפריד אותם עם ,. dts מתייחס לליבה DTS נמוכה בקצב סיביות, בעוד dts-hd מתייחס
DTS MA (תמיכה במקלט ובמערכת ההפעלה משתנה). אתה צריך להשתמש רק בשני dts or dts-hd
(אם שניהם מצוינים, ו dts מגיע ראשון, בלבד dts יהיה בשימוש).

באופן כללי, כל ה-Codec ב- spdif המשפחה הרשומה עם --ad=עזרה נתמכים ב
תֵאוֹרִיָה.

אזהרה

אין הרבה סיבה להשתמש בזה. HDMI תומך בלא דחוס
PCM רב ערוצי, ו-mpv תומכים בפענוח DTS-HD ללא הפסדים באמצעות FFmpeg's
מעטפת libdcadec.

--ad=<[+|-]משפחה1:(*|מפענח1),[+|-]משפחה2:(*|מפענח2),...[-]>
ציין רשימת עדיפות של מפענחי אודיו שבהם יש להשתמש, בהתאם למשפחתם ו
שם המפענח. ערכים כמו מִשׁפָּחָה:* לתת עדיפות לכל המפענחים של המשפחה הנתונה.
בעת קביעה באיזה מפענח להשתמש, המפענח הראשון שתואם את האודיו
הפורמט נבחר. אם זה לא זמין, נעשה שימוש במפענח הבא. לבסוף, זה
מנסה את כל המפענחים האחרים שלא נבחרו או נדחו במפורש על ידי
אוֹפְּצִיָה.

- בסוף הרשימה מדכא את החזרה על מפענחים זמינים אחרים שאינם ב-
--מוֹדָעָה רשימה. + מול כניסה מאלץ את המפענח. שני אלה לא צריכים
בדרך כלל משתמשים בהם, מכיוון שהם שוברים את הבחירה האוטומטית הרגילה של המפענח!

- מול ערך משבית את בחירת המפענח.

דוגמאות

--ad=lavc:mp3float
העדיפו את ה-FFmpeg/Libav mp3float מפענח על פני כל מפענחי MP3 האחרים.

--ad=spdif:ac3,lavc:*
העדיפו תמיד spdif AC3 על פני FFmpeg/Libav על פני כל דבר אחר.

--ad=עזרה
רשום את כל המפענחים הזמינים.

אזהרה

הפעלת העברת שמע דחוסה (AC3 ו-DTS באמצעות SPDIF/HDMI) עם
אפשרות זו הוצאה משימוש. להשתמש --audio-spdif במקום.

--נפח=
הגדר את עוצמת ההפעלה. 0 פירושו שקט, 100 פירושו ללא הפחתת עוצמת הקול או
הַגבָּרָה. ערך של -1 (ברירת המחדל) לא ישנה את עוצמת הקול. ראה גם
--softvol.

הערה:
זה השתנה לאחר שחרור mpv 0.9. לפני כן, 100 התכוון למעשה
נפח מקסימלי. במקביל, סולם הנפח נעשה מעוקב, כך הישן
הערכים ממילא לא יתאימו לערכים החדשים.

--audio-delay=
עיכוב שמע בשניות (ערך צף חיובי או שלילי). עיכוב בערכים חיוביים
השמע והערכים השליליים מעכבים את הסרטון.

--אין שמע
אל תשמיע קול.

--השתקה=
הגדר סטטוס השתקת אודיו להפעלה. המכונית (ברירת מחדל) לא ישנה את מצב ההשתקה. גַם
לִרְאוֹת --כרך.

--softvol=
שליטה אם להשתמש בפקדי עוצמת הקול של מנהל ההתקן של פלט השמע או ב-
מסנן עוצמת קול mpv פנימי.

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

כן השתמש תמיד במסנן עוצמת הקול

המכונית העדיפו את מסנן עוצמת הקול אם מנהל התקן השמע משתמש במיקסר המערכת (ברירת מחדל)

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

--audio-demuxer=<[+]שם>
השתמש בסוג מכשיר שמע זה בעת השימוש --קובץ שמע. השתמש ב-'+' לפני השם ל
להכריח את זה; זה ידלג על כמה בדיקות. תן את שם הדמוקסר כפי שהודפס על ידי
--audio-demuxer=עזרה.

--ad-lavc-ac3drc=
בחר את רמת הדחיסה של טווח דינמי עבור זרמי שמע AC-3. הוא
ערך צף הנע בין 0 ל-1, כאשר 0 פירושו ללא דחיסה (שזה
ברירת מחדל) ו-1 פירושו דחיסה מלאה (הפוך את הקטעים הרועשים לשקטים יותר ולפגוע
להיפך). ערכים של עד 6 מתקבלים גם הם, אך הם ניסיוניים בלבד. אפשרות זו
מראה השפעה רק אם זרם AC-3 מכיל את דחיסת הטווח הנדרש
מידע.

התקן מחייב ש-DRC מופעל כברירת מחדל, אבל mpv (ועוד כמה
שחקנים) התעלמו מכך למען איכות שמע טובה יותר.

--ad-lavc-downmix=
האם לבקש הורדת ערוץ שמע מהמפענח (ברירת מחדל: כן). כמה
מפענחים, כמו AC-3, AAC ו-DTS, יכולים לערבב שמע מחדש בפענוח. המספר המבוקש
של ערוצי הפלט מוגדר עם --ערוצי אודיו אוֹפְּצִיָה. שימושי למשחק
אודיו היקפי במערכת סטריאו.

--ad-lavc-threads=<0-16>
מספר החוטים לשימוש לפיענוח. האם השרשור אכן נתמך
תלוי ב-codec. נכון לכתיבת שורות אלה, הוא נתמך עבור רכיבי קודקים ללא אובדן בלבד.
0 פירושו זיהוי אוטומטי של מספר הליבות במכונה והשתמש בזה, עד למקסימום
של 16 (ברירת מחדל: 1).

--ad-lavc-o= = [, = [,...]]
העבר AVOptions למפענח libavcodec. שימו לב, תיקון כדי להפוך את ה-o= ללא צורך ו
להעביר את כל האפשרויות הלא ידועות דרך מערכת AVOption יתקבל בברכה. רשימה מלאה של
AVOptions ניתן למצוא במדריך FFmpeg.

--ad-spdif-dtshd= , --dtshd, --no-dtshd
אם מועבר DTS, השתמש ב-DTS-HD.

אזהרה

זה ואפשר מעבר דרך --מוֹדָעָה מובטלים לטובת השימוש
--audio-spdif=dts-hd.

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

השמיים --ערוצי אודיו האפשרות לוקחת מספר ערוץ או ערוץ מפורש
מַעֲרָך. מספרי ערוצים מתייחסים לפריסות ברירת מחדל, למשל 2 ערוצים מתייחסים לסטריאו,
6 מתייחס ל-5.1.

לִרְאוֹת --ערוצי שמע=עזרה פלט עבור פריסות ברירת מחדל מוגדרות. גם זה מפרט
שמות דוברים, שניתן להשתמש בהם כדי לבטא פריסות ערוצים שרירותיות (למשל
fl-fr-lfe הוא 2.1).

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

זה גם יבקש את פריסת הערוץ מהמפענח. אם המפענח לא
לתמוך בפריסה, הוא יחזור לפריסת הערוץ המקורית שלו. (אתה יכול להשתמש
--ad-lavc-downmix=לא כדי שהמפענח תמיד יוציא את הפריסה המקורית שלו.) הערה
שרק חלק מהמפענחים תומכים ברימיקס של שמע. חלקם כן כוללים AC-3, AAC או
אודיו DTS.

אם פריסת הערוץ של קובץ המדיה (כלומר המפענח) והערוץ של ה-AO
הפריסה לא תואמת, mpv ינסה להכניס מסנן המרות.

אזהרה

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

--audio-display=
הגדרת אפשרות זו ל התקשרות (ברירת מחדל) יציג קבצי תמונה מצורפים (למשל
עטיפת אלבום) בעת הפעלת קובצי שמע. זה יציג את התמונה הראשונה שנמצאה,
ותמונות נוספות זמינות כרצועות וידאו.

הגדרת אפשרות זו ל לא משבית את הצגת הווידאו לחלוטין בעת ​​הפעלת אודיו
קבצים.

לאפשרות זו אין השפעה על קבצים עם רצועות וידאו רגילות.

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

---audio-format=
בחר את פורמט הדוגמה המשמש לפלט משכבת ​​מסנן האודיו לצליל
כַּרְטִיס. הערכים ש יכול לאמץ מפורטים להלן בתיאור של
פוּרמָט מסנן שמע.

--audio-samplerate=
בחר את קצב דגימת הפלט לשימוש (כמובן שלכרטיסי קול יש הגבלות
זֶה). אם תדירות הדגימה שנבחרה שונה מזו של הזרם
מדיה, מסנן האודיו lavrresample יוכנס לשכבת מסנן האודיו
כדי לפצות על ההבדל.

--gapless-audio=
נסה להפעיל קבצי אודיו עוקבים ללא שתיקה או הפרעה בשלב של
שינוי קובץ. בְּרִירַת מֶחדָל: חלש.

לא השבת אודיו ללא פערים.

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

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

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

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

--softvol-max=<100.0-1000.0>
הגדר את רמת ההגברה המקסימלית באחוזים (ברירת מחדל: 130). ערך של 130 יהיה
מאפשר לך לכוונן את עוצמת הקול עד כפול מהרמה הרגילה.

--audio-file-auto= , --no-audio-file-auto
טען קבצי אודיו נוספים התואמים לשם קובץ הווידאו. הפרמטר מציין
כיצד קבצי שמע חיצוניים מתאימים. מְדוּיָק מופעל כברירת מחדל.

לא אל תטען אוטומטית קבצי שמע חיצוניים.

מְדוּיָק טען את שם קובץ המדיה עם סיומת קובץ השמע (ברירת מחדל).

מְעוּרפָּל טען את כל קובצי האודיו המכילים את שם קובץ המדיה.

את כל טען את כל קבצי האודיו בספרייה הנוכחית.

--audio-client-name=
שם האפליקציה שהשחקן מדווח ל-API של שמע. יכול להיות שימושי אם אתה רוצה
כדי לאלץ פרופיל שמע אחר (למשל עם PulseAudio), או להגדיר פרופיל שמע אחר
שם האפליקציה בעת שימוש ב-libmpv.

--volume-restore-data=
משמש באופן פנימי לשימוש על ידי קורות חיים של השמעה (למשל עם צא_לצפייה_מאוחר יותר). משחזר
ערך צריך להיעשות בזהירות, כי AOs שונים כמו גם softvol יכולים להיות
טווחי ערכים שונים, ואנחנו לא רוצים לשחזר את עוצמת הקול אם מגדירים את עוצמת הקול
משנה את המערכת רחבה. האפשרויות הרגילות (כמו --כרך) תמיד יגדיר את
כרך. אפשרות זו נוספה לשחזור עוצמת הקול בצורה בטוחה יותר (על ידי אחסון
השיטה המשמשת להגדרת עוצמת הקול), ואינה שימושית בדרך כלל. הסמנטיקה שלו היא
נחשב פרטי ל-mpv.

אל תשתמש.

--audio-buffer=
הגדר את המאגר המינימלי של פלט השמע. התקן השמע עשוי ליצור למעשה א
חיץ גדול יותר אם ירצה. אם ההתקן יוצר מאגר קטן יותר, נוסף
אודיו מאוחסן במאגר תוכנה נוסף.

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

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

ברירת מחדל: 0.2 (200 אלפיות השנייה).

כתוביות
--לא-משנה
אל תבחר כתובית כלשהי כאשר הקובץ נטען.

--sub-demuxer=<[+]שם>
כפה על סוג תרגום כתוביות עבור --תת-קובץ. תן את שם הדמוקסר כפי שהודפס על ידי
--sub-demuxer=עזרה.

--sub-delay=
עיכוב כתוביות ב שניות. יכול להיות שלילי.

--sub-file=קובץ כתוביות
הוסף קובץ כתוביות לרשימת הכתוביות החיצוניות.

אם אתה משתמש --תת-קובץ רק פעם אחת, קובץ הכתוביות הזה מוצג כברירת מחדל.

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

--Secondary-sid=
בחר זרם כתוביות משני. זה דומה ל --סיד. אם משני
נבחרה כתובית, היא תעובד ככותרת עליונה (כלומר בחלק העליון של
מסך) לצד הכתובית הרגילה, ומספק דרך לעיבוד שתי כתוביות
בבת אחת.

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

הערה:
עיצוב ופרשנות של כל תגי עיצוב מושבתים עבור המשני
כתוביות. פנימית, אותו מנגנון כמו --אין תת-תחת משמש כדי להפשיט את
סִגנוּן.

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

--sub-scale=<0-100>
פקטור עבור גודל הגופן של כתוביות הטקסט (ברירת מחדל: 1).

הערה:
זה משפיע גם על כתוביות ASS, ועלול להוביל לכתוביות שגויות
טִיוּחַ. השתמש בזהירות, או השתמש ---sub-text-font-size במקום.

--sub-scale-by-window=
האם להתאים את הכתוביות עם גודל החלון (ברירת מחדל: כן). אם זה
מושבת, שינוי גודל החלון לא ישנה את גודל גופן הכתוביות.

כמו -- תת סולם, זה יכול לשבור כתוביות ASS.

--sub-scale-with-window=
הפוך את גודל הגופן של הכתוביות ביחס לחלון, במקום לסרטון. זה
שימושי אם אתה תמיד רוצה את אותו גודל גופן, גם אם הסרטון לא מסתיר את
חלון מלא, למשל בגלל שהיבט המסך והיבט החלון אינם תואמים (והשחקן
מוסיף פסים שחורים).

ברירת מחדל: כן.

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

משפיע על כתוביות טקסט רגיל בלבד (או ASS אם --עקיפה בסגנון התחת מוגדר גבוה
מספיק).

--ass-scale-with-window=
כמו --תת-קנה מידה-עם-חלון, אך משפיע על כתוביות בפורמט ASS בלבד. כמו
-- תת סולם, זה יכול לשבור כתוביות ASS.

ברירת מחדל: לא.

-- embeddedfonts, --לא-גופנים מוטבעים
השתמש בגופנים המוטמעים בקבצי מיכל Matroska ובסקריפטים של ASS (ברירת מחדל: מופעל).
ניתן להשתמש בגופנים אלה לעיבוד כתוביות SSA/ASS.

--sub-pos=<0-100>
ציין את מיקום הכתוביות על המסך. הערך הוא המיקום האנכי
של הכתובית באחוזים מגובה המסך.

הערה:
זה משפיע גם על כתוביות ASS, ועלול להוביל לכתוביות שגויות
טִיוּחַ. השתמש בזהירות, או השתמש --sub-text-margin-y במקום.

--sub-speed=<0.1-10.0>
הכפל את חותמות הזמן של אירוע הכתוביות עם הערך הנתון. ניתן להשתמש כדי לתקן את
מהירות השמעה עבור פורמטים מבוססי כתוביות. משפיע על כתוביות טקסט בלבד.

דוגמה

--sub-speed=25/23.976` מנגן כתוביות מבוססות פריים שנטענו
בהנחה של קצב פריימים של 23.976 ב-25 FPS.

--ass-force-style=<[סגנון.]Param=Value[,...]>
עוקף כמה פרמטרים של מידע על סגנון או סקריפט.

דוגמאות

· --ass-force-style=FontName=Arial,Default.Bold=1

· --ass-force-style=PlayResY=768

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

--כאן-רמז=
הגדר סוג רמז לגופן. יכול להיות:

אף לא אחד ללא רמז (ברירת מחדל)

אוֹר FreeType autohinter, מצב אור

נוֹרמָלִי FreeType autohinter, מצב רגיל

יליד רמז מקורי של גופן

אזהרה

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

--ass-line-spacing=
הגדר ערך מרווח בין שורות עבור מעבד SSA/ASS.

---ass-shaper=
הגדר את מנוע פריסת הטקסט בשימוש על ידי libass.

פשוט משתמש ב- Fribidi בלבד, מהיר, לא מעבד חלק מהשפות בצורה נכונה

מורכב
משתמש ב-HarfBuzz, תמיכה איטית ורחבה יותר בשפה

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

--ass-styles=
טען את כל סגנונות SSA/ASS שנמצאו בקובץ שצוין והשתמש בהם לעיבוד טקסט
כתוביות. התחביר של הקובץ הוא בדיוק כמו [V4 סגנונות] / [V4+ סגנונות]
סעיף של SSA/ASS.

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

--ass-style-override=
קבע אם יש להחיל עקיפות בסגנון משתמש.

כן החל את כל --תַחַת-* אפשרויות לעקוף סגנון. שינוי ברירת המחדל עבור כל
מבין האפשרויות הללו עלולות להוביל לעיבוד כתוביות שגוי (ברירת מחדל).

סימנים כמו כן, אבל להגיש בקשה -- תת סולם רק לשלטים

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

כּוֹחַ נסה לאלץ את סגנון הגופן כפי שהוגדר על ידי --תת-טקסט-* אפשרויות. פחית
לשבור את העיבוד בקלות.

---ass-force-margins
מאפשר הצבת כותרות וכתוביות בגבולות שחורים כשהן זמינות,
אם הכתוביות הן בפורמט ASS.

ברירת מחדל: לא.

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

ברירת מחדל: כן.

שונה שם מ --שולי-שימוש בתחת. כדי למקם גם כתוביות ASS בגבולות (כמו
אפשרות ישנה עשתה), גם להוסיף ---ass-force-margins.

--ass-vsfilter-aspect-compat=
למתוח כתוביות SSA/ASS בעת הפעלת סרטונים אנמורפיים לצורך תאימות עם
התנהגות VSFilter מסורתית. למתג זה אין השפעה כאשר הסרטון מאוחסן
עם פיקסלים מרובעים.

המעבד הנפוץ ביותר מבחינה היסטורית עבור פורמטים של כתוביות SSA/ASS,
ל-VSFilter, הייתה התנהגות מפוקפקת שגרמה לכך שגם הכתוביות נמתחו
אם הסרטון אוחסן בפורמט אנמורפי שדרש שינוי קנה מידה לתצוגה.
התנהגות זו בדרך כלל אינה רצויה וגירסאות VSFilter חדשות יותר עשויות להתנהג
באופן שונה. עם זאת, סקריפטים קיימים רבים מפצים על המתיחה על ידי
לשנות דברים בכיוון ההפוך. לפיכך, אם סקריפטים כאלה מוצגים
"בצורה נכונה", הם לא יופיעו כמתוכנן. מתג זה מאפשר אמולציה של
התנהגות VSFilter הישנה (לא רצויה אך צפויה על ידי סקריפטים קיימים רבים).

מופעלת כברירת מחדל.

--ass-vsfilter-blur-compat=
סולם \לְטַשׁטֵשׁ תגים לפי רזולוציית וידאו במקום רזולוציית סקריפט (מופעל על ידי
בְּרִירַת מֶחדָל). זהו באג ב-VSFilter, שלפי חלקם לא ניתן לתקן אותו יותר
בשם התאימות.

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

--ass-vsfilter-color-compat=
מנגל צבעים כמו (xy-)vsfilter do (ברירת מחדל: בסיסי). מבחינה היסטורית, VSFilter היה
לא מודע למרחב הצבע. זו לא הייתה בעיה כל עוד מרחב הצבעים המשמש עבור SD
נעשה שימוש בווידאו (BT.601). אבל כשהכל עבר ל-HD (BT.709), VSFilter היה
עדיין ממיר צבעי RGB ל-BT.601, עיבודם למסגרת הווידאו, ו
טיפל בפריים לפלט הווידאו, שישתמש ב-BT.709 להמרה ל
RGB. התוצאה היו צבעי כתוביות מעוותים. מאוחר יותר נוספו פריצות רעות למעלה
של פורמט ASS כדי לשלוט כיצד יש לערב צבעים.

בסיסי לטפל רק ב-BT.601->BT.709, אם נראה שהכתוביות מעידות על כך
זה נדרש (ברירת מחדל).

מלא טפל במלואו YCbCr מַטרִיצָה כותרת עם כל מרחבי הצבע של הווידאו נתמכים על ידי
libass ו-mpv. זה עלול להוביל לשברים גרועים במקרים פינתיים ולא כך הוא
נחוץ בהחלט לתאימות (בתקווה), וזו הסיבה שזה לא
ברירת המחדל.

כוח-601
לאלץ BT.601->BT.709 מננגל, ללא קשר לכותרות כתוביות או צבע וידאו
חלל.

לא השבת לחלוטין את עיבוד הצבעים. כל הצבעים הם RGB.

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

--stretch-dvd-subs=
למתוח כתוביות ל-DVD בעת הפעלת סרטוני וידאו אנמורפיים לגופנים שנראים טוב יותר
תקליטורי DVD בעלי שליטה גרועה. למתג זה אין השפעה כאשר הסרטון מאוחסן בריבוע
פיקסלים - אשר עבור קלט DVD לא יכול להיות המקרה.

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

מושבת כברירת מחדל.

--stretch-image-subs-to-screen=
מתח DVD וכתוביות תמונות אחרות למסך, תוך התעלמות משולי הווידאו.
יש לזה השפעה דומה כמו --תת-שימוש-שוליים עבור כתוביות טקסט, אלא שה
הטקסט עצמו יימתח, לא רק ימוקם מחדש. (לפחות באופן כללי
הוא בלתי נמנע, מכיוון שמפת סיביות של תמונה יכולה בתיאוריה להיות מורכבת ממפת סיביות אחת
מכסה את כל המסך, והשחקן לא יידע היכן בדיוק חלקי הטקסט
נמצאים.)

אפשרות זו אינה מציגה כתוביות כראוי. השתמש בזהירות.

מושבת כברירת מחדל.

--תת-תחת, --אין תת-תחת
עיבוד כתוביות ASS באופן מקורי (מופעל כברירת מחדל).

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

הערה:
שימוש --אין תת-תחת עלול להוביל לעיבוד שגוי או שבור לחלוטין של
כתוביות ASS/SSA. לפעמים זה יכול להיות שימושי לעקוף בכוח את הסגנון
של כתוביות ASS, אך יש להימנע מהן באופן כללי.

הערה:
נסה להשתמש ---ass-style-override=force במקום.

--sub-auto= , --אין תת-אוטומטי
טען קבצי כתוביות נוספים התואמים לשם קובץ הסרטון. הפרמטר מציין
כיצד קבצי כתוביות חיצוניים מותאמים. מְדוּיָק מופעל כברירת מחדל.

לא אל תטען אוטומטית קבצי כתוביות חיצוניים.

מְדוּיָק טען את שם קובץ המדיה עם סיומת קובץ כתוביות (ברירת מחדל).

מְעוּרפָּל טען את כל המשאבים המכילים את שם קובץ המדיה.

את כל טען את כל המשאבים ב- ו --נתיבי משנה ספריות.

--sub-codepage=
אם המערכת שלך תומכת סמל(3), תוכל להשתמש באפשרות זו כדי לציין את הכתובית
דף קוד. כברירת מחדל, uchardet ישמש כדי לנחש את ערכת התווים. אם mpv לא
הידור עם uchardet, ישמש אנקה. אם mpv אינו מורכב עם אף אחד מהם
uchardet nor enca, UTF-8:UTF-8-BROKEN הוא ברירת המחדל, מה שאומר שהוא ינסה לעשות זאת
השתמש ב-UTF-8, אחרת UTF-8-BROKEN דף קוד פסאודו (ראה להלן).

ערך ברירת המחדל עבור אפשרות זו הוא המכונית, שהשפעתו בפועל תלויה בשאלה אם
ENCA מורכב.

אזהרה

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

דוגמאות

· --sub-codepage=utf8:latin2 השתמש בלטינית 2 אם הקלט אינו UTF-8.

· --sub-codepage=cp1250 כפה תמיד על קידוד מחדש ל-cp1250.

דף הקוד הפסאודו UTF-8-BROKEN נמצא בשימוש פנימי. כאשר זה דף הקוד,
כתוביות מתפרשות כ-UTF-8 עם "Latin 1" כ-fallback עבור בתים שהם
רצפי UTF-8 לא חוקיים. iconv לעולם אינו מעורב במצב זה.

אם הנגן הורכב עם תמיכת ENCA, אתה יכול לשלוט בו באמצעות הפעולות הבאות
תחביר:

--sub-codepage=enca: : דף קוד>

השפה מוגדרת באמצעות קוד של שתי אותיות כדי לעזור ל-ENCA לזהות את דף הקוד
אוטומטית. אם הוזן קוד שפה לא חוקי, mpv יתלונן וירשום
שפות חוקיות. (עם זאת שים לב שרשימה זו תודפס רק כאשר
קוד המרה נקרא למעשה, למשל בעת טעינת כתובית חיצונית).
דף הקוד החלב משמש אם הזיהוי האוטומטי נכשל. אם לא צוין נפילה,
UTF-8-BROKEN משמש.

דוגמאות

· --sub-codepage=enca:pl:cp1250 נחשו את הקידוד, בהנחה שהכתוביות כן
פולנית, חזור על cp1250

· --sub-codepage=enca:pl נחש את הקידוד לפולנית, חזור על UTF-8.

· --sub-codepage=enca נסה זיהוי אוניברסלי, חזור על UTF-8.

אם הנגן הורכב עם תמיכת libguess, אתה יכול להשתמש בו עם:

--sub-codepage=guess: : דף קוד>

libguess תמיד צריך שפה. אין מצב זיהוי אוניברסלי. להשתמש
--sub-codepage=guess:help כדי לקבל רשימה של שפות הכפופות לאותה אזהרה כמו
עם ENCA למעלה.

אם הנגן הורכב עם תמיכת uchardet אתה יכול להשתמש בו עם:

--sub-codepage=uchardet

מצב זה אינו תופס שפה או דף קוד חלופי.

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

--תת-כפוי בלבד
הצג רק כתוביות כפויות עבור זרם הכתוביות של ה-DVD שנבחר על ידי למשל
--סְלֶנְג.

--sub-fps=
ציין את קצב הפריימים של קובץ הכתוביות (ברירת מחדל: וידאו fps). משפיע על טקסט
כתוביות בלבד.

הערה:
> וידאו fps מאיץ את הכתוביות עבור קבצי כתוביות מבוססי מסגרת ו
מאט אותם עבור אלה מבוססי זמן.

ראה גם --תת מהירות אוֹפְּצִיָה.

--sub-gauss=<0.0-3.0>
החל טשטוש גאוס על כתוביות תמונה (ברירת מחדל: 0). זה יכול לעזור להפוך לפיקסלים
DVD/Vobsubs נראים נחמדים יותר. ערך שאינו 0 עובר גם לכתוביות תוכנה
דֵרוּג. יכול להיות איטי.

הערה:
מעולם לא הוחל על כתוביות טקסט.

--תת-אפור
המרת כתוביות תמונה לגווני אפור. יכול לעזור לגרום ל-DVD/Vobsubs צהוב להיראות
יפה יותר.

הערה:
מעולם לא הוחל על כתוביות טקסט.

--תתי נתיבים=
ציין ספריות נוספות לחיפוש כתוביות התואמות לסרטון. מרובות
ניתן להפריד בין ספריות על ידי ":" (";" ב-Windows). נתיבים יכולים להיות יחסיים או
מוּחלָט. נתיבים יחסיים מתפרשים ביחס לספריית קבצי הווידאו.

דוגמה

בהנחה ש /path/to/video/video.avi משוחק ו
--sub-paths=sub:subtitles:/tmp/subs מוגדר, mpv מחפש
קבצי כתוביות בספריות האלה:

· /path/to/video/

· /path/to/video/sub/

· /path/to/video/subtitles/

· /tmp/subs/

· ה להלן ספריית משנה של תצורה (בדרך כלל ~/.config/mpv/sub/)

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

--sub-clear-on-seek
(לא ברור, לעתים רחוקות שימושי.) ניתן להשתמש בו כדי לנגן קבצי mkv שבורים עם כפילויות
שדות ReadOrder. ReadOrder הוא השדה הראשון בכתובית ASS בסגנון Matroska
מנות. זה צריך להיות ייחודי, ו-libass משתמש בו לחיסול מהיר של
כפילויות. אפשרות זו משביתה שמירה במטמון של כתוביות על פני חיפושים, כך לאחר חיפוש
libass לא יכול לבטל מנות כתוביות עם אותו ReadOrder כמו מנות קודמות.

חלון
--title=
הגדר את כותרת החלון. זה משמש עבור חלון הווידאו, ואם אפשר, גם סטים
כותרת זרם האודיו.

הנכסים מורחבים. (לִרְאוֹת נכס הרחבה.)

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

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

הערה (X11)

אפשרות זו אינה פועלת כראוי עם כל מנהלי החלונות. באלה
מקרים, אתה יכול לנסות להשתמש --גֵאוֹמֶטרִיָה למקם את החלון בצורה מפורשת.
ייתכן גם שמנהל החלונות מספק תכונות מקוריות ל
לשלוט באילו מסכים חלונות יישומים צריכים להשתמש.

ראה גם --fs-מסך.

--מסך מלא, --fs
השמעה במסך מלא.

--fs-screen=
בתצורות מרובות צגים (כלומר שולחן עבודה יחיד המשתרע על פני מספר רב של צגים
מציג), אפשרות זו אומרת ל-mpv לאיזה מסך לעבור למסך מלא. אם ברירת מחדל is
בתנאי mpv יחזור על השימוש בהתנהגות בהתאם למה המשתמש
מסופק עם מסך אוֹפְּצִיָה.

הערה (X11)

אפשרות זו עובדת כראוי רק עם מנהלי חלונות אשר
להבין את EWMH _NET_WM_FULLSCREEN_MONITORS רֶמֶז.

הערה (OS X)

את כל לא עובד על OS X ויתנהג כמו נוֹכְחִי.

ראה גם --מָסָך.

--fs-black-out-screens
OS X בלבד. השחית צגים אחרים בעת מעבר למסך מלא.

--שמור-פתוח=
אין להפסיק בעת משחק או חיפוש מעבר לסוף הקובץ, ויש
לא הקובץ הבא שיופעל (ו --לוּלָאָה אינו בשימוש). במקום זאת, השהה את הנגן.
כאשר מנסים לחפש מעבר לקצה הקובץ, הנגן ינסה לחפש את
מסגרת אחרונה.

ניתן לתת את הטיעונים הבאים:

לא אם הקובץ הנוכחי מסתיים, עבור לקובץ הבא או סיים. (בְּרִירַת מֶחדָל.)

כן אל תסיים אם הקובץ הנוכחי הוא הערך האחרון ברשימת ההשמעה. שווה ערך
ל --שמור-פתוח בלי ויכוחים.

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

הערה:
אפשרות זו אינה מכבדת בעת השימוש --מסגרות. דילוג במפורש ל-
הקובץ הבא אם הכריכה משתמשת כּוֹחַ יפסיק את ההשמעה גם כן.

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

מאז mpv 0.6.0, זה לא מושהה אם יש קובץ הבא ברשימת ההשמעה, או
רשימת ההשמעה בלולאה. בערך, פעולה זו תושהה כאשר הנגן יעשה זאת בדרך כלל
יציאה, אבל בפועל יש מקרים פינתיים שבהם זה לא המקרה (למשל
Mpv --שמור-פתוח file.mkv / dev / null ישחק את file.mkv כרגיל, ואז לא ייפתח
/ dev / null, ואז צא). (ב-mpv 0.8.0, תמיד הוצג, אשר משחזר את הישן
התנהגות.)

---force-window=
צור חלון פלט וידאו גם אם אין וידאו. זה יכול להיות שימושי כאשר
מעמיד פנים ש-mpv הוא יישום GUI. נכון לעכשיו, לחלון תמיד יש את הגודל
640x480, וכפוף ל --גֵאוֹמֶטרִיָה, --התאמה אוטומטית, ואפשרויות דומות.

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

--עליון
גורם לחלון הנגן להישאר מעל חלונות אחרים.

ב-Windows, אם הוא משולב עם מצב מסך מלא, הדבר גורם להתייחסות ל-mpv כאל
חלון מסך מלא בלעדי שעוקף את מנהל חלונות שולחן העבודה.

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

--על כל חללי העבודה
(X11 בלבד) הצג את חלון הווידאו בכל שולחן העבודה הווירטואלי.

--geometry=<[W[xH]][+-x+-y]>, --גיאומטריה=
התאם את מיקום או גודל החלון הראשוניים. W ו H הגדר את גודל החלון בפיקסלים.
x ו y הגדר את מיקום החלון, נמדד בפיקסלים מהפינה השמאלית העליונה של החלון
מסך לפינה השמאלית העליונה של התמונה המוצגת. אם סימן אחוז
(%) ניתן לאחר הארגומנט, הוא הופך את הערך לאחוז מהמסך
גודל בכיוון הזה. מיקומים מצוינים בדומה ל-X11 הסטנדרטי
--גֵאוֹמֶטרִיָה תבנית אפשרות, שבה למשל +10-50 פירושו "מקם 10 פיקסלים משמאל
גבול ו-50 פיקסלים מהגבול התחתון" ו-"--20+-10" פירושו "מקם 20 פיקסלים
מעבר לימין ו-10 פיקסלים מעבר לגבול העליון".

אם צוין חלון חיצוני באמצעות ה --wid אפשרות, אפשרות זו מתעלמת.

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

הערה:
בדרך כלל נתמך רק על ידי GUI VOs. התעלמו בגלל הקידוד.

הערה (X11)

אפשרות זו אינה פועלת כראוי עם כל מנהלי החלונות.

דוגמאות

50:40 ממקם את החלון ב-x=50, y=40.

50%: 50%
ממקם את החלון באמצע המסך.

100%: 100%
ממקם את החלון בפינה הימנית התחתונה של המסך.

50% מגדיר את רוחב החלון למחצית מרוחב המסך. גובה החלון מוגדר כך
שלחלון יש את יחס הגובה-רוחב של הווידאו.

50%x50%
מאלץ את רוחב וגובה החלון למחצית מרוחב וגובה המסך.
יציג גבולות שחורים כדי לפצות על מנת הגובה-רוחב של הסרטון (עם
רוב VOs ובלי --ללא שמירה).

50%+10+10
מגדיר את החלון לחצי מרוחב המסך, וממקם אותו ב-10 פיקסלים
מתחת/שמאל של הפינה השמאלית העליונה של המסך.

ראה גם --התאמה אוטומטית ו --התאמה אוטומטית-גדולה יותר להתאמת החלון לגודל נתון
מבלי לשנות את יחס הגובה-רוחב.

--autofit=<[W[xH]]>
הגדר את גודל החלון הראשוני לגודל מקסימלי שצוין על ידי WxH, בלי לשנות
יחס הגובה-רוחב של החלון. הגודל נמדד בפיקסלים, או אם מספר הוא
ואחריו סימן אחוז (%), באחוזים מגודל המסך.

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

מיקום החלון אינו נלקח בחשבון, ואינו משתנה על ידי אפשרות זו (ה
מנהל החלונות עדיין עשוי למקם את החלון בצורה שונה בהתאם לגודל). להשתמש
--גֵאוֹמֶטרִיָה כדי לשנות את מיקום החלון. ההשפעות שלה מיושמות לאחר מכן
אוֹפְּצִיָה.

לִרְאוֹת --גֵאוֹמֶטרִיָה לפרטים כיצד זה מטופל בהגדרות מרובי צגים.

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

השתמש --גֵאוֹמֶטרִיָה אם אתה רוצה לאלץ גם את רוחב החלון וגם את הגובה לנקודה מסוימת
גודל.

הערה:
בדרך כלל נתמך רק על ידי GUI VOs. התעלמו בגלל הקידוד.

דוגמאות

70% הפוך את רוחב החלון ל-70% מגודל המסך, תוך שמירה על יחס רוחב-גובה.

1000 הגדר את רוחב החלון ל-1000 פיקסלים, תוך שמירה על יחס רוחב-גובה.

70%: 60%
הפוך את החלון לגדול ככל האפשר, מבלי להיות רחב יותר מ-70% מה
רוחב המסך, או גבוה מ-60% מגובה המסך.

--autofit-larger=<[W[xH]]>
אפשרות זו מתנהגת בדיוק כמו --התאמה אוטומטית, מלבד שגודל החלון משתנה רק
אם החלון יהיה גדול מהגודל שצוין.

דוגמה

90%x80%
אם הסרטון גדול מ-90% מרוחב המסך או 80% מהמסך
גובה, הקטן את החלון עד שהרוחב שלו יהיה 90% מה
מסך, או שגובהו הוא 80% מהמסך.

--autofit-smaller=<[W[xH]]>
אפשרות זו מתנהגת בדיוק כמו --התאמה אוטומטית, אלא שהוא מגדיר את הגודל המינימלי של
החלון (בדיוק כמו --התאמה אוטומטית-גדולה יותר קובע את המקסימום).

דוגמה

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

--window-scale=
שנה את גודל חלון הווידאו לכפול (או שבריר) מגודל הווידאו. אפשרות זו
מוחל לפני --התאמה אוטומטית ואפשרויות אחרות מוחלות (כך שהן עוקפות את זה
אוֹפְּצִיָה).

לדוגמה, --window-scale=0.5 יציג את החלון בחצי מגודל הסרטון.

--cursor-autohide=
הפוך את סמן העכבר להסתרה אוטומטית לאחר מספר נתון של אלפיות שניות. לא יצטרך
בטל הסתרה אוטומטית של הסמן. תמיד פירושו שהסמן יישאר מוסתר.

--cursor-autohide-fs-only
אם אפשרות זו ניתנת, הסמן תמיד גלוי במצב חלונות. ב
במצב מסך מלא, הסמן מוצג או מוסתר בהתאם --cursor-autohide.

--לא-קבוע-ו, --fixed-vo
--לא-קבוע-ו אוכפת סגירה ופתיחה מחדש של חלון הווידאו עבור מספר קבצים
(איתחול (אי) אחד לכל קובץ).

--force-rgba-osd-rendering
שנה את האופן שבו פלטי וידאו מסוימים מציגים את ה-OSD ואת כתוביות הטקסט. זה לא
לשנות את מראה הכתוביות ויש לו רק השלכות ביצועים. עבור VOs
שתומכים בעיבוד ASS מקורי (כמו vdpau, פתוח, ישיר 3d), זה יכול להיות
מעט מהיר יותר או איטי יותר, תלוי במנהלי ההתקן והחומרה של GPU. עבור VOs אחרים,
זה רק הופך את העיבוד לאט יותר.

--כוח-חלון-מיקום
העבר בכוח את חלון פלט הווידאו של mpv למיקום ברירת המחדל בכל פעם שיש
שינוי בפרמטרים של וידאו, זרם וידאו או קובץ. פעם זו הייתה ברירת המחדל
התנהגות. כרגע משפיע רק על X11 VOs.

--heartbeat-cmd=
פקודה שמתבצעת כל 30 שניות במהלך השמעה באמצעות מערכת() - כלומר באמצעות
את הקליפה. ניתן להתאים את הזמן בין הפקודות באמצעות ה-
--מרווח פעימות לב אוֹפְּצִיָה. הפקודה לא מופעלת בזמן שההשמעה מושהית.

הערה:
mpv משתמש בפקודה זו ללא כל בדיקה. באחריותך להבטיח
זה לא גורם לבעיות אבטחה (למשל הקפד להשתמש בנתיבים מלאים אם "." הוא
בנתיב שלך כמו ב-Windows). זה גם עובד רק בעת הפעלת וידאו (כלומר לא
עם --אין סרטון אבל עובד עם -vo=null).

זה יכול להיות "שימוש לרעה" כדי להשבית שומרי מסך שאינם תומכים ב-X API המתאים
(ראה גם --עצור-שומר מסך). אם אתה חושב שזה מסובך מדי, שאל את המחבר
של תוכנית שומר המסך כדי לתמוך בממשקי ה-API המתאימים של X. שימו לב שה-
--עצור-שומר מסך אינו משפיע על קוד פעימות הלב כלל.

דוגמה ל-xscreensaver

Mpv --heartbeat-cmd="xscreensaver-command -לבטל" פילה

דוגמה לשומר מסך של GNOME

Mpv --heartbeat-cmd="gnome-screensaver-command -פ" פילה

--heartbeat-interval=
זמן בין --heartbeat-cmd קריאות בשניות (ברירת מחדל: 30).

הערה:
זה לא משפיע בשום אופן על פעולת שומר המסך הרגילה.

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

--ללא-שמירה-חלון, -- Keepaspect-window
-- Keepaspect-window (ברירת המחדל) תנעל את גודל החלון להיבט הווידאו.
--No-Keepaspect-window משבית התנהגות זו, ובמקום זאת יוסיף פסים שחורים אם
אי התאמה של היבט היבט של חלון ושל וידאו. אם זה באמת עובד תלוי ב
VO backend. (מתעלמים במצב מסך מלא.)

--monitoraspect=
הגדר את יחס הגובה-רוחב של הצג או מסך הטלוויזיה שלך. ערך 0 משבית את הקודם
הגדרה (למשל בקובץ התצורה). עוקף את --monitorpixelaspect הגדרה אם
מאופשר.

ראה גם --monitorpixelaspect ו --היבט וידאו.

דוגמאות

· --monitoraspect=4:3 or --monitoraspect=1.3333

· --monitoraspect=16:9 or --monitoraspect=1.7777

--monitorpixelaspect=
הגדר את ההיבט של פיקסל בודד של הצג או מסך הטלוויזיה שלך (ברירת מחדל: 1). ערך
של 1 פירושו פיקסלים מרובעים (נכון עבור (כמעט?) כל ה-LCD). ראה גם --היבט מוניטור
ו --היבט וידאו.

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

זה לא נתמך בכל יציאות הווידאו או הפלטפורמות. לפעמים זה
מיושם, אבל לא עובד (קורה לעתים קרובות ב-GNOME). אולי תוכל
לעקוף את זה באמצעות --heartbeat-cmd במקום.

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

ב-X11, המזהה מתפרש כ-a חלון ב-X11. שלא כמו MPlayer/mplayer2, mpv
תמיד יוצר חלון משלו, ומגדיר את חלון ה-wid כהורה. החלון יהיה
תמיד לשנות את הגודל כדי לכסות את חלון האב במלואו. הערך 0 מתפרש
במיוחד, ו-mpv יצייר ישירות על חלון השורש.

ב-win32, המזהה מתפרש כ Hwnd. העבירו את זה כערך שיוצק אליו intptr_t. mpv
יצור חלון משלו, ויגדיר את החלון הרחבה כהורה, כמו עם X11.

ב-OSX/Cocoa, המזהה מתפרש כ NSView*. העבירו את זה כערך שיוצק אליו intptr_t.
mpv will יוצר תת-תצוגה משלו. מכיוון ש-OSX לא תומך בהטמעת חלונות של
תהליכים זרים, זה עובד רק עם libmpv, ויתרסק בשימוש מה-
שורת הפקודה.

--ללא גרירת חלון
אל תזיז את החלון בעת ​​לחיצה עליו והזזת מצביע העכבר.

--x11-name
הגדר את שם מחלקת החלון עבור שיטות פלט וידאו מבוססות X11.

--x11-netwm=
(X11 בלבד) שלוט בשימוש בתכונות פרוטוקול NetWM.

זה עשוי לעזור או לא לעזור עם מנהלי חלונות שבורים. זה מספק כמה
פונקציונליות שיושמה על ידי המוסר כעת --fstype אוֹפְּצִיָה. בעצם,
לא ידוע למפתחים באיזו מידה הייתה נחוצה אפשרות זו, אז
משוב יתקבל בברכה.

באופן ספציפי, כן יאלץ שימוש בתמיכה במסך מלא של NetWM, גם אם לא
פורסם על ידי ה-WM. זה יכול להיות שימושי עבור WMs שנשברו בכוונה, כמו
XMonad. (XMonad כביכול לא מפרסם תמיכה במסך מלא, מכיוון ש-Flash משתמש
זה. ככל הנראה, יישומים שרוצים להשתמש במסך מלא בכל מקרה אמורים לעשות זאת
או להתעלם מרמזי התמיכה של NetWM, או לספק פתרון עוקף. בושה על XMonad עבור
שבירת פרוטוקולי X בכוונה (כאילו X לא מספיק גרוע כבר).

כברירת מחדל, תמיכת NetWM מזוהה אוטומטית (המכונית).

ייתכן שאופציה זו תוסר בעתיד.

--x11-bypass-compositor=
אם מוגדר ל כן (ברירת מחדל), ואז בקש מהקומפוזיטור לבטל את ניתוב חלון mpv. זֶה
משתמש _NET_WM_BYPASS_COMPOSITOR רֶמֶז.

תקליט התקנים
--cdrom-device=
ציין את התקן התקליטור (ברירת מחדל: /dev/cdrom).

--dvd-device=
ציין את התקן ה-DVD או את שם הקובץ .iso (ברירת מחדל: /dev/dvd). אתה יכול גם לציין א
ספרייה המכילה קבצים שהועתקו בעבר ישירות מ-DVD (עם למשל
vobcopy).

דוגמה

Mpv DVD:// --dvd-device=/path/to/dvd/

--bluray-device=
(בלו-ריי בלבד) ציין את מיקום תקליטור ה-Blu-ray. חייבת להיות ספרייה עם Blu-ray
מבנה.

דוגמה

Mpv bd:// --bluray-device=/path/to/bd/

--bluray-angle=
חלק מתקליטורי Blu-ray מכילים סצנות שניתן לצפות בהן ממספר זוויות. זֶה
האפשרות אומרת ל-mpv באיזו זווית להשתמש (ברירת מחדל: 1).

--cdda-...
ניתן להשתמש באפשרויות אלה כדי לכוון את תכונת קריאת שמע CD של mpv.

--cdda-speed=
הגדר את מהירות סיבוב התקליטור.

--cdda-paranoia=<0-2>
הגדר את רמת הפרנויה. נראה שערכים שאינם 0 שוברים את ההשמעה של כל דבר מלבד ה
רצועה ראשונה.

0 השבת בדיקה (ברירת מחדל)

1 בדיקת חפיפה בלבד

2 תיקון ואימות נתונים מלאים

--cdda-sector-size=
הגדר את גודל הקריאה האטומי.

--cdda-חפיפה=
כפה על חיפוש חפיפה מינימלית במהלך האימות מגזרים.

--cdda-toc-bias
נניח שהקיזוז ההתחלתי של מסלול 1 כפי שדווח ב-TOC יהיה
כתובה כ-LBA 0. חלק מהדיסקים צריכים את זה כדי לקבל את גבולות הרצועה בצורה נכונה.

--cdda-toc-offset=
להוסיף מגזרים לערכים שדווחו בעת התייחסות למסלולים. אולי
שלילי.

--cdda-skip=
(לעולם לא) קבל שחזור נתונים לא מושלם.

--cdda-cdtext=
הדפס טקסט בתקליטור. זה מושבת כברירת מחדל, כי זה הורס את הביצועים עם
כונני CD-ROM מסיבות לא ידועות.

--dvd-speed=
נסה להגביל את מהירות ה-DVD (ברירת מחדל: 0, ללא שינוי). מהירות הבסיס של ה-DVD היא 1385 kB/s, אז
כונן 8x יכול לקרוא במהירויות של עד 11080 kB/s. מהירויות איטיות הופכות את הנסיעה ליותר
שֶׁקֶט. לצפייה בתקליטורי DVD, 2700 kB/s צריכים להיות שקטים ומהירים מספיק. mpv מאפס את
מהירות לערך ברירת המחדל של הכונן בסגירה. ערכים של לפחות 100 ממוצעים במהירות פנימה
kB/s. ערכים הנמוכים מ-100 פירושם כפולות של 1385 kB/s, כלומר --dvd-speed=8 בוחר
11080 kB/s.

הערה:
אתה צריך גישת כתיבה להתקן ה-DVD כדי לשנות את המהירות.

--dvd-angle=
תקליטורי DVD מסוימים מכילים סצנות שניתן לצפות בהן מכמה זוויות. אפשרות זו
אומר ל-mpv באיזו זווית להשתמש (ברירת מחדל: 1).

שַׁויָן
--בהירות=<-100-100>
כוונן את בהירות אות הווידאו (ברירת מחדל: 0). לא נתמך על ידי כל הסרטונים
מנהלי התקנים של פלט.

--contrast=<-100-100>
כוונן את הניגודיות של אות הווידאו (ברירת מחדל: 0). לא נתמך על ידי כל הסרטונים
מנהלי התקנים של פלט.

--saturation=<-100-100>
כוונן את הרוויה של אות הווידאו (ברירת מחדל: 0). אתה יכול לקבל גווני אפור
פלט עם אפשרות זו. לא נתמך על ידי כל מנהלי ההתקן של פלט הווידאו.

--gamma=<-100-100>
כוונן את הגמא של אות הווידאו (ברירת מחדל: 0). לא נתמך על ידי כל הסרטונים
מנהלי התקנים של פלט.

--hue=<-100-100>
התאם את הגוון של אות הווידאו (ברירת מחדל: 0). אתה יכול לקבל נגטיב צבעוני של
התמונה עם אפשרות זו. לא נתמך על ידי כל מנהלי ההתקן של פלט הווידאו.

דמוקסר
--demuxer=<[+]שם>
Force סוג דמוקסר. השתמש ב-'+' לפני השם כדי לאלץ אותו; זה ידלג על חלק
המחאות. תן את שם הדמוקסר כפי שהודפס על ידי --demuxer=עזרה.

--demuxer-lavf-analyzeduration=
אורך מקסימלי בשניות לניתוח מאפייני הזרם.

--demuxer-lavf-probescore=<1-100>
ציון בדיקה מינימלי נדרש libavformat. ערכים נמוכים יותר ידרשו פחות נתונים
נטען (גורם לזרמים להתחיל מהר יותר), אך הופך את זיהוי פורמט הקובץ לפחות אמין.
ניתן להשתמש כדי לאלץ זיהוי אוטומטי של libavformat demuxers, גם אם libavformat
רואה בזיהוי לא מספיק אמין. (ברירת מחדל: 26.)

--demuxer-lavf-allow-mimetype=
אפשר לגזור את הפורמט מסוג HTTP MIME (ברירת מחדל: כן). הגדר את זה ל-No in
במקרה שמשחק דברים מ-HTTP נכשל באופן מסתורי, למרות שאותם קבצים עובדים
מהדיסק המקומי.

זוהי ברירת מחדל על מנת להפחית את זמן האחזור בעת פתיחת זרמי HTTP.

--demuxer-lavf-format=
כפה על libavformat demuxer ספציפי.

--demuxer-lavf-hacks=
כברירת מחדל, פורמטים מסוימים יטופלו בצורה שונה מפורמטים אחרים על ידי
בודק אותם במפורש. רוב אלה מפצים על מוזר או לא מושלם
התנהגות של libavformat demuxers. חוֹלֵף לא משבית את אלה. עבור איתור באגים ו
בדיקה בלבד.

--demuxer-lavf-genpts-mode=
מצב לגזירת ערכי PTS של מנות חסרים מ-DTS של מנות. lavf מאפשר
של libavformat genpts אוֹפְּצִיָה. לא משבית אותו. זה היה מופעל כברירת מחדל,
אבל אז זה נחשב לא נחוץ יותר. הפעלת זה עשויה לעזור
בעיות חותמת זמן, או להחמיר אותן.

--demuxer-lavf-o= = [, = [,...]]
העבר את AVOptions ל-libavformat demuxer.

שימו לב, תיקון להכנת o= מיותר והעביר את כל האפשרויות הלא ידועות דרך
מערכת AVOption תתקבל בברכה. רשימה מלאה של AVOptions ניתן למצוא ב-FFmpeg
מדריך ל. שים לב שחלק מהאפשרויות עלולות להתנגש עם אפשרויות mpv.

דוגמה

--demuxer-lavf-o=fflags=+ignidx

--demuxer-lavf-probesize=
כמות נתונים מקסימלית לבדיקה במהלך שלב הזיהוי. במקרה של MPEG-TS
ערך זה מזהה את המספר המרבי של מנות TS לסריקה.

--demuxer-lavf-buffersize=
גודל מאגר הקריאה של הזרם שהוקצה ל-libavformat בבתים (ברירת מחדל: 32768).
הורדת הגודל עלולה להפחית את זמן האחזור. שים לב ש-libavformat עשוי להקצות מחדש את
מאגר באופן פנימי, או לא להשתמש במלואו.

--demuxer-lavf-cryptokey=
מפתח הצפנה שהממקס צריך להשתמש בו. זהו הנתונים הבינאריים הגולמיים של המפתח
המרה למחרוזת הקסדצימלית.

--demuxer-mkv-subtitle-preroll, --mkv-subtitle-preroll
נסה יותר להציג כתוביות רכות מוטמעות כשאתה מחפש איפשהו. בדרך כלל, זה יכול
קורה שהכתובית ביעד החיפוש לא מוצגת בגלל איך מיכל כלשהו
פורמטים של קבצים מתוכננים. הכתוביות מופיעות רק אם מחפשים לפני או בדיוק
למיקום מופיעה לראשונה כתובית. כדי להחמיר את זה, לעתים קרובות יש כתוביות
מתוזמן להופיע כמות קטנה מאוד לפני מסגרת הווידאו המשויכת, כך ש
חיפוש למסגרת הווידאו בדרך כלל אינו מבצע דה-מקס את הכתובית במיקום זה.

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

עובד עם ה-Damuxer הפנימי של Matroska בלבד. מופעל תמיד עבור מוחלט ו
hr-seeks, ואפשרות זו משנה התנהגות עם חיפושים יחסיים או לא מדויקים בלבד.

אתה יכול להשתמש ב --demuxer-mkv-subtitle-preroll-secs אפשרות לציין כמה נתונים
ה-demuxer צריך לקרוא מראש לכל היותר כדי למצוא חבילות כתוביות שיכולות
חֲפִיפָה. הגדרה זו ל-0 תשבית למעשה את מנגנון הקדם-רול הזה. הגדרה
ערך גדול מאוד יכול להפוך את החיפוש לאיטי מאוד, וערך גדול מאוד יעשה זאת
קרא מחדש לחלוטין את כל הקובץ מההתחלה ועד יעד החיפוש בכל חיפוש - חיפוש
יכול להיות איטי יותר לקראת סוף הקובץ. הפרטים מבולגנים, והערך
למעשה מעוגל כלפי מטה לאשכול עם ה-keyframe הקודם של הווידאו.

לקבצים מסוימים, במיוחד קבצים ששולבו עם גרסאות mkvmerge חדשות יותר, יש מידע
מוטבע שניתן להשתמש בו כדי לקבוע אילו מנות כתוביות חופפות לחיפוש
יַעַד. במקרים אלו, mpv יקטין את כמות הנתונים הנקראים למינימום.
(למרות שזה עדיין ייקרא את כל נתונים בין האשכול המכיל את הראשון
חבילת כתוביות מבוקשת, ויעד החיפוש.)

ראה גם --hr-seek-demuxer-offset אוֹפְּצִיָה. אפשרות זו יכולה להשיג אפקט דומה,
אבל רק אם hr-seek פעיל. זה עובד עם כל מכשיר דה-מקס, אבל עושה הרבה חיפוש
איטי יותר, מכיוון שהוא צריך לפענח נתוני אודיו ווידאו במקום פשוט לדלג עליהם.

--mkv-subtitle-preroll הוא כינוי שהוצא משימוש.

--demuxer-mkv-subtitle-preroll-secs=
לִרְאוֹת --demuxer-mkv-subtitle-preroll.

--demuxer-mkv-probe-video-duration=
בעת פתיחת הקובץ, חפש עד הסוף שלו, ובדקו מהי חותמת הזמן האחרונה
לחבילת הווידאו יש, ודווחו על כך כמשך הקובץ. זה מיועד אך ורק עבור
תאימות עם Haali בלבד. במצב זה, ייתכן שהפתיחה תהיה
איטי יותר (במיוחד בעת משחק על http), או שהתנהגות עם קבצים שבורים היא
הרבה יותר גרוע. אז אל תשתמש באפשרות הזו.

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

--demuxer-rawaudio-channels=
מספר ערוצים (או פריסת ערוץ) אם --demuxer=rawaudio נמצא בשימוש (ברירת מחדל:
סטריאו).

--demuxer-rawaudio-format=
פורמט לדוגמא עבור --demuxer=rawaudio (ברירת מחדל: s16le). להשתמש
--demuxer-rawaudio-format=help כדי לקבל רשימה של כל הפורמטים.

--demuxer-rawaudio-rate=
קצב דגימה עבור --demuxer=rawaudio (ברירת מחדל: 44 קילו-הרץ).

--demuxer-rawvideo-fps=
דרג במסגרות לשנייה עבור --demuxer=rawvideo (ברירת מחדל: 25.0).

--demuxer-rawvideo-w= , --demuxer-rawvideo-h=
ממד תמונה בפיקסלים עבור --demuxer=rawvideo.

דוגמה

הפעל דגימת YUV גולמית:

mpv sample-720x576.yuv --demuxer=rawvideo \
--demuxer-rawvideo-w=720 --demuxer-rawvideo-h=576

--demuxer-rawvideo-format=
מרחב צבע (fourcc) ב-hex או מחרוזת עבור --demuxer=rawvideo (בְּרִירַת מֶחדָל: YV12).

--demuxer-rawvideo-mp-format=
מרחב צבע לפי פורמט וידאו פנימי עבור --demuxer=rawvideo. להשתמש
--demuxer-rawvideo-mp-format=help לרשימה של פורמטים אפשריים.

--demuxer-rawvideo-codec=
הגדר את ה-codec וידאו במקום לבחור ב-rawvideo codec בעת השימוש
--demuxer=rawvideo. זה משתמש באותם ערכים כמו שמות ה-codec ב --vd (אבל זה כן
לא מקבל שמות מפענחים).

--demuxer-rawvideo-size=
גודל מסגרת בבתים בעת השימוש --demuxer=rawvideo.

--demuxer-max-packets= , --demuxer-max-bytes=
זה שולט בכמה מורשה ל-demuxer לחצץ קדימה. ה-demuxer יהיה
בדרך כלל נסה לקרוא קדימה כמה שצריך, או כמה שמתבקש עם
--demuxer-readahead-secs. ה --demuxer-max-... ניתן להשתמש באפשרויות כדי להגביל
הקריאה המקסימלית. זה מגביל קריאה מוגזמת במקרה של קבצים שבורים או
השמעה לא מסונכרנת. ה-demuxer יפסיק לקרוא חבילות נוספות ברגע אחד
מהגבולות הושג. (עדיין ניתן לחרוג מעט מהגבולות עקב
סיבות טכניות.)

הגדר את המגבלות האלה גבוה יותר אם אתה מקבל אזהרת הצפת תור מנות, ואתה חושב
השמעה רגילה תתאפשר עם תור מנות גדול יותר.

לִרְאוֹת --אפשרויות רשימה עבור ברירות מחדל וטווח ערכים.

--demuxer-thread=
הפעל את ה-demuxer בשרשור נפרד, ותן לו להביא מראש כמות מסוימת של
מנות (ברירת מחדל: כן). הפעלת אפשרות זו עשויה להוביל להפעלה חלקה יותר, אך מופעל
מצד שני יכול להוסיף עיכובים לחיפוש או להחלפת מסלול.

--demuxer-readahead-secs=
If --חוט דמוקסר מופעל, זה שולט בכמה ה-demuxer צריך לחצץ
קדימה תוך שניות (ברירת מחדל: 1). כל עוד לאף חבילה אין הפרש חותמת זמן
גבוה מכמות ה-readahead ביחס לחבילה האחרונה שהוחזרה ל-
מפענח, ה-demuxer ממשיך לקרוא.

שים לב כי --cache-secs האפשרות תעקוף את הערך הזה אם מטמון מופעל,
והערך גדול יותר.

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

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

קֶלֶט
--מפתח חוזר
השתמש בהגדרות המערכת עבור השהייה וקצב חוזרות מקשים, במקום --input-ar-delay ו
--input-ar-rate. (האם זה חל תלוי ב-VO backend ובאופן שבו הוא מטפל
קלט מקלדת. לא חל על קלט מסוף.)

--input-ar-delay
עיכוב באלפיות שניות לפני שנתחיל לחזור אוטומטית על מקש (0 כדי להשבית).

--input-ar-rate
מספר לחיצות המקשים לשנייה בחזרה אוטומטית.

--input-conf=
ציין קובץ תצורת קלט שאינו מיקום ברירת המחדל ב-mpv
ספריית הגדרות (בדרך כלל ~/.config/mpv/input.conf).

--no-input-default-bindings
השבת את כריכות המקשים של mpv ברירת מחדל (מובנית).

--input-cmdlist
מדפיס את כל הפקודות שניתן לקשור למקשים.

--input-doubleclick-time=
הזמן באלפיות שניות לזהות שתי לחיצות רצופות על כפתור בלחיצה כפולה
(ברירת מחדל: 300).

--input-keylist
מדפיס את כל המקשים שניתן לקשור לפקודות.

--input-key-fifo-size=<2-65000>
ציין את גודל ה-FIFO שמאגר אירועי מפתח (ברירת מחדל: 7). אם זה גם כן
קטן חלק מהאירועים עלולים ללכת לאיבוד. החיסרון העיקרי של הגדרת אותו לגדול מאוד
הערך הוא שאם אתה מחזיק מקש לחוץ מפעיל איזו פקודה איטית במיוחד אז
ייתכן שהשחקן לא מגיב בזמן שהוא מעבד את כל הפקודות בתור.

--מבחן קלט
מצב בדיקת קלט. במקום לבצע פקודות בלחיצות מקשים, mpv יציג את ה
המקשים והפקודות המחוברות ב-OSD. יש להשתמש בו עם סרטון דמה, וה-
דרכים רגילות ליציאה מהשחקן לא יעבדו (כריכות מפתח שבדרך כלל יוצאות יפעלו
יוצג ב-OSD בלבד, בדיוק כמו כל כריכה אחרת). לִרְאוֹת INPUT.CONF.

--input-file=
קרא פקודות מהקובץ הנתון. שימושי בעיקר עם FIFO. מאז mpv 0.7.0 גם
מבין פקודות JSON (ראה JSON IPC), אך אינך יכול לקבל תשובות או אירועים. להשתמש
--input-unix-socket למשהו דו-כיווני. ב-MS Windows, פקודות JSON הן
לא זמין.

זה יכול גם לציין מתאר קובץ ישיר עם fd://N (UNIX בלבד). בזה
במקרה, תשובות JSON ייכתבו אם ה-FD ניתן לכתיבה.

הערה:
כאשר הקובץ הנתון הוא FIFO mpv פותח את שני הקצוות, אז אתה יכול לעשות כמה הד
"לְחַפֵּשׂ 10 " > mp_pipe והצינור יישאר בתוקף.

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

--input-unix-socket=
אפשר את תמיכת ה-IPC וצור את שקע ההאזנה בנתיב הנתון.

לִרְאוֹת JSON IPC לקבלת פרטים.

לא זמין ב-MS Windows.

--input-appleremote=
(OS X בלבד) הפעל/השבת את התמיכה של Apple Remote. מופעל כברירת מחדל (למעט
libmpv).

--קלט-סמן, --אין-קלט-סמן
אפשר ל-mpv לקבל אירועי מצביע שדווחו על ידי מנהל ההתקן של פלט הווידאו. נחוץ
כדי להשתמש ב-OSC, או כדי לבחור את הלחצנים בתפריטי DVD. התמיכה תלויה ב-VO
בשימוש.

--input-media-keys=
(OS X בלבד) הפעל/השבת תמיכה במפתחות מדיה. מופעל כברירת מחדל (למעט
libmpv).

--input-right-alt-gr, --no-input-right-alt-gr
(קקאו וחלונות בלבד) השתמש במקש Alt הימני בתור Alt Gr כדי להפיק מיוחד
דמויות. אם מושבת, סופר את ה-Alt הימני כמקש שינוי Alt. מופעל על ידי
ברירת המחדל.

--input-vo-keyboard=
השבת את כל קלט המקלדת המופעל עבור VOs שאינם יכולים להשתתף במקלדת תקינה
שיגור קלט. עשוי שלא להשפיע על כל ה-VOs. שימושי בדרך כלל להטמעה בלבד.

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

הדרך היחידה לטפל בזה בצורה סבירה היא שימוש בפרוטוקול XEmbed, שהיה
נועד לפתור את הבעיות הללו. GTK מספק GtkSocket, התומך ב-XEmbed. Qt
לא נראה שהוא מספק משהו שעובד בגרסאות חדשות יותר.

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

(שם אפשרות זו שונה מ- --input-x11-keyboard.)

--input-app-events=
(OS X בלבד) הפעל/השבת אירועי מקלדת רחבי אפליקציה כך שהמקלדת
ניתן לעבד קיצורי דרך ללא חלון. מופעל כברירת מחדל (למעט
libmpv).

תצוגה על המסך
--osc, --אין-osc
האם לטעון את הבקר על המסך (ברירת מחדל: כן).

--no-osd-bar, --osd-bar
השבת את התצוגה של סרגל ה-OSD. זה יגרום לכמה דברים (כמו חיפוש) להשתמש ב-OSD
הודעות טקסט במקום הסרגל.

אתה יכול להגדיר זאת על בסיס פקודה ב-input.conf באמצעות OSD- קידומות,
לִרְאוֹת קֶלֶט הפקודה קידומות. אם אתה רוצה להשבית את ה-OSD לחלוטין, השתמש
--osd-level=0.

--osd-duration=
הגדר את משך הודעות ה-OSD ב-ms (ברירת מחדל: 1000).

--osd-font= , --sub-text-font=
ציין גופן לשימוש עבור OSD ועבור כתוביות שאינן מציינות בעצמן א
גופן מסוים. ברירת המחדל היא sans-serif.

דוגמאות

· --osd-font='Bitstream ורה Sans'

· --osd-font='MS קומי Sans'

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

זה משמש כדי לתמוך בדפוסי fontconfig. החל מ-libass 0.13.0, זה
הפסיק לפעול.

--osd-font-size= , --sub-text-font-size=
ציין את גודל הגופן של OSD/משנה. היחידה היא הגודל בפיקסלים מותאמים בחלון
גובה של 720. גודל הפיקסלים בפועל משתנה לפי גובה החלון: אם
גובה החלון גדול או קטן מ-720, הגודל האמיתי של הטקסט גדל
או יורד גם כן.

ברירת מחדל: 55.

--osd-msg1=
הצג מחרוזת זו כהודעה ב-OSD עם OSD ברמה 1 (גלוי כברירת מחדל). ה
ההודעה תהיה גלויה כברירת מחדל, וכל עוד אין הודעה אחרת מכסה אותה, וה-
רמת ה-OSD לא משתנה (ראה --רמת OS). מרחיב מאפיינים; לִרְאוֹת נכס
הרחבה.

--osd-msg2=
דומה כמו --osd-msg1, אבל עבור OSD רמה 2. אם זו מחרוזת ריקה (ברירת מחדל),
ואז זמן ההשמעה מוצג.

--osd-msg3=
דומה כמו --osd-msg1, אבל עבור OSD רמה 3. אם זו מחרוזת ריקה (ברירת מחדל),
לאחר מכן יוצגו זמן ההשמעה, משך הזמן וקצת מידע נוסף.

זה משמש גם עבור show_progress הפקודה (כברירת מחדל ממופה ל P), או ב
כמה מקרים שאינם ברירת מחדל בעת חיפוש.

--osd-status-msg הוא מקבילה מורשת (אבל עם הבדל מינורי).

--osd-status-msg=
הצג מחרוזת מותאמת אישית במהלך ההשמעה במקום טקסט הסטטוס הסטנדרטי. זֶה
עוקף את טקסט הסטטוס המשמש --osd-level=3, בעת השימוש ב- show_progress
הפקודה (כברירת מחדל ממופה ל P), או במקרים מסוימים שאינם ברירת מחדל בעת חיפוש.
מרחיב מאפיינים. לִרְאוֹת נכס הרחבה.

אפשרות זו הוחלפה ב --osd-msg3. ההבדל היחיד הוא שזה
אפשרות כוללת באופן מרומז ${osd-sym-cc}. אפשרות זו מתעלמת אם --osd-msg3 is
לא ריק.

--osd-playing-msg=
הצג הודעה ב-OSD כאשר ההשמעה מתחילה. המחרוזת מורחבת עבור מאפיינים,
לְמָשָׁל --osd-playing-msg='קובץ: ${filename}' יציג את ההודעה קובץ: אחריו
רווח ושם הקובץ המושמע כעת.

לִרְאוֹת נכס הרחבה.

--osd-bar-align-x=<-1-1>
מיקום סרגל ה-OSD. -1 הוא הקיצוני שמאלה, 0 ממורכז, 1 הוא הקיצוני מימין. חֶלקִי
ערכים (כמו 0.5) מותרים.

--osd-bar-align-y=<-1-1>
מיקום סרגל ה-OSD. -1 הוא העליון, 0 הוא במרכז, 1 הוא התחתון. ערכי שבר
(כמו 0.5) מותרים.

--osd-bar-w=<1-100>
רוחב סרגל ה-OSD, באחוזים מרוחב המסך (ברירת מחדל: 75). ערך של
50 אומר שהפס הוא חצי מרוחב המסך.

--osd-bar-h=<0.1-50>
גובה סרגל ה-OSD, באחוזים מגובה המסך (ברירת מחדל: 3.125).

--osd-back-color= , --sub-text-back-color=
לִרְאוֹת --osd-color. צבע המשמש לרקע OSD/תת טקסט.

--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0>
גורם טשטוש גאוסי. 0 פירושו שלא הוחל טשטוש (ברירת מחדל).

--osd-bold= , --sub-text-bold=
עיצוב טקסט על מודגש.

--osd-border-color= , --sub-text-border-color=
לִרְאוֹת --osd-color. צבע המשמש עבור גבול ה-OSD/תת גופן.

הערה:
התעלמו מתי --osd-back-color/--sub-text-back-color מצוין (או יותר
בדיוק: כאשר אפשרות זו אינה מוגדרת לשקופה לחלוטין).

--osd-border-size= , --sub-text-border-size=
גודל גבול ה-OSD/תת גופן בפיקסלים מותאמים (ראה --osd-font-size לפרטים).
ערך 0 משבית גבולות.

ברירת מחדל: 3.

--osd-color= , --sub-text-color=
ציין את הצבע המשמש עבור כתוביות OSD/טקסט ללא סגנון.

הצבע מצוין בטופס r/g/b, כאשר כל רכיב צבע מצוין
כמספר בטווח 0.0 עד 1.0. אפשר גם לציין את השקיפות
באמצעות r/g/b/a, כאשר ערך האלפא 0 פירושו שקוף לחלוטין, ו-1.0 פירושו
אָטוּם. אם לא ניתן רכיב אלפא, הצבע אטום ב-100%.

העברת מספר בודד לאפשרות מגדירה את ה-OSD לאפור ואת הטופס אפור/א
מאפשר לך לציין אלפא בנוסף.

דוגמאות

· --osd-color=1.0/0.0/0.0 הגדר את OSD לאדום אטום

· --osd-color=1.0/0.0/0.0/0.75 הגדר את OSD לאדום אטום עם 75% אלפא

· --osd-color=0.5/0.75 הגדר את OSD ל-50% אפור עם 75% אלפא

לחלופין, ניתן לציין את הצבע כטריפלט RGB hex בטופס #RRGGBB,
כאשר כל קבוצה בת 2 ספרות מבטאת ערך צבע בטווח 0 (00) ל- 255 (FF).
לדוגמה, #FF0000 זה אדום. זה דומה לצבעי אינטרנט. אלפא ניתן עם
#AARRGGBB.

דוגמאות

· --osd-color='#FF0000' הגדר את OSD לאדום אטום

· --osd-color='#C0808080' הגדר את OSD ל-50% אפור עם 75% אלפא

--שברי OSD
הצג זמני OSD בשברירי שניות (בדיוק של אלפיות שניות). שימושי לראות
חותמת הזמן המדויקת של מסגרת וידאו.

--osd-level=<0-3>
מציין באיזה מצב ה-OSD אמור להתחיל.

0 OSD מושבת לחלוטין (כתוביות בלבד)

1 מופעל (מופיע רק באינטראקציה של המשתמש)

2 מופעל + השעה הנוכחית גלויה כברירת מחדל

3 מופעל + --osd-status-msg (זמן ומצב נוכחיים כברירת מחדל)

--osd-margin-x= , --sub-text-margin-x=
שוליים של מסך שמאל וימין עבור ה-OSD/משנה בפיקסלים מותאמים (ראה --osd-font-size
לפרטים).

אפשרות זו מציינת את המרחק של ה-OSD שמאלה, וכן באיזה
מרחק מהגבול הימני טקסט OSD ארוך יישבר.

ברירת מחדל: 25.

--osd-margin-y= , --sub-text-margin-y=
שולי המסך העליון והתחתון עבור ה-OSD/משנה בפיקסלים מותאמים (ראה --osd-font-size
לפרטים).

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

ברירת מחדל: 22.

--osd-align-x= , --sub-text-align-x=...
שליטה לאיזו פינה של המסך יש ליישר כתוביות OSD או טקסט
(בְּרִירַת מֶחדָל: מרכז עבור תת, עזבו עבור OSD).

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

--osd-align-y= --sub-text-align-y=...
מיקום אנכי (ברירת מחדל: תחתית עבור תת, חלק עליון עבור OSD). פרטים ראו
--osd-align-x.

--osd-scale=
מכפיל גודל גופן OSD, מוכפל עם --osd-font-size ערך.

--osd-scale-by-window=
האם לשנות את גודל ה-OSD עם גודל החלון (ברירת מחדל: כן). אם זה מושבת,
--osd-font-size ואפשרויות OSD אחרות המשתמשות בפיקסלים מותאמים תמיד נמצאות בפועל
פיקסלים. ההשפעה היא ששינוי גודל החלון לא ישנה את גודל גופן ה-OSD.

--osd-shadow-color= , --sub-text-shadow-color=
לִרְאוֹת --osd-color. צבע המשמש עבור צללית טקסט ב-OSD/משנה.

--osd-shadow-offset= , --sub-text-shadow-offset=
תזוזה של צללית המסך/תת-טקסט בפיקסלים מותאמים (ראה --osd-font-size ל
פרטים). ערך של 0 משבית את הצללים.

ברירת מחדל: 0.

--osd-spacing= , --sub-text-spacing=
מרווח אופקי של OSD/תתי גופנים בפיקסלים מותאמים (ראה --osd-font-size לפרטים).
ערך זה מתווסף למרווח האותיות הרגיל. ערכים שליליים מותרים.

ברירת מחדל: 0.

תמונת מסך
---screenshot-format=
הגדר את סוג קובץ התמונה המשמש לשמירת צילומי מסך.

אפשרויות זמינות:

png PNG

עמודים לדקה PPM

Pgm PGM

pgmyuv PGM עם פורמט YV12 פיקסלים

Tga HAART

jpg JPEG (ברירת מחדל)

jpeg JPEG (זהה ל-jpg, אבל עם סוף קובץ .jpeg)

---screenshot-tag-colorspace=
תייגו צילומי מסך עם מרחב הצבעים המתאים.

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

ברירת מחדל: לא.

--screenshot-high-bit-depth=
אם אפשר, כתוב צילומי מסך עם קצת עומק דומה לסרטון המקור
(ברירת מחדל: כן). זה מעניין במיוחד עבור PNG, כמו זה לפעמים
מפעיל כתיבת PNG של 16 סיביות עם גדלי קבצים עצומים.

---screenshot-template=
ציין את תבנית שם הקובץ המשמשת לשמירת צילומי מסך. התבנית מציינת את
שם קובץ ללא סיומת קובץ, ויכול להכיל מפרטי פורמט, שיהיו
מוחלף בעת צילום מסך. כברירת מחדל התבנית היא mpv-shot%n, אשר
תוצאות בשמות קבצים כמו mpv-shot0012.png למשל.

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

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

מפרטי פורמטים מותרים:

%[#][0X]n
מספר רצף, מרופד באפסים לאורך X (ברירת מחדל: 04). לְמָשָׁל
העברת הפורמט %04n יניב 0012 בצילום המסך ה-12. המספר
גדל בכל פעם שצולמת צילום מסך או אם הקובץ כבר
קיים. האורך X חייב להיות בטווח 0-9. עם הסימן # האופציונלי, mpv
ישתמש במספר הנמוך ביותר הזמין. לדוגמה, אם אתה לוקח שלושה
צילומי מסך--0001, 0002, 0003--ומחק את השניים הראשונים, את השניים הבאים
צילומי מסך לא יהיו 0004 ו-0005, אלא שוב 0001 ו-0002.

%f שם הקובץ של הסרטון המושמע כעת.

%F כמו %f, אבל הסר את סיומת הקובץ, כולל הנקודה.

%x נתיב הספרייה של הסרטון המושמע כעת. אם הסרטון לא נמצא ב-
מערכת קבצים (אבל למשל http://), זה מתרחב למחרוזת ריקה.

%X{fallback}
כמו %x, אבל אם קובץ הווידאו לא נמצא במערכת הקבצים, החזר את הקובץ
מחרוזת fallback בתוך {...}.

%p זמן השמעה נוכחי, באותו הפורמט שבו נעשה שימוש ב-OSD. התוצאה היא
מחרוזת בצורה "HH:MM:SS". לדוגמה, אם הסרטון נמצא באותו זמן
מיקום 5 דקות ו-34 שניות, %p יוחלף ב-"00:05:34".

%P דומה %p, אך מורחב עם זמן ההשמעה באלפיות שניות. זה
בפורמט "HH:MM:SS.mmm", כאשר "mmm" הוא החלק של אלפית השניות של
זמן השמעה.

הערה:
זוהי דרך פשוטה לקבלת חותמות זמן ייחודיות לכל מסגרת. (מִסגֶרֶת
המספרים יהיו אינטואיטיביים יותר, אך אינם ניתנים ליישום בקלות מכיוון
פורמטים של מיכל משתמשים בדרך כלל בחותמות זמן לזיהוי מסגרות.)

%wX ציין את זמן ההשמעה הנוכחי באמצעות מחרוזת הפורמט X. %p הוא כמו
%wH:%wM:%wS, ו %P הוא כמו %wH:%wM:%wS.%wT.

תקף פוּרמָט מפרטים:

%wH שעה (מרופדת ב-0 עד שתי ספרות)

%wh שעה (לא מרופד)

%wM דקות (00-59)

%wm סך הדקות (כולל שעות, בניגוד %wM)

%wS שניות (00-59)

%ws סך שניות (כולל שעות ודקות)

%wf כמו %ws, אבל כמו לצוף

%wT אלפיות שניות (000-999)

%tX ציין את התאריך/שעה המקומיים הנוכחיים באמצעות הפורמט X. הפורמט הזה
המפרט משתמש ב-UNIX זמן עבודה () לתפקד באופן פנימי, ומכניס את
תוצאה של העברת "%X" אל זמן אחסון. לדוגמה, % tm יכניס את המספר
של החודש הנוכחי כמספר. אתה צריך להשתמש במספר %tX מפרטים ל
לבנות מחרוזת תאריך/שעה מלאה.

%{prop[:fallback טֶקסט]}
הכנס את הערך של מאפיין העבדים 'prop'. לְמָשָׁל %{שם קובץ} אותו הדבר
as %f. אם המאפיין אינו קיים או אינו זמין, טקסט שגיאה הוא
הוכנס, אלא אם צוין נפילה.

%% הוחלף ב- % הדמות עצמה.

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

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

אפשרות זו אינה מוגדרת כברירת מחדל, ולכן תכתוב צילומי מסך לספרייה
שממנו הופעל mpv. במצב פסאודו-גוי (ראה מדומה GUI MODE), זה מוגדר
לשולחן העבודה.

--screenshot-jpeg-quality=<0-100>
הגדר את רמת האיכות של JPEG. גבוה יותר פירושו איכות טובה יותר. ברירת המחדל היא 90.

--screenshot-jpeg-source-chroma=
כתוב קבצי JPEG עם תת-דגימת כרומה זהה לסרטון (ברירת מחדל: כן). אם
מושבת, ברירת המחדל של libjpeg משמשת.

--screenshot-png-compression=<0-9>
הגדר את רמת הדחיסה של PNG. גבוה יותר פירושו דחיסה טובה יותר. זה ישפיע
גודל הקובץ של קובץ צילום המסך הכתוב והזמן שלוקח לכתוב א
צילום מסך. דחיסה גבוהה מדי עלולה לתפוס מספיק זמן מעבד כדי להפריע
השמעה. ברירת המחדל היא 7.

--screenshot-png-filter=<0-5>
הגדר את המסנן שהוחל לפני דחיסת PNG. 0 הוא אף אחד, 1 הוא "משנה", 2 הוא "למעלה",
3 הוא "ממוצע", ​​4 הוא "פאת'" ו-5 הוא "מעורב". זה משפיע על הרמה של
דחיסה שניתן להשיג. עבור רוב התמונות, "מעורב" משיג את הטוב ביותר
יחס דחיסה, ומכאן שהוא ברירת המחדל.

תוכנה סקאלר
--sws-scaler=
ציין את אלגוריתם scaler התוכנה שיש להשתמש בו --vf=קנה מידה. זה גם משפיע
מנהלי התקנים של פלט וידאו חסרי האצת חומרה, למשל x11. ראה גם
--vf=קנה מידה.

כדי לקבל רשימה של scalers זמינים, הפעל --sws-scaler=עזרה.

ברירת מחדל: BICUBIC.

--sws-lgb=<0-100>
סקולר תוכנה מסנן טשטוש גאוס (luma). לִרְאוֹת --sws-scaler.

--sws-cgb=<0-100>
סקולר תוכנה מסנן טשטוש גאוס (כרומה). לִרְאוֹת --sws-scaler.

--sws-ls=<-100-100>
מסנן חידוד תוכנה scaler (luma). לִרְאוֹת --sws-scaler.

--sws-cs=<-100-100>
מסנן חידוד תוכנה scaler (chroma). לִרְאוֹת --sws-scaler.

--sws-chs=
תוכנה scaler chroma הסטת אופקי. לִרְאוֹת --sws-scaler.

--sws-cvs=
תוכנה scaler chroma היסט אנכי. לִרְאוֹת --sws-scaler.

מסוף
--שֶׁקֶט
הפוך את פלט המסוף פחות מילולי; במיוחד, מונע את שורת המצב (כלומר AV:
3.4 (00:00:03.37) / 5320.6 ...) מלהוצג. שימושי במיוחד באיטיות
מסופים או שבורים שאינם מטפלים כראוי בהחזרת הכרכרה (כלומר \r).

ראה גם --ממש-שקט ו --msg-level.

--ממש-שקט
הצג אפילו פחות הודעות פלט ומצב מאשר עם --שֶׁקֶט.

--ללא מסוף, --מָסוֹף
השבת כל שימוש בטרמינל וב-stdin/stdout/stderr. זה משתיק לחלוטין
כל פלט הודעה.

שונה --ממש-שקט, זה משבית גם אתחול הקלט והטרמינל.

--no-msg-color
השבת פלט מסוף צבעוני במסופים.

--msg-level=
שליטה במילוליות ישירות עבור כל מודול. ה את כל מודול משנה את המלל של
כל המודולים שלא צוינו במפורש בשורת הפקודה.

הפעל mpv עם --msg-level=all=trace כדי לראות את כל ההודעות יציאות mpv. אתה יכול להשתמש ב
שמות המודולים המודפסים בפלט (עם קידומת לכל שורה ב [...]) כדי להגביל את
פלט למודולים מעניינים.

הערה:
חלק מההודעות מודפסות לפני ניתוח שורת הפקודה ולכן הן מודפסות
לא מושפע מ --msg-level. כדי לשלוט בהודעות אלה, עליך להשתמש ב-
MPV_VERBOSE משתנה הסביבה; לִרְאוֹת הסביבה וריאציות לקבלת פרטים.

רמות זמינות:

לא דממה מוחלטת

קטלני הודעות קטלניות בלבד

שגיאה הודעות שגיאה

להזהיר הודעות אזהרה

מידע הודעות מידע

מצב הודעות סטטוס (ברירת מחדל)

v הודעות מילוליות

באגים איתור באגים בהודעות

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

--term-osd, --no-term-osd, --term-osd=כוח
הצג הודעות OSD במסוף כאשר אין פלט וידאו זמין. מופעל על ידי
ברירת המחדל.

כּוֹחַ מאפשר מסוף OSD גם אם נוצר חלון וידאו.

--term-osd-bar, --no-term-osd-bar
אפשר הדפסת סרגל התקדמות מתחת לשורת המצב במסוף. (מושבת על ידי
בְּרִירַת מֶחדָל.)

--term-osd-bar-chars=
התאם אישית את --term-osd-bar תכונה. המחרוזת צפויה להיות מורכבת מ-5
תווים (התחלה, רווח שמאלי, מחוון מיקום, רווח ימני, סוף). אתה יכול להשתמש
תווי Unicode, אך שים לב שתווים ברוחב כפול לא יטופלו
נכונה.

ברירת מחדל: [-+-].

--term-playing-msg=
הדפס מחרוזת לאחר תחילת ההשמעה. המחרוזת מורחבת עבור מאפיינים,
לְמָשָׁל --term-playing-msg='קובץ: ${filename}' ידפיס את המחרוזת קובץ: אחריו
רווח ושם הקובץ המושמע כעת.

לִרְאוֹת נכס הרחבה.

--term-status-msg=
הדפס מחרוזת מותאמת אישית במהלך ההשמעה במקום שורת המצב הרגילה.
מרחיב מאפיינים. לִרְאוֹת נכס הרחבה.

--msg-module
הוסף את שם המודול לכל הודעת מסוף.

--msg-time
הוסף מידע תזמון לכל הודעת מסוף.

TV
--טֵלֶוִיזִיָה-...
אפשרויות אלה מכווננות מאפיינים שונים של מודול לכידת הטלוויזיה. לצפייה בטלוויזיה
עם mpv, השתמש טֵלֶוִיזִיָה:// or טֵלֶוִיזִיָה:// או אפילו טֵלֶוִיזִיָה:// (ראה
אוֹפְּצִיָה ערוצי טלוויזיה ל שם הערוץ להלן) ככתובת URL של מדיה. אתה יכול גם להשתמש
טֵלֶוִיזִיָה:/// כדי להתחיל לצפות בסרטון מקלט מורכב או S-Video (ראה
אוֹפְּצִיָה קלט לפרטים).

--tv-device=
ציין מכשיר טלוויזיה (ברירת מחדל: / dev / video0).

--ערוץ טלוויזיה=
הגדר את הטיונר ל עָרוּץ.

--ללא טלוויזיה-שמע
אין קול

--tv-automute=<0-255> (v4l ו v4l2 בלבד)
אם עוצמת האות המדווחת על ידי המכשיר נמוכה מהערך הזה, האודיו והווידאו יהיו
להיות מושתק. ברוב המקרים אוטומט=100 יספיק. ברירת המחדל היא 0 (השתקה אוטומטית
נָכֶה).

--tv-driver=
לִרְאוֹת --tv=נהג=עזרה עבור רשימה של מנהלי התקנים של קלט טלוויזיה. זמין: דמה,
v4l2 (ברירת מחדל: זיהוי אוטומטי)

--TV-input=
ציין קלט (ברירת מחדל: 0 (טלוויזיה), ראה פלט מסוף לכניסות זמינות).

--TV-freq=
ציין את התדר להגדרת הטיונר (למשל 511.250). לא תואם את
פרמטר ערוצים.

--tv-outfmt=
ציין את פורמט הפלט של הטיונר עם ערך מוגדר מראש הנתמך על ידי ה-V4L
מנהל התקן (YV12, UYVY, YUY2, I420) או פורמט שרירותי שניתן כערך hex.

--TV-width=
רוחב חלון פלט

--TV-height=
גובה חלון פלט

--tv-fps=
קצב פריימים שבו ללכוד וידאו (פריימים לשנייה)

--TV-buffersize=
גודל מקסימלי של מאגר הלכידה במגה-בייט (ברירת מחדל: דינמי)

--TV-norm=
עיין בפלט המסוף לרשימה של כל הנורמות הזמינות, ראה גם את נורמידי
אפשרות למטה.

--tv-normid= (v4l2 בלבד)
מגדיר את נורמת הטלוויזיה למזהה המספרי הנתון. נורמת הטלוויזיה תלויה בכרטיס הלכידה.
עיין בפלט הקונסולה לקבלת רשימה של נורמות טלוויזיה זמינות.

--TV-chanlist=
זמין: ארגנטינה, אוסטרליה, china-bcast, אירופה-מזרח, אירופה-מערב, צרפת,
אירלנד, איטליה, japan-bcast, japan-cable, ניו זילנד, רוסיה, דרום אפריקה,
us-bcast, us-cable, us-cable-hrc

--ערוצי טלוויזיה= - [= ], - [= ],...
הגדר שמות לערוצים.

הערה:
אם הוא מספר שלם הגדול מ-1000, הוא יטופל כתדירות (ב
kHz) במקום שם הערוץ מטבלת התדרים. השתמש ב-_ עבור רווחים בשמות
(או לשחק עם ציטוט ;-) ). שמות הערוצים ייכתבו לאחר מכן באמצעות OSD,
והעבד מצווה tv_step_channel, tv_set_channel ו tv_ערוץ_אחרון יצטרך
להיות שמיש עבור שלט רחוק. לא תואם את תדר פָּרָמֶטֶר.

הערה:
מספר הערוץ יהיה אז המיקום ברשימת 'הערוצים', מתחיל
עם 1.

דוגמאות

tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1

--tv-[בהירות|ניגודיות|גוון|רוויה]=<-100-100>
הגדר את אקולייזר התמונה על הכרטיס.

--tv-audiorate=
הגדר קצב דגימת שמע קלט.

--tv-forceaudio
לכוד אודיו גם אם אין מקורות אודיו שדווחו על ידי v4l.

--tv-alsa
לכידה מ-ALSA.

--tv-amode=<0-3>
בחר מצב שמע:

0 מונו

1 סטראו

2 שפה 1

3 שפה 2

--tv-forcechan=<1-2>
כברירת מחדל, ספירת ערוצי השמע המוקלטים נקבעת באופן אוטומטי על ידי
שאילתת מצב השמע מכרטיס הטלוויזיה. אפשרות זו מאפשרת לכפות סטריאו/מונו
הקלטה ללא קשר לאפשרות ה-amode ולערכים המוחזרים על ידי v4l. זה יכול
לשמש לפתרון בעיות כאשר כרטיס הטלוויזיה אינו מסוגל לדווח על השמע הנוכחי
מצב.

--tv-adevice=
הגדר התקן שמע. צריך להיות /dev/xxx עבור OSS ומזהה חומרה עבור ALSA.
עליך להחליף כל ':' ב-'.' במזהה החומרה עבור ALSA.

--tv-audioid=
בחר פלט שמע של כרטיס הלכידה, אם יש לו יותר מאחד.

--tv-[נפח|בס|טרבל|איזון]=<0-100>
אפשרויות אלו קובעות פרמטרים של המיקסר בכרטיס לכידת הווידאו. הם י
אין השפעה, אם אין לכרטיס שלך. עבור מפות v4l2 50 לברירת המחדל
ערך הבקרה, כפי שדווח על ידי הנהג.

--tv-gain=<0-100>
הגדר את בקרת הרווח עבור מכשירי וידאו (בדרך כלל מצלמות אינטרנט) לערך הרצוי ו
לכבות את הבקרה האוטומטית. ערך 0 מאפשר שליטה אוטומטית. אם זה
האפשרות נשמטה, בקרת הרווח לא תשתנה.

--tv-immediatemode=
ערך של 0 פירושו לכידה ולחצר אודיו ווידאו ביחד. ערך של 1
(ברירת מחדל) פירושו לבצע לכידת וידאו בלבד ולתת לאודיו לעבור לולאה חוזרת
כבל מכרטיס הטלוויזיה לכרטיס הקול.

--tv-mjpeg
השתמש בדחיסת MJPEG חומרה (אם הכרטיס תומך בכך). בעת שימוש באפשרות זו,
אתה לא צריך לציין את הרוחב והגובה של חלון הפלט, כי mpv
יקבע אותו אוטומטית מערך הדצימציה (ראה להלן).

--tv-decimation=<1|2|4>
בחר את גודל התמונה שתדחס על ידי חומרה MJPEG
דְחִיסָה:

1 גודל מלא

· 704x576 PAL

· 704x480 NTSC

2 מידה מדיום

· 352x288 PAL

· 352x240 NTSC

4 מידה קטנה

· 176x144 PAL

· 176x120 NTSC

--TV-quality=<0-100>
בחר את איכות דחיסת ה-JPEG (מומלץ פחות מ-60 לגודל מלא).

--tv-scan-autostart
התחל בסריקת ערוצים מיד לאחר האתחול (ברירת מחדל: מושבת).

--tv-scan-period=<0.1-2.0>
ציין השהיה בשניות לפני המעבר לערוץ הבא (ברירת מחדל: 0.5). נמוך יותר
ערכים יגרמו לסריקה מהירה יותר, אך יכולים לזהות ערוצי טלוויזיה לא פעילים כפעילים.

--tv-scan-threshold=<1-100>
ערך סף עבור עוצמת האות (באחוזים), כפי שדווח על ידי המכשיר
(ברירת מחדל: 50). עוצמת אות גבוהה מהערך הזה תצביע על כך שה
ערוץ הסורק כרגע פעיל.

סליק
--cache=
הגדר את גודל המטמון בקילו-בייט, השבת אותו עם לא, או הפעל אוטומטית
זה אם צריך עם המכונית (בְּרִירַת מֶחדָל: המכונית). עם המכונית, המטמון יהיה בדרך כלל
מופעל עבור זרמי רשת, תוך שימוש בגודל שנקבע על ידי --cache-default. עם כן, ה
מטמון תמיד יהיה מופעל עם הגודל שנקבע על ידי --cache-default (אלא אם כן ה
זרם לא ניתן לאחסן במטמון, או --cache-default משבית את השמירה במטמון).

עשוי להיות שימושי בעת הפעלת קבצים ממדיה איטית, אך יכול להיות גם שלילי
אפקטים, במיוחד עם פורמטים של קבצים שדורשים הרבה חיפוש, כמו MP4.

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

--cache-default=
הגדר את גודל המטמון בקילו-בייט (ברירת מחדל: 75000 KB). באמצעות לא לא יהיה
הפעל אוטומטית את המטמון, למשל בעת משחק מזרם רשת. ציין זאת
באמצעות --מטמון תמיד יעקוף את האפשרות הזו.

--cache-initial=
ההשמעה תתחיל כאשר המטמון יתמלא בהרבה קילובייטים של
נתונים (ברירת מחדל: 0).

--cache-seek-min=
אם יש לחפש עמדה בפנים של גודל המטמון מה-
המיקום הנוכחי, mpv ימתין למילוי המטמון למיקום זה
מאשר ביצוע חיפוש זרם (ברירת מחדל: 500).

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

--cache-backbuffer=
גודל מאגר המטמון בחזרה (ברירת מחדל: 75000 KB). זה יוסיף למטמון הכולל
גודל, ושמר את הסכום לחיפוש חזרה. הסכום השמור לא יהיה
משמש ל-readahead, ובמקום זאת משמר נתונים שכבר נקראו כדי לאפשר חיפוש מהיר
חזור.

--cache-file=
צור קובץ מטמון במערכת הקבצים.

ישנן שתי דרכים להשתמש בזה:

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

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

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

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

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

2. העברת המיתר Tmp. זה לא יתפרש כשם קובץ. במקום זאת, א
נוצר קובץ זמני בלתי נראה. זה תלוי בספריית C שלך איפה זה
הקובץ נוצר (בדרך כלל / tmp /), והאם שם הקובץ גלוי (ה tmpfile()
נעשה שימוש בפונקציה). במערכות מסוימות, ייתכן שמחיקה אוטומטית של קובץ המטמון
לא מובטח.

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

ראה גם --- cache-file-size.

--cache-file-size=
גודל מקסימלי של הקובץ שנוצר באמצעות --קובץ מטמון. לגישות קריאה מעל זה
גודל, המטמון פשוט אינו בשימוש.

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

(ברירת מחדל: 1048576, 1 GB.)

--ללא מטמון
כבה את שמירה במטמון של זרם קלט. לִרְאוֹת --מטמון.

--cache-secs=
כמה שניות של אודיו/וידאו לשלוף מראש אם המטמון פעיל. זה עוקף
מה היא --demuxer-readahead-secs אפשרות אם ורק אם המטמון מופעל וה-
הערך גדול יותר. (ברירת מחדל: 10.)

--cache-pause, --no-cache-pause
האם הנגן צריך להשהות אוטומטית כשהמטמון מתרוקן, ולבטל את ההשהיה
ברגע שיהיו יותר נתונים זמינים ("buffering").

רשת
--user-agent=
השתמש כסוכן משתמש עבור הזרמת HTTP.

--עוגיות, --אין עוגיות
תמיכה בעוגיות בעת ביצוע בקשות HTTP. מושבת כברירת מחדל.

--cookies-file=
קרא עוגיות HTTP מ . ההנחה היא שהקובץ בפורמט Netscape.

--http-header-fields=
הגדר שדות HTTP מותאמים אישית בעת גישה לזרם HTTP.

דוגמה

mpv --http-header-fields='Field1: value1','Field2: value2' \
http://localhost: 1234

יפיק בקשת HTTP:

GET / HTTP / 1.0
מארח: מארח מקומי: 1234
סוכן משתמש: MPlayer
Icy-MetaData: 1
שדה1: ערך1
שדה2: ערך2
חיבור: קרוב

--tls-ca-file=
קובץ מסד הנתונים של רשות האישורים לשימוש עם TLS. (נכשל בשקט עם מבוגרים
גרסאות FFmpeg או Libav.)

--tls-verify
אמת אישורי עמיתים בעת שימוש ב-TLS (למשל עם https://...). (נכשל בשקט
עם גרסאות ישנות יותר של FFmpeg או Libav.)

--tls-cert-file
קובץ המכיל אישור לשימוש בלחיצת היד עם העמית.

--tls-key-file
קובץ המכיל את המפתח הפרטי של האישור.

--מפנה=
ציין נתיב מפנה או כתובת אתר עבור בקשות HTTP.

--network-timeout=
ציין את פסק הזמן הקצוב של הרשת בשניות. זה משפיע על HTTP לפחות. המיוחד
ערך 0 (ברירת מחדל) משתמש בברירות המחדל של FFmpeg/Libav. אם נעשה שימוש בפרוטוקול מה כן
לא תומך בתקופת זמן קצוב, אפשרות זו מתעלמת בשקט.

--rtsp-transport=
בחר שיטת תעבורה RTSP (ברירת מחדל: tcp). זה בוחר את הרשת הבסיסית
הובלה בעת משחק rtsp://... כתובות אתרים. הערך lavf משאיר את ההחלטה
libavformat.

--hls-bitrate= >
אם מופעלים זרמי HLS, אפשרות זו שולטת באילו זרמים נבחרים
בְּרִירַת מֶחדָל. האפשרות מאפשרת את הפרמטרים הבאים:

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

דקות בחר את הזרמים עם קצב הסיביות הנמוך ביותר.

מקסימום זהה, אבל קצב הסיביות הגבוה ביותר. (בְּרִירַת מֶחדָל.)

בנוסף, אם האפשרות היא מספר, הזרם עם הקצב הגבוה ביותר שווה ל- או
מתחת נבחר ערך האופציה.

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

DVB
--dvbin-card=<1-4>
מציין באמצעות כרטיס מספר 1-4 (ברירת מחדל: 1).

--dvbin-file=
מורה ל-mpv לקרוא את רשימת הערוצים . ברירת המחדל היא ב-mpv
ספריית הגדרות (בדרך כלל ~/.config/mpv) עם שם הקובץ
channels.conf.{sat,ter,cbl,atsc} (בהתבסס על סוג הכרטיס שלך) או channels.conf בתור
מוצא אחרון. עבור כרטיסי DVB-S/2, מומלצת רשימת ערוצים בפורמט VDR 1.7.x כ
הוא מאפשר כוונון לערוצי DVB-S2, מאפשר כתוביות ופענוח ה-PMT (אשר
משפר במידה רבה את הוצאת הרוק). רשימות הערוצים בפורמט mplayer הקלאסי עדיין
נתמך (ללא שיפורים אלה), ולסוגי כרטיסים אחרים, רק VDR מוגבל
מיושם תמיכה ברשימת ערוצים בפורמט (תיקונים יתקבלו בברכה). לערוצים עם
מיתוג PID דינמי או לא שלם channels.conf, --dvbin-משדר מלא או
קסם PID 8192 מומלץ.

--dvbin-timeout=<1-30>
מספר שניות מקסימלי להמתנה כאשר מנסים לכוון תדר לפני מוותרים
(ברירת מחדל: 30).

--dvbin-full-transponder=
אין להחיל מסננים על PID של תוכנית, רק לכוון לתדר ולהעביר משדר מלא
ל-deluxer. זה שימושי להקלטת תוכניות מרובות על משדר יחיד, או
לעקוף בעיות ב channels.conf. מומלץ להשתמש בזה גם עבור
ערוצים המחליפים PID תוך כדי תנועה, למשל לחדשות אזוריות.

ברירת מחדל: לא

שונות
--display-tags=tag1,tags2,...
הגדר את רשימת התגים שאמורים להיות מוצגים בטרמינל. תגיות שנמצאות ב-
רשימה, אך אינם נוכחים בקובץ המושמע, לא תוצג. אם ערך מסתיים
עם *, כל התגים מותאמים לפי קידומת (אם כי אין גלוב כללי). רַק
חולף * בעצם סינון.

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

--mc=
תיקון AV סינכרון מרבי לכל פריים (בשניות)

--autosync=
מתאים בהדרגה את סינכרון ה-A/V על סמך מדידות השהיית שמע. מפרט
--autosync=0, ברירת המחדל, יגרום לתזמון הפריימים להתבסס כולו על אודיו
עיכוב מדידות. מפרט --autosync=1 יעשה את אותו הדבר, אבל יעשה בעדינות
לשנות את אלגוריתם תיקון ה-A/V. קצב פריימים לא אחיד של וידאו בסרטון אשר
משחק מצוין עם --אין שמע לעתים קרובות ניתן לעזור על ידי הגדרת זה לערך של מספר שלם
גדול מ-1. ככל שהערך גבוה יותר, כך התזמון יהיה קרוב יותר --אין שמע.
לנסות --autosync=30 כדי להחליק בעיות עם מנהלי התקן סאונד שאינם מיישמים
מדידת עיכוב אודיו מושלמת. עם ערך זה, אם קיזוז גדול של סנכרון A/V
להתרחש, ייקח להם רק 1 או 2 שניות להתיישב. העיכוב הזה ב
זמן תגובה לקיזוז A/V פתאומי אמור להיות תופעת הלוואי היחידה של הפיכת זה
אפשרות פועלת, עבור כל מנהלי ההתקן של הסאונד.

--video-sync=
כיצד הנגן מסנכרן אודיו ווידאו.

המצבים שמתחילים ב התצוגה נסה להוציא מסגרות וידאו לחלוטין
באופן סינכרוני לתצוגה, תוך שימוש בקצב הרענון האנכי של התצוגה שזוהה בתור א
רמז באיזו מהירות פריימים יוצגו בממוצע. מצבים אלה משנים את מהירות הווידאו
מעט כדי להתאים לתצוגה. לִרְאוֹת --סנכרון וידאו-... אפשרויות לכוונון עדין. ה
החוסן של מצב זה מצטמצם עוד יותר על ידי הנחת כמה הנחות אידאליות,
מה שאולי לא תמיד תקף במציאות. ההתנהגות יכולה להיות תלויה ב-VO וב-
מנהלי הווידאו והשמע של המערכת. קבצי מדיה חייבים להשתמש בקצב פריימים קבוע.
VFR מבחינת מקטע עשוי לעבוד גם עם כמה פורמטים של מיכל (אך לא למשל mkv).
אם קוד הסנכרון מזהה ביטול סינכרון A/V חמור, או שלא ניתן לזהות את קצב הפריימים,
הנגן חוזר אוטומטית אודיו מצב למשך זמן מה או לצמיתות.

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

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

תצוגה-דגימה מחדש
דגימת אודיו מחדש כדי להתאים לסרטון. מצב זה ינסה גם להתאים את האודיו
מהירות כדי לפצות על סחיפה אחרת. (זה אומר שהוא ישמיע את האודיו ב
מהירות שונה מדי פעם כדי להפחית את הפרש ה-A/V.)

display-resample-vdrop
דגימת אודיו מחדש כדי להתאים לסרטון. שחרר מסגרות וידאו כדי לפצות עליהן
סְחִיפָה.

display-resample-desync
כמו המצב הקודם, אבל אין פיצוי A/V.

display-vdrop
שחרר או חזור על מסגרות וידאו כדי לפצות על ביטול סנכרון וידאו. (למרות שזה
אמורות להיות אותן השפעות כמו אודיו, היישום הוא מאוד
שונה.)

display-adrop
שחרר או חזור על נתוני אודיו כדי לפצות על ביטול סנכרון וידאו. לִרְאוֹת
--video-sync-adrop-size. מצב זה יגרום לחפצי אודיו חמורים אם
קצב הרענון האמיתי של הצג שונה מדי מהקצב המדווח או הכפוי.

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

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

--video-sync-max-video-change=
הפרש מהירות מקסימלי באחוזים המוחל על וידאו עם
--video-sync=display-... (ברירת מחדל: 1). מצב סנכרון תצוגה יושבת אם
דרך הצג ורענון הווידאו אינם תואמים בטווח הנתון. זה מנסה
גם כפולות: השמעת וידאו של 30 פריימים לשנייה על מסך 60 הרץ ישכפל כל
מסגרת שנייה. הפעלת וידאו של 24 פריימים לשנייה על מסך 60 הרץ תפעיל וידאו ב-a
2-3-2-3-... תבנית.

הגדרות ברירת המחדל אינן רופפות מספיק כדי להאיץ וידאו של 23.976 פריימים לשנייה ל-25 פריימים לשנייה.
אנו רואים בשינוי הגובה קיצוני מדי כדי לאפשר התנהגות זו כברירת מחדל. מַעֲרֶכֶת
אפשרות זו לערך של 5 כדי להפעיל אותו.

שים לב שבתוך --video-sync=display-resample במצב, מהירות השמע תהיה בנוסף
ישתנה בכמות קטנה במידת הצורך לסנכרון A/V. לִרְאוֹת
--video-sync-max-audio-change.

--video-sync-max-audio-change=
מַקסִימוּם נוסף הפרש מהירות באחוזים המוחל על אודיו עם
--video-sync=display-... (ברירת מחדל: 0.125). בדרך כלל, הנגן מנגן את האודיו ב
מהירות הסרטון. אבל אם ההבדל בין מיקום אודיו ווידאו הוא
גבוה מדי, למשל עקב סחיפה או שגיאות תזמון אחרות, הוא ינסה להאיץ או
האט את השמע על ידי גורם נוסף זה. ערכים נמוכים מדי עלולים להוביל למסגרת וידאו
ירידה או חזרה אם אי-סינכרון ה-A/V אינו ניתן לפיצוי, ערכים גבוהים מדי
עלול להוביל לנפילת פריים כאוטית בגלל "חיתוך יתר" ודילוג של האודיו
מספר פריימים של וידאו לפני שהלוגיקת הסנכרון יכולה להגיב.

--video-sync-adrop-size=
כדי להתאים --video-sync=display-adrop מצב. מצב זה משכפל/מפיל נתוני אודיו ל
לשמור על אודיו מסונכרן עם וידאו. כדי למנוע חפצי אודיו על ריצוד (מה שיעשה
להוסיף/להסיר דוגמאות כל הזמן), זה נעשה ביחידות גדולות יחסית וקבועות,
נשלט על ידי אפשרות זו. היחידה היא שניות.

--mf-fps=
קצב פריימים בשימוש בעת פענוח מקבצי PNG או JPEG מרובים עם mf:// (בְּרִירַת מֶחדָל:
1).

--mf-type=
סוג קובץ קלט עבור mf:// (זמין: jpeg, png, tga, sgi). כברירת מחדל, זהו
ניחש מתוך סיומת הקובץ.

--stream-capture=
מאפשר לכידת הזרם הראשי (לא רצועות אודיו נוספות או סוג אחר של
streams) לקובץ הנתון. ניתן להתחיל ולהפסיק את הצילום גם על ידי שינוי
שם הקובץ עם ה לכידת זרם רכוש עבדים. בדרך כלל זה לא יקרה
לייצר תוצאות שמישות עבור כל דבר אחר מלבד MPEG או זרמים גולמיים, אלא אם כן לכידה
כולל את כותרות הקובץ ואינו מופרע. שימו לב, בגלל מטמון
השהיות, נתונים שנלכדו עשויים להתחיל ולהסתיים באיחור מסוים בהשוואה למה שאתה
לראות מוצג.

קובץ היעד תמיד מצורף. (לפני mpv 0.8.0, הקובץ היה
מוחלף.)

--stream-dump=
כמו -- לכידת זרם, אך אל תתחיל השמעה. במקום זאת, הקובץ כולו הוא
זרקו.

--stream-lavf-o=opt1=value1,opt2=value2,...
הגדר AVOptions בזרמים שנפתחו ב-libavformat. אפשרויות לא ידועות או באיות שגוי הן
התעלמו בשקט. (הם מוזכרים בפלט הטרמינל במצב מילולי, כלומר
--v. באופן כללי אנחנו לא יכולים להדפיס שגיאות, כי אפשרויות אחרות כגון משתמש
סוכן אינם זמינים עם כל הפרוטוקולים, ושגיאות הדפסה עבור אפשרויות לא ידועות
בסופו של דבר יהיה רועש מדי.)

--vo-mmcss-profile=
(Windows בלבד.) הגדר את פרופיל MMCSS עבור שרשור מעבד הווידאו (ברירת מחדל:
פלייבק).

--עדיפות=
(חלונות בלבד.) הגדר עדיפות תהליך עבור mpv לפי המוגדר מראש
סדרי עדיפויות זמינים תחת Windows.

ערכים אפשריים של : סרק|מתחת לרגיל|רגיל|מעל רגיל|גבוה|זמן אמת

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

--force-media-title=
לכפות את התוכן של כותרת מדיה נכס לערך זה. שימושי עבור סקריפטים
שרוצים להגדיר כותרת, מבלי לעקוף את ההגדרה של המשתמש ב --כותרת.

שמע תפוקה נהגים

מנהלי התקנים של פלט אודיו הם ממשקים למתקני פלט אודיו שונים. התחביר הוא:

--ao=
ציין רשימת עדיפות של מנהלי התקנים של פלט אודיו לשימוש.

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

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

--ao-defaults=
הגדר ברירת מחדל עבור כל מנהל התקן.

הערה:
לִרְאוֹת --ao=עזרה לרשימה של מנהלי התקנים של פלט אודיו שהורכבו. הנהג --ao=אלסה is
מועדף. --ao=דופק מועדף במערכות שבהן נעשה שימוש ב-PulseAudio. בווינדוס,
--ao=wasapi עדיף, אם כי זה עלול לגרום לפעמים לצרות, ובמקרה כזה
--ao=dsound צריך לשמש. במערכות BSD, --ao=oss or --ao=sndio` עשוי לעבוד (ה
האחרון הוא ניסיוני). במערכות OS X, השתמש --ao=coreaudio.

דוגמאות

· --ao=alsa,oss, נסה את מנהל ההתקן של ALSA, אחר כך את מנהל ההתקן של OSS, ואז אחרים.

· --ao=alsa:resample=yes:device=[plughw:0,3] מאפשר ל-ALSA לדגום מחדש ומגדיר את
מכשיר-שם ככרטיס ראשון, מכשיר רביעי.

מנהלי התקנים זמינים של פלט שמע הם:

כמו כן (לינוקס בלבד)
מנהל התקן פלט שמע ALSA

מכשיר=
מגדיר את שם המכשיר. עבור פלט AC3 באמצעות S/PDIF, השתמש ב-"iec958" או "spdif"
מכשיר, אלא אם כן אתה באמת יודע איך להגדיר אותו נכון.

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

מיקסר-מכשיר=
הגדר את מכשיר המיקסר שבו נעשה שימוש --לא-softvol (בְּרִירַת מֶחדָל: ברירת מחדל).

מיקסר-שם=
הגדר את השם של אלמנט המיקסר (ברירת מחדל: אב). זה למשל PCM
or אב.

mixer-index=
הגדר את האינדקס של ערוץ המיקסר (ברירת מחדל: 0). שקול את הפלט של
"אמיקסר scontrols", אז האינדקס הוא המספר שאחרי השם של
האלמנט.

לא שזור
אפשר פלט של פורמטים לא משולבים (אם מפענח האודיו משתמש בזה
פוּרמָט). כרגע מושבת כברירת מחדל, בגלל כמה תוספים פופולריים של ALSA
שבורים לחלוטין עם פורמטים שאינם משולבים.

ignore-chmap
אין לקרוא או להגדיר את מפת הערוצים של מכשיר ה-ALSA - רק לבקש את
המספר הנדרש של ערוצים, ולאחר מכן להעביר אליו את השמע כפי שהוא. זֶה
סביר להניח שאסור להשתמש באפשרות. זה יכול להיות שימושי עבור ניפוי באגים, או
עבור הגדרות סטטיות עם תצורת ALSA מהונדסת במיוחד (בזה
במקרה שאתה תמיד צריך לכפות את אותה פריסה עם --ערוצי אודיו, או זה
יעבוד רק עבור קבצים המשתמשים בפריסה המשתמעת למכשיר ה-ALSA שלך).

הערה:
MPlayer ו-mplayer2 דרשו ממך להחליף כל ',' ב-'.' וכל ':' עם
'=' בשם התקן ALSA. mpv לא עושה את זה יותר. במקום זאת, צטט את
שם התקן:
--ao=alsa:device=[plug:surround50]

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

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

אזהרה:
הטיפול באודיו רב-ערוצי/סראונד השתנה ב-mpv 0.8.0 מההתנהגות
ב-MPlayer/mplayer2 וגרסאות ישנות יותר של mpv.

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

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

הסיפור הקצר הוא: אם אתה רוצה אודיו רב ערוצי עם ALSA, השתמש --מכשיר אודיו
כדי לבחור את ההתקן (השתמש --audio-device=help כדי לקבל רשימה של כל המכשירים ו
שם ה-MPV שלהם).

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

oss מנהל התקן פלט אודיו OSS


מגדיר את התקן פלט השמע (ברירת מחדל: /dev/dsp).


מגדיר את התקן מערבל השמע (ברירת מחדל: /dev/mixer).


מגדיר את ערוץ מערבל השמע (ברירת מחדל: pcm). ערכים חוקיים אחרים כוללים כרך,
pcm, קו. עבור רשימה מלאה של אפשרויות חפש SOUND_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

שקע מנהל התקן פלט שמע JACK (ערכת חיבור שמע של ג'ק).

port=
מתחבר ליציאות עם השם הנתון (ברירת מחדל: יציאות פיזיות).

שם=
שם לקוח שמועבר ל-JACK (ברירת מחדל: Mpv). שימושי אם אתה רוצה
ליצור חיבורים מסוימים באופן אוטומטי.

(לא-) הפעלה אוטומטית
הפעל אוטומטית את jackd במידת הצורך (ברירת מחדל: מושבת). שימו לב שזה
נוטה להיות לא מהימן ומציף הודעות שרת.

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

std-channel-layout=waveext|כל
בחר את פריסת הערוץ הסטנדרטית (ברירת מחדל: waveext). ל-JACK עצמו אין
הרעיון של פריסות ערוצים (כלומר הקצאת הרמקול של ערוץ נתון
אמור למפות ל) - זה פשוט לוקח את כל מה שהיישום מוציא, ו
מנתב אותו מחדש לכל מה שהמשתמש מגדיר. המשמעות היא שהמשתמש וה-
האפליקציה אחראית על הטיפול בפריסת הערוץ. waveext שימושים
סדר WAVE_FORMAT_EXTENSIBLE, אשר, למרות שהוא הוגדר על ידי
Microsoft, היא הסטנדרט במערכות רבות. הערך כל גורם לג'ק לקבל
כל מה שמגיע משרשרת מסנן האודיו, ללא קשר לפריסת הערוץ ו
בלי לעשות סדר מחדש. מצב זה כנראה לא מאוד שימושי, מלבד עבור
איתור באגים או בשימוש עם הגדרות קבועות.

קוראודיו (מק OS X בלבד)
מנהל התקן פלט אודיו מקורי של Mac OS X באמצעות AudioUnits וצליל CoreAudio
שרת.

מפנה אוטומטית אל coreaudio_exclusive בעת הפעלת פורמטים דחוסים.

change-physical-format=
שנה את הפורמט הפיזי לפורמט הדומה לפורמט האודיו המבוקש
(ברירת מחדל: לא). יש לזה את היתרון שיש לפלט שמע רב-ערוצי
עובד למעשה. החיסרון הוא שזה ישנה את השמע בכל המערכת
הגדרות. זה שווה ערך לשינוי פוּרמָט הגדרה ב אודיו
התקנים דו שיח ב אודיו MIDI התקנה תוֹעֶלֶת. שימו לב שזה לא קורה
להשפיע על הגדרות הרמקולים שנבחרו.

בלעדי
השתמש בגישה בלעדית למצב. זה רק מפנה אל coreaudio_exclusive, אבל
יש להעדיף על פני שימוש ישירות ב-AO הזה.

coreaudio_exclusive (מק OS X בלבד)
מנהל התקן פלט אודיו מקורי של Mac OS X באמצעות גישה ישירה למכשיר ומצב בלעדי
(עוקף את שרת הסאונד).

פתיחה מנהל התקן פלט אודיו OpenAL ניסיוני

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

דופק מנהל התקן פלט אודיו PulseAudio

[ ][: כיור>]
ציין את המארח ואת כיור הפלט שבו יש להשתמש. ריק חוּט
משתמש בחיבור מקומי, "localhost" משתמש בהעברת רשת (סביר להניח שלא
מה אתה רוצה).

מאגר=<1-2000|מקורי>
הגדר את גודל מאגר השמע באלפיות שניות. ערך גבוה יותר מאחסן יותר נתונים,
ויש לו סבירות נמוכה יותר לחריצות חיץ. ערך קטן יותר הופך את
זרם השמע מגיב מהר יותר, למשל לשינויים במהירות ההשמעה. ברירת מחדל: 250.

חביון-פריצות=
אפשר פריצות כדי לעקוף באגים בתזמון PulseAudio (ברירת מחדל: לא). אם מופעל,
mpv יבצע חישובי חביון משוכללים בעצמו. אם מושבת, זה יהיה
השתמש במידע תזמון מעודכן אוטומטי של PulseAudio. משבית את זה
עשוי לעזור למשל עם אודיו ברשת או תוספים מסוימים, תוך הפעלתו
עשוי לעזור במצבים לא ידועים (פעם זה היה נדרש כדי להסתדר
התנהגות בגרסאות PulseAudio ישנות).

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

dsound (חלונות בלבד)
מנהל התקן פלט אודיו DirectX DirectSound

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

מכשיר=
מגדיר את מספר המכשיר לשימוש. הפעלת קובץ עם -v יציג רשימה של
מכשירים זמינים.

buffersize=
גודל מאגר DirectSound באלפיות שניות (ברירת מחדל: 200).

sdl מנהל התקן פלט שמע SDL 1.2+. אמור לעבוד על כל פלטפורמה הנתמכת על ידי SDL 1.2, אבל
עשוי לדרוש את SDL_AUDIODRIVER משתנה סביבה שיוגדר כראוי עבורו
המערכת שלך.

הערה:
דרייבר זה מיועד לתאימות עם סביבות זרות במיוחד, כגון
מערכות שבהן אף אחד מהנהגים האחרים אינו זמין.

buflen=
מגדיר את אורך מאגר השמע בשניות. משמש רק כרמז לצליל
מערכת. הפעלת קובץ עם -v יציג את המבוקש והמתקבל המדויק
גודל מאגר. ערך של 0 בוחר את ברירת המחדל של מערכת הקול.

bufcnt=
מגדיר את מספר מאגרי השמע הנוספים ב-mpv. בדרך כלל לא צריך לשנות.

ריק אינו מייצר פלט אודיו אך שומר על מהירות השמעת וידאו. להשתמש --ao=null:untimed
עבור השוואת ביצועים.

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

חיץ אורך חיץ מדומה בשניות.

התפרצות
גודל נתח מדומה בדגימות.

מְהִירוּת מהירות השמעת אודיו מדומה כמכפיל. בדרך כלל, מכשיר שמע אמיתי
לא יעבור בדיוק מהר כמו שעון המערכת. זה יחרוג רק א
מעט, והאפשרות הזו עוזרת לדמות זאת.

חֶבִיוֹן
זמן השהייה מדומה של המכשיר. זה נוסף על EOF.

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

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

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

pcm פלט שמע לכותב קבצי PCM/WAVE גולמי

(לא-) ראש גל
כלול או אל תכלול את כותרת WAVE (ברירת מחדל: כלול). מתי לא
כלול, ייווצר PCM גולמי.

file=
כתוב את הצליל ל במקום ברירת המחדל audiodump.wav. אם
ללא ראש גל מוגדר, ברירת המחדל היא audiodump.pcm.

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

צליל פלט שמע לדמון RSound

הערה:
חסר תועלת לחלוטין, אלא אם כן אתה מתכוון להפעיל את RSound. לא להתבלבל עם
RoarAudio, שזה משהו אחר לגמרי.

מארח=
הגדר את כתובת השרת (ברירת מחדל: localhost). יכול להיות גם רשת
שם מארח עבור חיבורי TCP או נתיב שקע תחום Unix המתחיל ב-'/'.

port=
הגדר את יציאת ה-TCP המשמשת לחיבור לשרת (ברירת מחדל: 12345). לֹא
משמש אם מתחבר לשקע תחום Unix.

sndio פלט שמע למערכת השמע OpenBSD sndio

הערה:
נִסיוֹנִי. ישנם באגים ובעיות ידועות.

(הערה: תומך רק בפריסות ערוצים מונו, סטריאו, 4.0, 5.1 ו-7.1.)

מכשיר=
מכשיר sndio לשימוש (ברירת מחדל: $AUDIODEVICE, שו"ת. snd0).

ווסאפי פלט שמע ל-Windows Audio Session API.

בלעדי
מבקש גישה ישירה לחומרה בלעדית. בהגדרה מונע קול
השמעה של כל תוכנית אחרת עד ליציאת mpv.

מכשיר=
משתמש בנקודת הקצה המבוקשת במקום ברירת המחדל של נקודת קצה האודיו של המערכת.
גם מספר סידורי (0,1,2,...) וגם מחרוזת GUID חוקיים; ה-GUID
מחרוזת מובטחת שלא תשתנה אלא אם כן יוסר מנהל ההתקן.

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

אפשרות זו נדחית בעיקר לטובת הכללית יותר
--מכשיר אודיו אוֹפְּצִיָה. זה נאמר, --audio-device=help ייתן רשימה של
מזהי GUID חוקיים של מכשירים (עם קידומת wasapi/), כמו גם קריא האנושי שלהם
שמות, שאמורים לעבוד כאן.

וידאו תפוקה נהגים

מנהלי התקנים של פלט וידאו הם ממשקים למתקני פלט וידאו שונים. התחביר הוא:

--vo=
ציין רשימת עדיפות של מנהלי התקנים של פלט וידאו לשימוש.

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

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

--vo-defaults=
הגדר ברירת מחדל עבור כל מנהל התקן.

הערה:
לִרְאוֹת --vo=עזרה לרשימה של מנהלי התקנים של פלט וידאו שהורכבו.

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

מנהלי התקנים זמינים של פלט וידאו הם:

xv (X11 בלבד)
משתמש בתוסף XVideo כדי לאפשר תצוגה מואצת בחומרה. זה הכי הרבה
תואם VO ב-X, אך עשוי להיות באיכות נמוכה ויש לו בעיות עם OSD וכתוביות
לְהַצִיג.

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

מתאם=
בחר מתאם XVideo ספציפי (בדוק את תוצאות xvinfo).

port=
בחר יציאת XVideo ספציפית.

ck=
בחר את המקור שממנו נלקח מקש הצבע (ברירת מחדל: cur).

תחת ברירת המחדל לוקחת את מקש הצבע המוגדר כעת ב-Xv.

להשתמש השתמש אך אל תגדיר את מקש הצבע מתוך mpv (השתמש ב- --מפתח צבעים אוֹפְּצִיָה
לשנות את זה).

סט זהה לשימוש אבל גם קובע את מפתח הצבע שסופק.

ck-method=
מגדיר את שיטת הציור של מפתח צבע (ברירת מחדל: man).

איש צייר את מקש הצבע באופן ידני (מפחית ריצוד במקרים מסוימים).

bg הגדר את מקש הצבע כרקע החלון.

המכונית תן ל-Xv לצייר את מפתח הצבע.

colorkey=
משנה את מפתח הצבע לערך RGB לבחירתך. 0x000000 הוא שחור ו
0xffffff זה לבן.

ללא מפתח צבע
משבית קביעת צבעים.

חוצצים=
מספר מאגרי תמונה לשימוש עבור מאגר הטבעת הפנימי (ברירת מחדל: 2).
הגדלת זה ישתמש יותר בזיכרון, אבל עשוי לעזור עם שרת X לא
מגיב מספיק מהר אם FPS של וידאו קרוב או גבוה מה-
להציג קצב רענון.

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

הערה:
זוהי סתירה בלבד, ואין להשתמש בה בדרך כלל.

vdpau (X11 בלבד)
משתמש בממשק VDPAU כדי להציג ואופציונלי גם לפענח וידאו. חוּמרָה
פענוח משמש עם --hwdec=vdpau.

הערה:
גרסאות קודמות של mpv (ו-MPlayer, mplayer2) סיפקו אפשרויות משנה לכוונון
עיבוד לאחר vdpau, כמו דינט, לחדד, לסרב, chroma-deint, משיכה,
hqscaling. אפשרויות המשנה הללו הוצאו משימוש, ועליכם להשתמש ב- vdpaupp
מסנן וידאו במקום זאת.

לחדד=<-1-1>
(הוצא משימוש. ראה הערה לגבי vdpaupp.)

עבור ערכים חיוביים, החל אלגוריתם חידוד על הסרטון, עבור שלילי
מעריך אלגוריתם טשטוש (ברירת מחדל: 0).

denoise=<0-1>
(הוצא משימוש. ראה הערה לגבי vdpaupp.)

החל אלגוריתם הפחתת רעש על הסרטון (ברירת מחדל: 0; ללא רעש
צִמצוּם).

deint=<-4-4>
(הוצא משימוש. ראה הערה לגבי vdpaupp.)

בחר מצב ביטול השזירה (ברירת מחדל: 0). בגרסאות ישנות יותר (כמו גם
MPlayer/mplayer2) תוכל להשתמש באפשרות זו כדי לאפשר ביטול השזירה. זֶה
לא עובד יותר, ו-deinterlacing מופעל עם אחד מה- d מפתח (על ידי
ברירת המחדל ממופה לפקודה מחזור deinterlace), או ה --deinterlace
אוֹפְּצִיָה. כמו כן, כדי לבחור את ברירת המחדל של מצב deint, עליך להשתמש במשהו
כמו --vf-defaults=vdpaupp:deint-mode=זמני במקום אפשרות המשנה הזו.

0 בחר את vdpaupp ברירת המחדל של מסנן וידאו, התואמת ל-3.

1 הצג רק את השדה הראשון.

2 בוב מבטל את השזירה.

3 ביטול השזירה הטמפורלית מותאמת לתנועה. עלול להוביל לביטול סינכרון A/V עם
חומרת וידאו איטית ו/או ברזולוציה גבוהה.

4 דה-שזירה מותאמת לתנועה עם מרחב מונחה קצוות
שִׁרבּוּב. צריך חומרת וידאו מהירה.

chroma-deint
(הוצא משימוש. ראה הערה לגבי vdpaupp.)

גורם ל-deinterlacers הזמני לפעול הן על לומה והן על chroma (ברירת מחדל). להשתמש
no-chroma-deint להשתמש אך ורק בלומה ולהאיץ את השזירה המתקדמת.
שימושי עם זיכרון וידאו איטי.

משיכה (הוצא משימוש. ראה הערה לגבי vdpaupp.)

נסה להחיל telecine הפוך, צריך תנועה אדפטיבית טמפורלית deinterlacing.

hqscaling=<0-9>
(הוצא משימוש. ראה הערה לגבי vdpaupp.)

0 השתמש בקנה מידה VDPAU ברירת מחדל (ברירת מחדל).

1-9 החל קנה מידה VDPAU באיכות גבוהה (צריך חומרה בעלת יכולת).

fps=
לעקוף את ערך קצב הרענון של התצוגה המזוהה אוטומטית (הערך נחוץ עבור
framedrop כדי לאפשר קצבי השמעת וידאו גבוהים מקצב הרענון של התצוגה,
ועבור התאמות תזמון מסגרת מודעות ל-vsync). ברירת מחדל 0 פירושו שימוש
ערך מזוהה אוטומטית. ערך חיובי מתפרש כקצב רענון בהרץ
ומעקף את הערך שזוהה אוטומטית. ערך שלילי משבית את כל התזמון
התאמה והיגיון מסגרות.

Composite-זיהוי
יישום VDPAU הנוכחי של NVIDIA מתנהג בצורה שונה במקצת תחת א
מנהל חלונות מורכב ואינו נותן תזמון מסגרת מדויק
מֵידָע. כאשר אפשרות זו מופעלת, הנגן מנסה לזהות אם א
מנהל חלונות חיבור פעיל. אם זוהה אחד, הנגן
משבית התאמות תזמון כאילו המשתמש ציין fps=-1 (כמו שהם
יהיה מבוסס על קלט שגוי). זה אומר שהתזמון הוא מעט פחות
מדויק מאשר ללא קומפוזיציה, אבל עם התנהגות מצב מורכב של
מנהל ההתקן של NVIDIA, אין הגבלת מהירות הפעלה קשה אפילו בלי
לוגיקה מושבתת. מופעל כברירת מחדל, השתמש לא-מורכב-זהה להשבית.

queuetime_windowed= ו queuetime_fs=
השתמש בפונקציונליות של תור המצגות של VDPAU כדי לעמוד בתור פריים וידאו עתידיים
משתנה לכל היותר אלפיות שנייה מראש (ברירת מחדל: 50). ראה למטה
לקבלת מידע נוסף.

output_surfaces=<2-15>
הקצו משטחי פלט רבים כל כך להצגת מסגרות וידאו (ברירת מחדל: 3). לִרְאוֹת
להלן למידע נוסף.

colorkey=<#RRGGBB|#AARRGGBB>
הגדר את צבע הרקע של תור המצגת VDPAU, שבפועל הוא
מקש צבע בשימוש אם VDPAU פועל במצב שכבת-על (ברירת מחדל: #020507, כמה
גוון שחור). אם רכיב האלפא של ערך זה הוא 0, ברירת המחדל
במקום זאת ישמש מפתח צבע VDPAU (שהוא בדרך כלל ירוק).

כוח-יוב
לעולם אל תקבל קלט RGBA. זה אומר ש-mpv יכניס מסנן להמרה ל-a
פורמט YUV לפני ה-VO. לפעמים שימושי כדי לכפות זמינות של מסוימות
תכונות YUV בלבד, כמו אקולייזר וידאו או ביטול השזירה.

שימוש בפונקציונליות התורים של מסגרת VDPAU הנשלטת על ידי אפשרויות זמן התור
הופך את תזמון היפוך המסגרת של mpv לפחות רגיש לעומס המעבד של המערכת ומאפשר ל-mpv לעשות זאת
התחל לפענח את הפריימים הבאים מעט מוקדם יותר, מה שיכול להפחית ריצוד שנגרם
על ידי מסגרות בודדות עם איטיות לפענוח. עם זאת, מנהלי ההתקן הגרפיים של NVIDIA יכולים לעשות
התנהגות אחרת של חלונות, כגון תנועות חלונות, אם VDPAU משתמש בתור ה-blit
(בעיקר קורה אם הפעלת את התוסף המרוכב) ותכונה זו היא
פָּעִיל. אם זה קורה במערכת שלך וזה מפריע לך, אתה יכול להגדיר את
ערך זמן תור ל-0 כדי להשבית תכונה זו. ההגדרות לשימוש ב-windowed ו
מצב מסך מלא נפרדים כי לא צריכה להיות סיבה להשבית את זה עבור
מצב מסך מלא (כיוון שבעיית מנהל ההתקן לא אמורה להשפיע על הסרטון עצמו).

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

direct3d_shaders (חלונות בלבד)
מנהל התקן פלט וידאו המשתמש בממשק Direct3D.

הערה:
מנהל התקן זה מיועד לתאימות עם מערכות שאינן מספקות OpenGL תקין
נהגים.

מעדיף-למתוח
השתמש IDirect3DDevice9::StretchRect על פני שיטות אחרות אם אפשר.

disable-stretchrect
לעולם אל תעבד את הסרטון באמצעות IDirect3DDevice9::StretchRect.

disable-textures
לעולם אל תעבד את הסרטון באמצעות עיבוד מרקם D3D. עיבוד עם טקסטורות
+ הצללה עדיין יורשה. לְהוֹסִיף disable-shaders להשבית לחלוטין
עיבוד וידאו עם טקסטורות.

disable-shaders
לעולם אל תשתמש בהצללות בעת עיבוד וידאו.

רק-8 ביט
לעולם אל תעבד וידאו YUV עם יותר מ-8 סיביות לכל רכיב. באמצעות הדגל הזה
יאלץ המרת תוכנה ל-8 סיביות.

disable-texture-align
בדרך כלל גדלי מרקם תמיד מיושרים ל-16. כאשר אפשרות זו מופעלת,
למרקם הסרטון יהיה תמיד אותו גודל בדיוק כמו הסרטון
עצמו.

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

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

מרקם-זיכרון=
משפיע רק על הפעולה עם הצללות/טקסטורה מופעלים, ו-(E)OSD. אפשרי
ערכים:

ברירת מחדל (ברירת מחדל)
השתמש D3DPOOL_DEFAULT, עם D3DPOOL_SYSTEMMEM מרקם לנעילה. אם
הנהג תומך D3DDEVCAPS_TEXTURESYSTEMMEMORY, D3DPOOL_SYSTEMMEM
משמש ישירות.

ברירת מחדל
השתמש D3DPOOL_DEFAULT. (כמו ברירת מחדל, אך לעולם אל תשתמש במרקם צל.)

ברירת מחדל-בריכה-צל
השתמש D3DPOOL_DEFAULT, עם D3DPOOL_SYSTEMMEM מרקם לנעילה.
(כמו ברירת מחדל, אבל תמיד לאלץ את מרקם הצל.)

הצליח
השתמש D3DPOOL_MANAGED.

לגרד
השתמש D3DPOOL_SCRATCH, עם D3DPOOL_SYSTEMMEM מרקם לנעילה.

החלפה-זרוק
השתמש D3DSWAPEFFECT_DISCARD, שעשוי להיות מהיר יותר. יכול להיות גם איטי יותר, כמו
זה חייב(?) לנקות כל פריים.

מאגר אחורי בדיוק
שנה תמיד את גודל המאגר האחורי לגודל החלון.

ישיר 3d (חלונות בלבד)
כמו direct3d_shaders, אבל עם האפשרויות disable-textures ו disable-shaders
כָּפוּי.

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

פתוח מנהל התקן פלט וידאו של OpenGL. הוא תומך בשיטות קנה מידה מורחבות, תנועות ו
ניהול צבע.

כברירת מחדל, הוא מנסה להשתמש בהגדרות מהירות ובטוחות לכישלון. השתמש בכינוי opengl-hq ל
השתמש במנהל ההתקן הזה עם ברירות מחדל מוגדרות לעיבוד באיכות גבוהה.

דורש לפחות OpenGL 2.1.

תכונות מסוימות זמינות עם מנהלי התקנים גרפיים בעלי יכולת OpenGL 3 בלבד (או אם
הרחבות נחוצות זמינות).

OpenGL ES 2.0 ו-3.0 נתמכים גם כן.

פענוח חומרה דרך OpenGL-interop נתמך במידה מסוימת. שימו לב שב
במצב זה, ייתכן שחלק מהמארזים לא יטופלו בחן, ומרחב הצבע
המרה ו-chroma upsampling הם בדרך כלל ביד מפענח החומרה
ממשקי API.

פתוח עושה שימוש ב-FBO כברירת מחדל. לפעמים אתה יכול להשיג איכות טובה יותר או
ביצועים על ידי שינוי פורמט fbo אפשרות משנה ל rgb16f, rgb32f or rgb. ידוע
הבעיות כוללות Mesa/Intel לא מקבלים rgb16, Mesa לפעמים לא הידור
עם תמיכה במרקם צף, וכמה הגדרות OS X איטיות מאוד rgb16 אבל
מהר עם rgb32f. אם יש לך בעיות, אתה יכול גם לנסות להעביר את מצב טיפש=כן
אפשרות משנה.

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

זה מיועד לחומרה שאינה תומכת ב-FBO (כולל GLES,
שתומך בו לא מספיק), או כדי להפיק ממנו עוד קצת ביצועים
חומרה גרועה או ישנה.

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

אפשרות זו עשויה להיות מוסרת בשקט בעתיד.

קנה מידה=

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

spline36
איכות ומהירות בינונית. זוהי ברירת המחדל בעת השימוש opengl-hq.

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

מסנן זה מתאים לישן lanczos3 כינוי אם רדיוס ברירת המחדל
משמש, בעוד lanczos2 מתאים לרדיוס של 2.

(מסנן זה הוא כינוי עבור כנות- מנופה כנות)

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

(מסנן זה הוא כינוי עבור ג'ינק- מנופה ג'ינק)

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

מיטשל
מיטשל-נטרוואלי. ה B ו C ניתן להגדיר פרמטרים עם scale-param1
ו scale-param2. מסנן זה טוב מאוד בהקטנת קנה מידה (ראה dscale).

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

מנהג הצללה מותאמת אישית המוגדרת על ידי המשתמש (ראה הצללת אבנית).

יש עוד כמה מסננים, אבל רובם לא כל כך שימושיים. לרשימה מלאה,
לעבור לעזור כערך, למשל:

mpv --vo=opengl:scale=help

scale-param1= , scale-param2=
הגדר פרמטרים של סינון. התעלמו אם המסנן אינו ניתן לכוונון. כַּיוֹם,
זה משפיע על פרמטרי הסינון הבאים:

bcspline
פרמטרי ספליין (B ו C). ברירת המחדל היא 0.5 עבור שניהם.

גאוסי
פרמטר קנה מידה (t). הגדלת זה הופכת את התוצאה למטושטשת יותר.
ברירת המחדל היא 1.

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

scale-blur=
גורם קנה המידה של ליבה (ידוע גם כגורם טשטוש). הקטנת זה עושה
התוצאה חדה יותר, הגדלתה הופכת אותה למטושטשת יותר (ברירת מחדל 0). אם מוגדר ל
0, נעשה שימוש בגורם הטשטוש המועדף על הליבה. שימו לב שגם הגדרה זו
נמוך (למשל 0.5) מוביל לתוצאות רעות. בדרך כלל מומלץ להיצמד
ערכים בין 0.8 ל-1.2.

scale-radius=
הגדר רדיוס עבור מסננים המפורטים להלן, חייב להיות מספר צף בין 0.5 ל-
16.0. ברירת המחדל לרדיוס המועדף של המסנן אם לא צוין.
כנות ונגזרות, ג'ינק ונגזרות, גאוסי, קופסה ו משולש

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

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

שימו לב שזה לא משפיע על המסננים המיוחדים דו -ליניארי ו bicubic_מהיר.

scale-window=
(למשתמשים מתקדמים בלבד) בחר פונקציית חלונות מותאמת אישית עבור הליבה.
ברירת המחדל לחלון המועדף של המסנן אם אינו מוגדר. להשתמש scale-window=עזרה ל
קבל רשימה של פונקציות חלונות נתמכות.

scale-wparam=
(משתמשים מתקדמים בלבד) הגדר את הפרמטר עבור פונקציית החלון שניתנה
by חלון קנה מידה. התעלמו אם החלון אינו ניתן לכוונון. נכון לעכשיו, זה
משפיע על פרמטרי החלון הבאים:

קֵיסָר פרמטר חלון (אלפא). ברירת המחדל היא 6.33.

גבר שחור
פרמטר חלון (אלפא). ברירת המחדל היא 0.16.

גאוסי
פרמטר קנה מידה (t). הגדלת זה עושה את החלון רחב יותר.
ברירת המחדל היא 1.

scaler-lut-size=<4..10>
הגדר את גודל מרקם הבדיקה עבור גרעיני scaler (ברירת מחדל: 6). ה
הגודל האמיתי של המרקם הוא 2 ^ N עבור ערך אופציה של N. אז הבדיקה
מרקם עם הגדרת ברירת המחדל משתמש ב-64 דוגמאות.

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

scaler-שינוי גודל-בלבד
השבת את ה-scaler אם תמונת הווידאו לא משתנה. במקרה הזה, דו -ליניארי
משמש במקום כל מה שמוגדר איתו סולם. Bilinear ישחזר את
תמונת מקור בצורה מושלמת אם לא מבוצע שינוי קנה מידה. שימו לב שאופציה זו
אף פעם לא משפיע cscale.

pbo אפשר שימוש ב-PBOs. זה מעט מהיר יותר, אבל לפעמים יכול להוביל לכך
שחיתות תמונה ספורדית וזמנית (בתיאוריה, כי ההעלאה מחדש אינה כזו
ניסו מחדש כאשר הוא נכשל), ואולי בעצם מפעיל נתיבים איטיים יותר עם
מנהלי התקנים שאינם תומכים ב-PBO כראוי.

dither-depth=
הגדר את עומק יעד תנועות ל-N. ברירת מחדל: לא.

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

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

8 זוהר לפלט של 8 סיביות.

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

dither-size-fruit=<2-8>
הגדר את גודל מטריצת ה-dither (ברירת מחדל: 6). הגודל האמיתי של
מטריצה ​​היא (2^N) x (2^N) עבור ערך אופציה של N, אז ערך של 6 נותן א
גודל של 64x64. המטריצה ​​נוצרת בזמן ההפעלה, ומטריצה ​​גדולה
יכול לקחת די הרבה זמן לחישוב (שניות).

משמש ב דיטר=פרי מצב בלבד.

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

זמני-דיתר
אפשר תנועות זמניות. (פעיל רק אם ניתנת תנועה מופעלת באופן כללי.)
זה משתנה בין 8 דפוסי תנועות שונות בכל מסגרת על ידי שינוי
הכיוון של מטריצת ההשתוללות המרוצפת. למרבה הצער, זה יכול להוביל
להבהב על צגי LCD, מכיוון שלאלה יש זמן תגובה גבוה.

temporal-dither-period=<1-128>
קובע באיזו תדירות מתעדכן דפוס ה-dithering מתי זמני-דיתר
בשימוש. 1 (ברירת המחדל) יתעדכן בכל פריים של וידאו, 2 בכל פריים
מסגרת אחרת וכו'.

באגים בדוק אם יש שגיאות OpenGL, כלומר התקשרות glGetError (). בקש גם ניפוי באגים OpenGL
הקשר (שלא עושה כלום עם מנהלי התקנים גרפיים נוכחיים נכון לעכשיו
כְּתִיבָה).

אינטרפולציה
הפחת גמגום הנגרם על ידי אי התאמה ב-fps של הווידאו ורענון התצוגה
שיעור (הידוע גם בשם ג'ודר).

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

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

שים לב שזה מסתמך על vsync כדי לעבוד, ראה מרווח החלפה במשך יותר
מידע.

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

שים לב שזה תלוי בתמיכה נכונה של OpenGL vsync. בחלק מהפלטפורמות ו
מנהלי התקנים, זה עובד בצורה מהימנה רק במצב מסך מלא. ייתכן גם
דורשים פריצות ספציפיות לנהג אם משתמשים במספר מסכים, כדי להבטיח mpv
מסתנכרן לימין. חיבור מנהלי חלונות יכול גם להוביל לרע
תוצאות, כמו גם מידע FPS חסר או שגוי לתצוגה (ראה
--display-fps).

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

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

tscale=
המסנן המשמש לאינטרפולציה של הציר הזמני (מסגרות). זה רק
משמש אם אינטרפולציה מופעל. הבחירות התקפות היחידות עבור tscale יש לו
מסנני קונבולציה הניתנים להפרדה (השתמש tscale=עזרה לקבל רשימה). ברירת המחדל
is מיטשל.

שימו לב שרדיוס המסנן המרבי הנתמך הוא כרגע 3, עקב
מגבלות במספר מרקמי הווידאו שניתן לטעון
בּוֹ זְמַנִית.

tscale-clamp
מהדקים את tscale לסנן את טווח הערכים של ליבת ל-[0-1]. זה מפחית
חפצי צלצול מוגזמים בתחום הטמפורלי (שמתבטאים בדרך כלל
עצמם כהבזקים קצרים או שוליים של שחור, בעיקר סביב קצוות נעים)
בתמורה להוספת עוד טשטוש.

dscale-radius, cscale-radius, רדיוס tscale, וכו '
הגדר פרמטרי סינון עבור dscale, cscale ו tscale, בהתאמה.

ראה את האפשרויות המתאימות עבור סולם.

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

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

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

קנה מידה קדם=
אפשרות זו מספקת מסננים שאינם מבוססי-קונבולוציה לשינוי קנה מידה. אלה
מסננים משנים את גודל הסרטון לכפולות מהגודל המקורי (כולם כרגע
Prescalers נתמכים יכולים לבצע הכפלת תמונה רק במעבר בודד).
בדרך כלל יופעל מסנן אחר המבוסס על קונבולציה (הסולם הראשי).
לאחר ה-prescaler כדי להתאים את גודל התצוגה היעד.

אף לא אחד השבת את כל ה-prescalers. זוהי ברירת המחדל.

superxbr
Prescaler מהיר יחסית שפותח במקור לאמנות פיקסלים.

ניתן לכוון עם כמה פרמטרים superxbr-חדות ו
superxbr-edge-power אפשרויות.

nnedi3 Deinterlacer מבוסס רשת עצבית מלאכותית, שניתן להשתמש בו
תמונות יוקרתיות.

איטי במיוחד ודורש כרטיס גרפי בינוני או גבוה עדכני כדי
לעבוד בצורה חלקה (נכון ל-2015).

שימו לב שכל המסננים שלמעלה מתוכננים (או מיושמים) לעיבוד
מטוס luma בלבד וכנראה לא יעבוד כמתוכנן עבור וידאו בפורמט RGB.

prescale-passes=<1..5>
מספר המעברים להחלת ה-prescaler (ברירת המחדל היא 1). מגדיר את זה
ל-2 יבצע שינוי קנה מידה פי 4.

prescale-downscaling-threshold=<0..32>
אפשרות זו מונעת שימוש "מוגזם" ב-prescaleers, שעלול להיגרם על ידי
תצורה שגויה, או שמשתמש מנסה להפעיל סרטון בגודל גדול בהרבה. עם
אפשרות זו, המשתמש יכול לציין את יחס ההורדה המרבי המותר בשניהם
מֵמַד. כדי לספק את זה, מספר המעברים ל-prescaler יהיה
מופחת, ובמידת הצורך ניתן גם להשבית את ה-prescaler.

ערך ברירת המחדל הוא 2.0, ואמור להיות מסוגל למנוע ככל הנראה
שימוש בלתי סביר ב-prescalers. רוב המשתמשים כנראה ירצו להגדיר אותו ל-a
ערך קטן יותר בין 1.0 ל-1.5 לביצועים טובים יותר.

ערך נמוך מ-1.0 ישבית את ההמחאה.

nnedi3-neurons=<16|32|64|128>
ציין את הנוירונים עבור nnedi3 prescaling (ברירת המחדל היא 32). העיבוד
הזמן צפוי להיות ליניארי למספר הנוירונים.

nnedi3-window=<8x4|8x6>
ציין את גודל החלון המקומי לדגימה ב-nnedi3 קנה מידה מראש (ברירות מחדל
להיות 8x4). 8x6 חלון מייצר תמונות חדות יותר, אך הוא גם איטי יותר.

nnedi3-upload=
ציין כיצד להעלות את משקלי NN ל-GPU. תלוי בכרטיס המסך,
מנהל התקן, מהדר shader והגדרות nnedi3, שתי השיטות יכולות להיות מהירות יותר או
איטי יותר.

ubo העלה משקלים אלה באמצעות אובייקטי חיץ אחידים. זוהי ברירת המחדל.
(דורש OpenGL 3.1 / GLES 3.0)

shader קוד קשיח את כל המשקולות לקוד המקור של הצללה. (דורש
OpenGL 3.3 / GLES 3.0)

pre-shaders= , post-shaders= , scale-shader=
הצללות מקטעי GLSL מותאמות אישית.

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

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

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

קבצים אלה חייבים להגדיר פונקציה עם החתימה הבאה:

vec4 sample(sampler2D tex, vec2 pos, vec2 tex_size)

המשמעויות של הפרמטרים הן כדלקמן:

sampler2D טקס
מרקם המקור של הצללה.

vec2 להציב
המיקום לדגימה, ברווח קואורדינטות [0-1].

vec2 tex_size
גודל המרקם, בפיקסלים. זה עשוי להיות שונה מ-image_size,
לְמָשָׁל. עבור תוכן בדגימת משנה או עבור פוסט-shaders.

בנוסף לפרמטרים אלה, המדים הבאים הם גם גלובליים
זמין:

לצוף אקראי
מספר אקראי בטווח [0-1], שונה לכל מסגרת.

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

vec2 גודל תמונה
הגודל בפיקסלים של תמונת הקלט.

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

vec4 sample(sampler2D tex, vec2 pos, vec2 tex_size)
{
vec4 color = texture(tex, pos);
return vec4(1.0 - color.rgb, color.a);
}

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

deband-iterations=<1..16>
מספר שלבי ביטול הרצועה לביצוע לכל דגימה. כל שלב מקטין קצת
יותר פסים, אבל לוקח זמן לחשב. שימו לב שהחוזק של כל צעד
נופל מהר מאוד, כך שמספרים גבוהים (>4) הם כמעט חסרי תועלת.
(ברירת מחדל 1)

deband-threshold=<0..4096>
סף הניתוק של הפילטר. מספרים גבוהים יותר מגדילים את
פירוק כוח באופן דרמטי אך מפחית בהדרגה את פרטי התמונה.
(ברירת מחדל 64)

deband-range=<1..64>
הרדיוס ההתחלתי של מסנן ביטול הרצועה. הרדיוס גדל באופן ליניארי עבור
כל איטרציה. רדיוס גבוה יותר ימצא יותר שיפועים, אבל רדיוס נמוך יותר
יחליק בצורה אגרסיבית יותר. (ברירת מחדל 16)

אם תגדיל את דיבנד-איטרציות, אתה כנראה צריך להפחית את זה ל
לפצות.

deband-grain=<0..4096>
הוסף קצת רעש נוסף לתמונה. זה עוזר באופן משמעותי לכסות
שאר חפצי הקוונטיזציה. מספרים גבוהים יותר מוסיפים יותר רעש. (בְּרִירַת מֶחדָל
48)

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

סיגמואיד-מרכז
מרכז עקומת הסיגמואיד המשמשת הגדלה של סיגמואיד, חייב להיות צף
בין 0.0 ל-1.0. ברירת המחדל היא 0.75 אם לא צוין.

סיגמואיד-שיפוע
השיפוע של עקומת הסיגמואידית המשמשת הגדלה של סיגמואיד, חייב להיות צף
בין 1.0 ל-20.0. ברירת המחדל היא 6.5 אם לא צוין.

לחדד=
אם מוגדר לערך שאינו 0, הפעל מסנן מיסוך לא חד. חִיוּבִי
ערכים יחדדו את התמונה (אך יוסיפו עוד צלצולים וכינויים). שלילי
ערכים יטשטשו את התמונה. אם ה-GPU שלך חזק מספיק, שקול
חלופות כמו ה ewa_lanczossharp מסנן אבנית, או ה טשטוש קנה מידה
אפשרות משנה.

(תכונה זו היא התחליף לישן לחדד 3 ו לחדד 5 scalers.)

glfinish
שִׂיחָה glFinish() לפני ואחרי החלפת מאגרים (ברירת מחדל: מושבת).
איטי יותר, אבל עשוי לעזור להשיג תוצאות טובות יותר בעת ביצוע פריימים. פחית
להרוס לחלוטין את הביצועים. הפרטים תלויים לחלוטין ב-OpenGL
נהג.

waitvsync
שִׂיחָה glXWaitVideoSyncSGI לאחר כל החלפת מאגר (ברירת מחדל: מושבת). זֶה
עשוי לעזור או לא לעזור עם דיוק תזמון הווידאו וירידה בפריים. זה אפשרי
שזה הופך את פלט הווידאו לאט יותר, או שאין לו השפעה כלל.

X11/GLX בלבד.

vsync-fences=
סנכרן את ה-CPU למסגרת העבר ה-N באמצעות ה- GL_ARB_sync סיומת. א
ערך 0 משבית התנהגות זו (ברירת מחדל). ערך של 1 אומר שכן
לסנכרן למסגרת הנוכחית לאחר רינדו. כמו glfinish ו
waitvsync, זה יכול להפחית או להרוס את הביצועים. היתרון שלו הוא שהוא יכול
משתרע על מספר מסגרות, ומגבילים למעשה את מספר הפריימים של ה-GPU
תורים קדימה (שגם לו יש השפעה על vsync).

dwmflush=
שיחות DwmFlush לאחר החלפת מאגרים ב-Windows (ברירת מחדל: אוטומטי). זה גם
סטים SwapInterval(0) כדי להתעלם מתזמון OpenGL. הערכים הם: לא (מושבת),
חלונות (רק במצב חלונות), כן (גם במסך מלא).

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

זה עשוי לעזור לקבל מרווחי פריימים עקביים יותר, במיוחד עם
קטעי פריימים גבוהים לשנייה - מה שעשוי גם להפחית פריימים שנפלו. בדרך כלל ערך
of חלון אמור להספיק מכיוון שהמסך המלא עשוי לעקוף את ה-DWM.

חלונות בלבד.

sw המשך גם אם זוהה מעבד תוכנה.

backend=
הערך המכונית (ברירת המחדל) בוחר את הקצה האחורי של החלונות. אתה יכול גם
לעבור לעזור כדי לקבל רשימה מלאה של הידור ב-backends (ממוינים לפי
סדר בדיקה אוטומטי).

המכונית בחירה אוטומטית (ברירת מחדל)

קקאו קקאו/OS X

לנצח Win32/WGL

זָוִית Direct3D11 דרך שכבת התרגום של OpenGL ES ANGLE. זֶה
תומך כמעט בכל לנצח הקצה האחורי עושה זאת, מלבד פרופילי ICC,
קלט וידאו בעומק סיביות גבוה, וה nnedi3 קדם-סקאלר.

dxinterop (נִסיוֹנִי)
Win32, באמצעות WGL לעיבוד ו-Direct3D 9Ex להצגה.
עובד על Nvidia ו-AMD בלבד.

x11 X11/GLX

דרך ארץ
Wayland/EGL

drm-egl
DRM/EGL

x11egl X11/EGL

es=
בחר אם להשתמש ב-GLES:

כן נסה להעדיף ES על פני Desktop GL

לא נסה להעדיף GL שולחני על פני ES

המכונית השתמש בברירת המחדל עבור כל backend (ברירת מחדל)

fbo-format=
בוחר את הפורמט הפנימי של המרקמים המשמשים עבור FBOs. הפורמט יכול
להשפיע על הביצועים והאיכות של פלט הווידאו. fmt יכול להיות אחד מ:
rgb, rgba, rgb8, rgb10, rgb10_a2, rgb16, rgb16f, rgb32f, rgba12, rgba16,
rgba16f, rgba32f. בְּרִירַת מֶחדָל: המכונית, אשר ממפה ל-rgba16 בשולחן העבודה GL, ו
rgb10_a2 ב-GLES (למשל ANGLE).

gamma=<0.1..2.0>
הגדר ערך גמא (ברירת מחדל: 1.0). אם הגמא מותאמת בדרכים אחרות (כמו
עם --גמא כריכות אופציות או מפתחות ואת גמא נכס), הערך
מוכפל בערך הגמא האחר.

ערכים מומלצים המבוססים על בהירות הסביבה:

1.0 מואר בעוצמה (ברירת מחדל)

0.9 מעט עמום

0.8 חדר שחור כהה

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

עם עוצמת הארה סביבתית של 64lux, mpv יבחר את ערך הגמא 1.0 (לא
להגביר), ולהגדיל מעט את הבוסט עד ל-0.8 עבור 16lux.

הערה: מיושם רק ב-OS X.

target-prim=
מציין את הפריימריז של התצוגה. צבעי וידאו יותאמו לכך
מרחב צבע במידת הצורך. ערכים חוקיים הם:

המכונית השבת כל התאמה (ברירת מחדל)

bt.470 מ'
ITU-R BT.470 M

bt.601-525
ITU-R BT.601 (מערכות SD של 525 שורות, למשל NTSC), SMPTE 170M/240M

bt.601-625
ITU-R BT.601 (מערכות SD עם 625 שורות, למשל PAL/SECAM), ITU-R BT.470 B/G

bt.709 ITU-R BT.709 (HD), IEC 61966-2-4 (sRGB), SMPTE RP177 נספח B

bt.2020
ITU-R BT.2020 (UHD)

תפוח Apple RGB

Adobe AdobeRGB (1998)

פרופוטו
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB (לא להתבלבל עם CIE XYZ)

target-trc=
מציין את מאפייני ההעברה (גמא) של התצוגה. צבעי וידאו
יותאם לעקומה זו. ערכים חוקיים הם:

המכונית השבת כל התאמה (ברירת מחדל)

bt.1886
עקומת ITU-R BT.1886, ללא ירידת בהירות (כ-1.961)

srgb IEC 61966-2-4 (sRGB)

קווים תפוקת אור ליניארית

gamma1.8
עקומת כוח טהורה (גמא 1.8), משמשת גם עבור Apple RGB

gamma2.2
עקומת כוח טהורה (גמא 2.2)

gamma2.8
עקומת כוח טהורה (גמא 2.8), משמשת גם עבור BT.470-BG

פרופוטו
ProPhoto RGB (ROMM)

icc-profile=
טען פרופיל ICC והשתמש בו כדי להפוך RGB ליניארי לפלט מסך.
זקוק לתמיכה של LittleCMS 2. אפשרות זו עוקפת את
target-prim, target-trc ו icc-profile-auto אפשרויות.

icc-profile-auto
בחר אוטומטית את פרופיל התצוגה של ICC המצוין כעת על ידי
הגדרות תצוגה של מערכת ההפעלה.

הערה: ב-Windows, פרופיל ברירת המחדל חייב להיות פרופיל ICC. פרופילי WCS
אינם נתמכים.

icc-cache-dir=
אחסן וטען את 3D LUTs שנוצרו מפרופיל ICC בספרייה זו.
זה יכול לשמש כדי להאיץ את הטעינה, שכן LittleCMS 2 יכול לקחת זמן
ליצור LUT 3D. שים לב שקבצים אלה מכילים LUTs לא דחוסים. שֶׁלָהֶם
הגודל תלוי ב בגודל 3dlut, ויכול להיות גדול מאוד.

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

icc-intent=
מציין את כוונת ה-ICC המשמשת לשינוי הצבע (בעת שימוש
פרופיל icc).

0 תְפִיסָתִי

1 קולורימטרי יחסי (ברירת מחדל)

2 רווי

3 קולורימטרי מוחלט

3dlut-size= איקס איקס
גודל של LUT 3D שנוצר מפרופיל ICC בכל מימד.
ברירת המחדל היא 128x256x64. הגדלים חייבים להיות בחזקת שתיים, ולכל היותר 512.

blend-subtitles=
מערבבים כתוביות ישירות על גבי מסגרות וידאו משודרגות, לפני אינטרפולציה
ו/או ניהול צבע (ברירת מחדל: לא). הפעלת זה גורם לכתוביות להיות
מושפע מ פרופיל icc, target-prim, target-trc, אינטרפולציה, גמא ו
פוסט-הצללה. זה גם מגביר את ביצועי הכתוביות בעת השימוש
אינטרפולציה.

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

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

אזהרה:
זה משנה את אופן הטיפול בצבעי כתוביות. בדרך כלל, כתוביות
ההנחה היא שהצבעים נמצאים ב-sRGB והצבע מנוהל ככזה. מאפשר זאת
גורם להתייחס אליהם כאילו הם נמצאים במרחב הצבעים של הסרטון במקום זאת. זה
טוב אם אתה רוצה שדברים כמו שלטי ASS softsubbed יתאימו לסרטון
צבעים, אך עלול לגרום לכתוביות SRT או דומות להיראות מעט כבויות.

אלפא=
מחליט מה לעשות אם לקלט יש רכיב אלפא (ברירת מחדל: blend).

להתמזג ערבבו את המסגרת על רקע שחור.

כן נסה ליצור framebuffer עם רכיב אלפא. זה רק עושה
לחוש אם הסרטון מכיל מידע אלפא (שהוא מאוד
נָדִיר). ייתכן שלא תהיה תמיכה בכל הפלטפורמות. אם אלפא framebuffers
אינם זמינים, הוא נופל בשקט על מאגר מסגרת רגיל. פתק
שאם תגדיר את פורמט fbo אפשרות לערך שאינו ברירת מחדל, א
יש לציין פורמט עם אלפא, אחרת זה לא יעבוד.

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

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

רקע=
צבע המשמש לציור חלקים מחלון mpv שאינם מכוסים על ידי וידאו. לִרְאוֹת
--osd-color אפשרות כיצד מגדירים צבעים.

opengl-hq
כמו פתוח, אך עם הגדרות ברירת מחדל לעיבוד באיכות גבוהה.

זה שווה ל:

--vo=opengl:scale=spline36:cscale=spline36:dscale=mitchell:dither-depth=auto:correct-downscaling:sigmoid-upscaling:pbo:deband:es=no

שים לב שכמה מסכי LCD זולים יותר עושים תנודות שמפריעות מאוד פתוח's
דיבור. השבתת דיבור עם dither-depth=לא עוזר.

sdl מנהל התקן פלט וידאו SDL 2.0+ Render, תלוי במערכת עם או בלי חומרה
תְאוּצָה. אמור לעבוד בכל הפלטפורמות הנתמכות על ידי SDL 2.0. לכוונון, עיין
לעותק שלך של הקובץ SDL_hints.h.

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

sw המשך גם אם זוהה מעבד תוכנה.

להחליף מצב
הורה ל-SDL להחליף את מצב הווידאו של הצג בעת מעבר למסך מלא.

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

הערה:
דרייבר זה מיועד לתאימות עם מערכות מחורבנות. אתה יכול להשתמש בחומרת vaapi
פענוח עם --vo=opengl מדי.

קנה מידה =

ברירת מחדל
ברירת המחדל של מנהל ההתקן (גם ברירת המחדל של mpv).

מָהִיר מהיר, אבל באיכות נמוכה.

hq קנה מידה לא מוגדר תלוי נהג באיכות גבוהה, איטי.

Nthe לֹא קָוִי אנמורפי דרוג

deint-mode=
בחר אלגוריתם ביטול השזירה. שים לב שבברירת מחדל, דה-שזירה היא
בהתחלה תמיד כבוי, וצריך להפעיל אותו עם d מפתח (מקש ברירת מחדל
מחייב עבור מחזור deinterlace).

אפשרות זו אינה חלה אם libva תומכת בעיבוד פוסט וידאו (vpp). ב
במקרה זה, ברירת המחדל עבור deint-mode is לא, ואפשר ביטול השזירה באמצעות
אינטראקציה של משתמש בשיטות שהוזכרו לעיל למעשה מכניסה את ה
vavpp מסנן וידאו. אם vpp לא נתמך בפועל עם הקצה האחורי של libva
בשימוש, אתה יכול להשתמש באפשרות זו כדי לאפשר בכוח דה-שזירה מבוסס VO.

לא אל תאפשר deinterlacing (ברירת מחדל עבור libva חדש יותר).

שדה ראשון
הצג רק את השדה הראשון (עובר --דומיננטיות בשדה).

שילינג bob deinterlacing (ברירת מחדל עבור libva ישנה יותר).

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

ריק לא מייצר פלט וידאו. שימושי להשוואה.

בדרך כלל, עדיף להשבית וידאו עם --אין סרטון במקום.

fps=
הדמיית FPS לתצוגה. זה מגביל באופן מלאכותי את מספר הפריימים של ה-VO
מקבל לשנייה.

הקקה מנהל התקן פלט וידאו אמנותי בצבע ASCII שעובד על קונסולת טקסט.

הערה:
הנהג הזה הוא בדיחה.

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

format=
בחר את פורמט קובץ התמונה.

jpg קבצי JPEG, סיומת .jpg. (בְּרִירַת מֶחדָל.)

jpeg קבצי JPEG, סיומת .jpeg.

png קבצי PNG.

עמודים לדקה פורמט מפת סיביות ניידת.

Pgm פורמט גריי מפה נייד.

pgmyuv פורמט גריי מפה נייד, בפורמט YV12 פיקסלים.

Tga Truevision TGA.

png-compression=<0-9>
מקדם דחיסה של PNG (שינוי מהירות לעומת גודל קובץ) (ברירת מחדל: 7)

png-filter=<0-5>
מסנן הוחל לפני דחיסת PNG (0 = אין; 1 = תת; 2 = למעלה; 3 =
מְמוּצָע; 4 = Paeth; 5 = מעורב) (ברירת מחדל: 5)

איכות jpeg=<0-100>
מקדם איכות JPEG (ברירת מחדל: 90)

(לא-)jpeg-פרוגרסיבי
ציין JPEG סטנדרטי או פרוגרסיבי (ברירת מחדל: לא).

(לא-) jpeg-baseline
ציין שימוש בקו הבסיס של JPEG או לא (ברירת מחדל: כן).

jpeg-optimize=<0-100>
מקדם אופטימיזציה של JPEG (ברירת מחדל: 100)

jpeg-smooth=<0-100>
גורם חלק (ברירת מחדל: 0)

jpeg-dpi=<1->
JPEG DPI (ברירת מחדל: 72)

outdir=
ציין את הספרייה שבה יש לשמור את קבצי התמונה (ברירת מחדל: ./).

דרך ארץ (וויילנד בלבד)
Wayland שיתפה פלט וידאו בזיכרון כחלופה עבור פתוח.

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

אלפא השתמש בפורמט חיץ התומך בסרטונים ותמונות עם מידע אלפא

rgb565 השתמש ב-RGB565 כפורמט חיץ. פורמט זה מיושם ברוב הפלטפורמות,
במיוחד ב-Embedde שבו הוא הרבה יותר יעיל מאשר RGB8888.

חציצה משולשת
השתמש ב-3 מאגרים במקום 2. זה יכול להוביל להשמעה זורמת יותר, אבל שימושים
יותר זיכרון.

opengl-cb
לשימוש עם הטבעת OpenGL ישירה של libmpv; חסר תועלת בכל הקשר אחר. (לִרְאוֹת
.)

זה גם תומך ברבות מאפשרויות המשנה של פתוח ל-VO יש. לָרוּץ Mpv
--vo=opengl-cb:help לרשימה.

זה תומך גם ב- vo_cmdline פקודה.

rpi (פֶּטֶל פאי)
פלט וידאו מקורי ב-Raspberry Pi באמצעות MMAL API.

display=
בחר את מספר התצוגה שעליו יש להציג את שכבת הווידאו
(ברירת מחדל: 0).

שכבה=
בחר את שכבת ה-Dispmanx שעליה יש להציג את שכבת הווידאו
(ברירת מחדל: -10). שימו לב ש-mpv ישתמש גם ב-2 השכבות שמעל לבחירה
שכבה, כדי לטפל ברקע החלון וב-OSD. עיבוד וידאו בפועל יהיה
להתרחש בשכבה שמעל השכבה שנבחרה.

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

osd=
מופעל כברירת מחדל. אם מושבת עם לא, לא נוצרה שכבת OSD. גם זה
פירושו שלא יוצגו כתוביות.

DRM (ישיר טיוח מנהל)
מנהל התקן פלט וידאו באמצעות הגדרת מצב ליבה / מנהל רינדור ישיר. צריך
לשמש כאשר לא רוצים להתקין סביבה גרפית מלאה (למשל לא
איקס). לא תומך בהאצת חומרה (אם אתה צריך את זה, בדוק את drm-egl
אחורי עבור פתוח VO).

מחבר=
בחר את המחבר לשימוש (בדרך כלל זהו צג.) אם מוגדר ל-1, mpv
מציג את הפלט במחבר הזמין הראשון. (ברירת מחדל: -1)

devpath=
נתיב להתקן כרטיס גרפי. (ברירת מחדל: /dev/dri/card0)

מצב=
מזהה מצב לשימוש (רזולוציה, עומק סיביות וקצב פריימים). (ברירת מחדל: 0)

שמע מסננים

מסנני אודיו מאפשרים לך לשנות את זרם האודיו ואת המאפיינים שלו. התחביר הוא:

--af=
הגדר שרשרת של מסנני אודיו.

הערה:
כדי לקבל רשימה מלאה של מסנני אודיו זמינים, ראה --af=עזרה.

כמו כן, זכור שרוב המסננים בפועל זמינים דרך lavfi עטיפה, אשר
נותן לך גישה לרוב המסננים של libavfilter. זה כולל את כל המסננים שיש להם
הועבר מ-MPlayer ל-libavfilter.

אתה יכול גם להגדיר ברירת מחדל עבור כל מסנן. ברירת המחדל מוחלת לפני הרגיל
פרמטרי סינון.

--af-defaults=
הגדר ברירת מחדל עבור כל מסנן.

מסנני אודיו מנוהלים ברשימות. ישנן מספר פקודות לניהול רשימת הסינון:

--af-add=
מוסיף את המסננים שניתנו כארגומנטים לרשימת המסננים.

--af-pre=
מקדים את המסננים שניתנו כארגומנטים לרשימת המסננים.

--af-del=
מוחק את המסננים באינדקסים הנתונים. מספרי אינדקס מתחילים ב-0, שלילי
המספרים מתייחסים לסוף הרשימה (-1 הוא האחרון).

--af-clr
מרוקן לחלוטין את רשימת הסינון.

המסננים הזמינים הם:

lavrresample[=option1:option2:...]
מסנן זה משתמש ב-libavresample (או libswresample, בהתאם למבנה) כדי לשנות
קצב דגימה, פורמט דגימה או פריסת ערוץ של זרם האודיו. המסנן הזה הוא
מופעל אוטומטית אם פלט השמע אינו תומך בתצורת השמע
של הקובץ המושמע.

הוא תומך רק בפורמטים הבאים לדוגמה: u8, s16, s32, float.

גודל מסנן=
אורך המסנן ביחס לקצב הדגימה הנמוך יותר. (ברירת מחדל: 16)

היסט-פאזה=
Log2 של מספר הכניסות הפוליפאזיות. (..., 10->1024, 11->2048, 12->4096,
...) (ברירת מחדל: 10->1024)

cutoff=
תדר חיתוך (0.0-1.0), מוגדר כברירת מחדל בהתאם לאורך המסנן.

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

ללא ניתוק
אין לנתק אם פורמט/קצב/ערוצי הקלט והפלט תואמים. (אם אתה
רק רוצה להגדיר ברירת מחדל עבור המסנן הזה שישמש אפילו על ידי
הוכנסו אוטומטית מופעי lavrresample, אתה צריך להעדיף הגדרה
אותם עם --af-defaults=lavrresample:....)

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

o=
הגדר AVOptions ב-SwrContext או AVAudioResampleContext. אלה צריכים להיות
מתועד על ידי FFmpeg או Libav.

lavcac3enc[=tospdif[:bitrate[:minch]]]
קידוד אודיו רב-ערוצי ל-AC-3 בזמן ריצה באמצעות libavcodec. תומך ב-16 סיביות
פורמט קלט מקורי, מקסימום 6 ערוצים. הפלט הוא ביג אנדיאן כאשר
פלט זרם AC-3 גולמי, native-endian בעת פלט ל-S/PDIF. אם הקלט
קצב הדגימה אינו 48 קילו-הרץ, 44.1 קילו-הרץ או 32 קילו-הרץ, הוא יידגום מחדש ל-48 קילו-הרץ.

tospdif=
פלט זרם AC-3 גולמי אם לא, פלט ל-S/PDIF להעברת אם כן
(בְּרִירַת מֶחדָל).

קצב סיביות=
השימוש בקצב הסיביות עבור זרם AC-3. הגדר אותו ל-384 כדי לקבל 384 kbps.

ברירת המחדל היא 640. ייתכן שמקלטים מסוימים לא יוכלו להתמודד עם זה.

ערכים חוקיים: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384, 448, 512, 576, 640.

הערך המיוחד המכונית בוחר ברירת מחדל של קצב סיביות המבוסס על ערוץ הקלט
מספר:

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

מינץ'=
אם מספר ערוץ הקלט קטן מ , המסנן יתנתק
עצמו (ברירת מחדל: 3).

אקולייזר=g1:g2:g3:...:g10
אקולייזר גרפי של 10 פס אוקטבות, מיושם באמצעות 10 מסנני פס-פס IIR. זֶה
פירושו שהוא עובד ללא קשר לסוג האודיו המושמע. ה
תדרי מרכז עבור 10 הלהקות הם:

┌────┬────────────┐
│ לא. │ תדירות │
├────┼────────────┤
│0 │ 31.25 הרץ │
├────┼────────────┤
│1 │ 62.50 הרץ │
├────┼────────────┤
│2 │ 125.00 הרץ │
├────┼────────────┤
│3 │ 250.00 הרץ │
├────┼────────────┤
│4 │ 500.00 הרץ │
├────┼────────────┤
│5 │ 1.00 קילוהרץ │
├────┼────────────┤
│6 │ 2.00 קילוהרץ │
├────┼────────────┤
│7 │ 4.00 קילוהרץ │
├────┼────────────┤
│8 │ 8.00 קילוהרץ │
├────┼────────────┤
│9 │ 16.00 קילוהרץ │
└────┴────────────┘

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

: : :...:
מספרי נקודה צפה המייצגים את ההגבר ב-dB עבור כל פס תדרים
(-12-12)

דוגמה

Mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi
יגביר את הצליל באזור התדר העליון והתחתון בזמן
מבטל אותו כמעט לחלוטין בסביבות 1 kHz.

channels=nch[:routes]
יכול לשמש להוספה, הסרה, ניתוב והעתקה של ערוצי שמע. אם רק
נתון, נעשה שימוש בניתוב ברירת המחדל. זה עובד באופן הבא: אם מספר הפלט
הערוצים גדול ממספר ערוצי הקלט, מוכנסים ערוצים ריקים
(למעט בעת מיקס ממונו לסטריאו; אז ערוץ המונו משוכפל). אם
מספר ערוצי הפלט קטן ממספר ערוצי הקלט, ה
הערוצים החורגים מקוצרים.

מספר ערוצי פלט (1-8)


רשימה של , מסלולים מופרדים, בצורה מ1-ל-1, מ-2-ל-2,.... כל זוג
מגדיר לאן לנתב כל ערוץ. יכולים להיות לכל היותר 8 מסלולים. לְלֹא
ארגומנט זה, נעשה שימוש בניתוב ברירת המחדל. מאז , משמש גם להפרדה
מסננים, אתה חייב לצטט את הטיעון הזה [...] או דומה.

דוגמאות

Mpv --af=channels=4:[0-1,1-0,2-2,3-3] media.avi
ישנה את מספר הערוצים ל-4 ויגדיר 4 מסלולים שמחליפים
ערוץ 0 וערוץ 1 והשאיר את ערוץ 2 ו-3 ללא פגע. שימו לב לזה
אם הושמעה מדיה המכילה שני ערוצים, הערוצים 2 ו-3 יעשו זאת
מכילים שתיקה אבל 0 ו-1 עדיין יוחלפו.

Mpv --af=channels=6:[0-0,0-1,0-2,0-3] media.avi
ישנה את מספר הערוצים ל-6 ויגדיר 4 מסלולים שמעתיקים
ערוץ 0 עד ערוצים 0 עד 3. ערוץ 4 ו-5 יכיל שקט.

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

format=format:srate:channels:out-format:out-srate:out-channels
לא מבצע המרת פורמט בעצמו. במקום זאת, זה עלול לגרום למערכת הסינון
הכנס את מסנני ההמרה הדרושים לפני או אחרי מסנן זה במידת הצורך. זה
שימושי בעיקר לשליטה בפורמט האודיו שנכנס למסננים אחרים. ל
ציין את הפורמט עבור פלט אודיו, ראה --פורמט אודיו, ---audio-samplerate, ו
--ערוצי אודיו. מסנן זה מסוגל לאלץ פורמט מסוים, ואילו
--שֶׁמַע-* עשוי להיות עוקף על ידי ao בהתבסס על תאימות פלט.

כל הפרמטרים הם אופציונליים. 3 הפרמטרים הראשונים מגבילים את המסנן
מקבל כקלט. לכן הם יגרמו להכנסת מסנני המרה
לפני זה. ה הַחוּצָה- פרמטרים אומרים את המסננים או יציאות האודיו הבאות
מסנן זה כיצד לפרש את הנתונים מבלי לבצע המרה בפועל. הגדרה
אלה כנראה פשוט ישברו דברים אלא אם כן אתה באמת יודע שאתה רוצה את זה עבור חלק
סיבה, כגון בדיקה או התמודדות עם מדיה שבורה.


כפה המרה לפורמט זה. להשתמש --af=פורמט=פורמט=עזרה לקבל רשימה
של פורמטים חוקיים.


כפה המרה לקצב דגימה ספציפי. השיעור הוא מספר שלם, 48000
למשל.


כפה ערבוב לפריסת ערוץ ספציפית. לִרְאוֹת --ערוצי אודיו אפשרות עבור
ערכים אפשריים.







הערה: פעם היה שם למסנן הזה כּוֹחַ. הישן פוּרמָט מסנן נהג לעשות
ההמרה עצמה, שלא כמו זו המאפשרת למערכת הסינון לטפל ב
המרה.

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

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


מגדיר את ההגבר הרצוי ב-dB עבור כל הערוצים בזרם מ-200 dB עד
+60 dB, כאשר -200 dB משתיק את הצליל לחלוטין ו-+60 dB שווה רווח של
1000 (ברירת מחדל: 0).

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

replaygain-אלבום
כמו replaygain-track, אבל להשתמש בערך ה-gain של האלבום במקום זאת.

replaygain-preamp
רווח קדם-הגברה ב-dB להחלה על רווח ההשמעה החוזרת שנבחרה
(ברירת מחדל: 0).

replaygain-clip=yes|לא
מנע גזירה שנגרמה מ-replaygain על-ידי הורדת ה-gain אוטומטית
(בְּרִירַת מֶחדָל). להשתמש replaygain-clip=לא כדי להשבית את זה.

replaygain-fallback
רווח ב-dB כדי להחיל אם לקובץ אין תגי רווח של הפעלה חוזרת. אפשרות זו היא
מיושם תמיד אם היגיון ההשמעה החוזר אינו פעיל איכשהו. אם זה
הוחל, לא מופעלות אפשרויות אחרות של הפעלה חוזרת.

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

אזהרה: תכונה זו יוצרת עיוות ויש להתייחס אליה כאחרונה
אתר נופש.

s16 כפה פורמט דגימה של S16 אם מוגדר. איכות נמוכה יותר, אך עשויה להיות מהירה יותר בחלקם
מצבים.

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

דוגמה

Mpv --af=נפח=10.1 media.avi
יגביר את הסאונד ב-10.1 dB ו-hard-clip אם רמת הקול היא
גבוה מדי.

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

מספר ערוצי פלט (1-8).


רשימת ערכים [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...], שם
כל אלמנט ליג פירושו כמה מערוץ הקלט i מעורבב בפלט
ערוץ j (טווח 0-1). אז באופן עקרוני יש לך קודם כל n מספרים שאומרים מה
קשור לערוץ הקלט הראשון, ולאחר מכן n מספרים הפועלים על השני
ערוץ קלט וכו'. אם לא תציין מספרים עבור קלט כלשהו
ערוצים, ההנחה היא 0. שימו לב שהערכים מופרדים ב ,, שהוא
כבר בשימוש על ידי מנתח האפשרויות להפרדת מסננים. זו הסיבה שאתה חייב
לצטט את רשימת הערכים עם [...] או דומה.

דוגמאות

Mpv --af=pan=1:[0.5,0.5] media.avi
יורד מיקס מסטריאו למונו.

Mpv --af=pan=3:[1,0,0.5,0,1,0.5] media.avi
ייתן פלט של 3 ערוצים ומשאיר את הערוצים 0 ו-1 ללא פגע, ומערבב
ערוצים 0 ו-1 לתוך ערוץ פלט 2 (שיכול להישלח אל a
סאב וופר למשל).

הערה:
אם אתה רק רוצה לכפות רימיקס לפריסת ערוץ פלט מסוים, זה כן
קל יותר להשתמש ב פוּרמָט לְסַנֵן. לדוגמה, Mpv '--af=format=channels=5.1'
'--audio-channels=5.1' תמיד יאלץ רימיקס אודיו ל-5.1 ויוציא אותו
כמו זה.

עיכוב[=[ch1,ch2,...]]
מעכב את הצליל לרמקולים כך שהקול מהשונה
הערוצים מגיעים לעמדת ההאזנה בו זמנית. זה שימושי רק אם אתה
יש יותר מ-2 רמקולים.

[ch1,ch2,...]
ההשהיה ב-ms שיש להטיל על כל ערוץ (נקודה צפה
מספר בין 0 ל-1000).

כדי לחשב את ההשהיה הנדרשת עבור הערוצים השונים, בצע את הפעולות הבאות:

1. מדוד את המרחק לרמקולים במטרים ביחס להאזנה שלך
מיקום, נותן לך את המרחקים s1 עד s5 (עבור מערכת 5.1). אין
נקודה בפיצוי על הסאב וופר (לא תשמע את ההבדל
בכל מקרה).

2. הורידו את המרחקים s1 עד s5 מהמרחק המקסימלי, כלומר סִי] = מקסימום -
סִי]; i = 1 ... 5.

3. חשב את ההשהיות הנדרשות ב-ms as ד[i] = 1000*s[i]/342; i = 1 ... 5.

דוגמה

Mpv --af=delay=[10.5,10.5,0,0,7,0] media.avi
יעכב קדמי שמאל וימין ב-10.5 אלפיות השנייה, שני הערוצים האחוריים ו
הסאבוופר ב-0 ms והערוץ המרכזי ב-7 ms.

drc[=method:target]
מחיל דחיסת טווח דינמי. זה ממקסם את עוצמת הקול על ידי דחיסה של ה
הטווח הדינמי של אות השמע. (נקרא בעבר volnorm.)


מגדיר את השיטה בשימוש.

1 השתמש במדגם בודד כדי להחליק את הווריאציות באמצעות התקן
ממוצע משוקלל על פני דגימות עבר (ברירת מחדל).

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


מגדיר את משרעת היעד כשבריר מהמקסימום עבור סוג המדגם
(ברירת מחדל: 0.25).

הערה:
מסנן זה יכול לגרום לעיוות עם אותות שמע בעלי עוצמה גדולה מאוד
טווח דינמי.

scaletempo[=option1:option2:...]
קנה מידה של קצב השמע מבלי לשנות את גובה הצליל, מסונכרן אופציונלי למהירות ההשמעה
(בְּרִירַת מֶחדָל).

זה עובד על ידי השמעת MS-ms של שמע במהירות רגילה ואז צורכת
'צעד*קנה מידה' של קלט אודיו. זה מחבר את הצעדים על ידי מיזוג
'חפיפה'% מהצעד עם אודיו בעקבות הצעד הקודם. זה אופציונלי
מבצע ניתוח סטטיסטי קצר על ה-'חיפוש' הבא של אודיו כדי לקבוע
מיקום החפיפה הטוב ביותר.

קנה מידה=
כמות נומינלית לקצב הסולם. מדרג כמות זו בנוסף למהירות.
(ברירת מחדל: 1.0)

צעד=
אורך באלפיות שניות לפלט כל צעד. ערך גבוה מדי יגרום
דילוגים ניכרים בסכומים גבוהים והד בסכומים נמוכים.
ערכים נמוכים מאוד ישנו את גובה הצליל. הגדלת משפרת את הביצועים. (בְּרִירַת מֶחדָל:
60)

חפיפה=
אחוז הצעד לחפיפה. ירידה משפרת את הביצועים. (בְּרִירַת מֶחדָל:
.20)

חיפוש=
אורך באלפיות שניות לחיפוש מיקום החפיפה הטוב ביותר. פּוֹחֵת
משפר את הביצועים מאוד. במערכות איטיות, סביר להניח שתרצה להגדיר
זה נמוך מאוד. (ברירת מחדל: 14)

מהירות=
הגדר תגובה לשינוי מהירות.

טֶמפּוֹ קנה מידה קצב מסונכרן עם מהירות (ברירת מחדל).

גובה הצליל הופך את האפקט של המסנן. סולמות גובה מבלי לשנות את הקצב. לְהוֹסִיף
זה שלך input.conf לצעד לפי צלילים למחצה מוזיקליים:

[ מהירות הכפלה 0.9438743126816935
] כפל מהירות 1.059463094352953

אזהרה:
מאבד סנכרון עם וידאו.

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

אף לא אחד התעלם משינויי מהירות.

דוגמאות

Mpv --af=scaletempo --מהירות=1.2 media.ogg
ישחק מדיה במהירות רגילה פי 1.2, עם שמע בגובה גובה רגיל.
שינוי מהירות ההשמעה ישנה את קצב השמע כך שיתאים.

Mpv --af=scaletempo=scale=1.2:speed=none --מהירות=1.2 media.ogg
היה מנגן מדיה במהירות רגילה פי 1.2, עם שמע בגובה הצליל רגיל, אבל
לשינוי מהירות ההשמעה לא תהיה השפעה על קצב השמע.

Mpv --af=scaletempo=stride=30:חפיפה=.50:search=10 media.ogg
ישנה את פרמטרי האיכות והביצועים.

Mpv --af=format=float,scaletempo media.ogg
יגרום ל-scaletempo להשתמש בקוד צף. אולי מהיר יותר בפלטפורמות מסוימות.

Mpv --af=scaletempo=scale=1.2:speed=pitch audio.ogg
ישחק מדיה במהירות רגילה פי 1.2, עם שמע בגובה גובה רגיל.
שינוי מהירות ההשמעה ישנה את גובה הצליל, ומשאיר את קצב השמע ב-1.2x.

גומי
תיקון גובה צליל באיכות גבוהה עם librobberband. זה יכול לשמש במקום
scaletempo, והוא ישמש לכוונון גובה השמע בעת ניגון במהירות שונה
מהרגיל.

למסנן זה מספר אפשרויות משנה. אתה יכול לרשום אותם עם Mpv
--af=גומייה=עזרה. זה יציג גם את ערכי ברירת המחדל עבור כל אפשרות. ה
האפשרויות אינן מתועדות כאן, מכיוון שהן רק מועברות ל- librobberband.
עיין בתיעוד של librobberband כדי ללמוד מה כל אפשרות עושה:
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(המיפוי של השמות והערכים של תת-אפשרויות מסנן ה-MPV גומי לאלו של
librobberband עוקב אחר דפוס פשוט: "אוֹפְּצִיָה" + שם + ערך.)

lavfi=גרף
סנן אודיו באמצעות libavfilter של FFmpeg.


גרף ליבאבפילטר. לִרְאוֹת lavfi מסנן וידאו לפרטים - תחביר הגרף הוא
אותו הדבר.

אזהרה:
אל תשכח לצטט גרפים של libavfilter כפי שמתואר בסרטון lavfi
קטע מסנן.

o=
AVOptions.

וידאו מסננים

מסנני וידאו מאפשרים לך לשנות את זרם הווידאו ואת המאפיינים שלו. התחביר הוא:

--vf=
הגדר שרשרת של מסנני וידאו.

אתה יכול גם להגדיר ברירת מחדל עבור כל מסנן. ברירת המחדל מוחלת לפני הרגיל
פרמטרי סינון.

--vf-defaults=
הגדר ברירת מחדל עבור כל מסנן.

הערה:
כדי לקבל רשימה מלאה של מסנני וידאו זמינים, ראה --vf=עזרה.

כמו כן, זכור שרוב המסננים בפועל זמינים דרך lavfi עטיפה, אשר
נותן לך גישה לרוב המסננים של libavfilter. זה כולל את כל המסננים שיש להם
הועבר מ-MPlayer ל-libavfilter.

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

--vf-add=
מוסיף את המסננים שניתנו כארגומנטים לרשימת המסננים.

--vf-pre=
מקדים את המסננים שניתנו כארגומנטים לרשימת המסננים.

--vf-del=
מוחק את המסננים באינדקסים הנתונים. מספרי אינדקס מתחילים ב-0, שלילי
המספרים מתייחסים לסוף הרשימה (-1 הוא האחרון).

--vf-clr
מרוקן לחלוטין את רשימת הסינון.

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

--vf= =עזרה
מדפיס את שמות הפרמטרים וטווחי ערכי הפרמטרים עבור מסנן מסוים.

--vf=
מגדיר פרמטר בעל שם לערך הנתון. השתמש בהפעלה וכיבוי או בכן ולא כדי להגדיר דגל
פרמטרים.

המסננים הזמינים הם:

חיתוך[=w:h:x:y]
חותך את החלק הנתון של התמונה ומשליך את השאר. שימושי להסרת שחור
להקות מסרטוני מסך רחב.

,
רוחב וגובה חתוכים, ברירת המחדל היא הרוחב והגובה המקוריים.

,
מיקום התמונה החתוכה, ברירת המחדל למרכז.

expand[=w:h:x:y:aspect:round]
מרחיב (לא מקנה קנה מידה) את רזולוציית הווידאו לערך הנתון וממקם את הלא קנה מידה
מקורי בקואורדינטות x, y.

,
רוחב, גובה מורחב (ברירת מחדל: רוחב מקורי, גובה). ערכים שליליים עבור
w ו-h מטופלים כקיזוזים לגודל המקורי.

דוגמה

expand=0:-50:0:0
מוסיף גבול של 50 פיקסלים לתחתית התמונה.

,
מיקום התמונה המקורית על התמונה המורחבת (ברירת מחדל: מרכז)


מתרחב כדי להתאים להיבט במקום לרזולוציה (ברירת מחדל: 0).

דוגמה

expand=800::::4/3
מתרחב ל-800x600, אלא אם המקור ברזולוציה גבוהה יותר, ב
במקרה זה הוא מתרחב כדי למלא היבט של 4/3.


עיגול כלפי מעלה כדי שהרוחב והגובה ניתנים לחלוקה ב (ברירת מחדל: 1).

להעיף הפוך את התמונה על פיה.

ראי משקף את התמונה על ציר ה-Y.

סובב[=0|90|180|270]
מסובב את התמונה בכפולה של 90 מעלות בכיוון השעון.

scale[=w:h:param:param2:chr-drop:noup:arnd
קנה קנה מידה של התמונה בעזרת scaler התוכנה (איטי) ומבצע צבע YUV<->RGB
המרת שטח (ראה גם -- sws).

כל הפרמטרים הם אופציונליים.

:
רוחב/גובה מותאמים (ברירת מחדל: רוחב/גובה מקוריים)

0 קנה מידה של d_width/d_height

-1 רוחב/גובה מקוריים

-2 חשב עם הממד השני וההיבט המותאם מראש
יחס.

-3 חשב עם הממד השני וההיבט המקורי
יחס.

-(n+8) כמו -n למעלה, אבל עיגול הממד לכפולה הקרובה ביותר של
16.

[: ] (ראה גם --sws)
הגדר כמה פרמטרים של קנה מידה בהתאם לסוג הסקלר שנבחר באמצעותו
-- sws:

--sws=2 (דו-קובי): B (טשטוש) ו-C (צלצול)
0.00:0.60 ברירת מחדל
0.00:0.75 ה"דו-קיובי" של VirtualDub
0.00:0.50 Catmull-Rom spline
0.33:0.33 ספליין מיטשל-נטרוואלי
1.00:0.00 מעוקב B-spline

--sws=7 (גאוסית): חדות (0 (רך) - 100 (חדה))

--sws=9 (Lanczos): אורך מסנן (1-10)


דילוג על כרומה

0 השתמש בכל קווי הקלט הזמינים עבור chroma (ברירת מחדל).

1 השתמש רק בכל 2. קו קלט עבור chroma.

2 השתמש רק בכל 4. קו קלט עבור chroma.

3 השתמש רק בכל 8. קו קלט עבור chroma.

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

0 אפשר העלאת קנה מידה (ברירת מחדל).

1 אסור לשפר את קנה המידה אם ממד אחד חורג מהערך המקורי שלו.

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

עיגול מדויק עבור ה-scaler האנכי, שעשוי להיות מהיר יותר או איטי יותר
מאשר עיגול ברירת המחדל.

לא השבת עיגול מדויק (ברירת מחדל).

כן אפשר עיגול מדויק.

dsize[=w:h:aspect-method:r:aspect]
משנה את גודל/היבט התצוגה המיועד בנקודה שרירותית בשרשרת המסנן.
היבט יכול להינתן כשבר (4/3) או מספר נקודה צפה (1.33).
לחלופין, תוכל לציין את רוחב וגובה התצוגה המדויקים הרצויים. הערה
שהמסנן הזה עושה זאת לֹא לעשות כל קנה מידה בעצמו; זה רק משפיע על מה שיותר מאוחר יותר
(תוכנה או חומרה) יצליחו בעת שינוי קנה מידה אוטומטי להיבט הנכון.

,
רוחב וגובה תצוגה חדשים.

יכולים להיות גם הערכים המיוחדים האלה:

0 רוחב וגובה התצוגה המקוריים

-1 רוחב וגובה הסרטון המקורי (ברירת מחדל)

-2 חשב עם הממד השני והתצוגה המקורית
יחס רוחב-גובה.

-3 חשב עם הממד השני וההיבט המקורי של הסרטון
יחס.

דוגמה

dsize=800:-2
מציין רזולוציית תצוגה של 800x600 עבור סרטון 4/3 היבט,
או 800x450 עבור סרטון 16/9 היבט.


משנה רוחב וגובה בהתאם ליחסי גובה-רוחב מקוריים.

-1 התעלם מיחס רוחב-גובה מקורי (ברירת מחדל).

0 שמור על יחס גובה-רוחב של התצוגה על ידי שימוש ו כרזולוציה מקסימלית.

1 שמור על יחס גובה-רוחב של התצוגה על ידי שימוש ו כרזולוציה מינימלית.

2 שמור על יחס גובה-רוחב של וידאו באמצעות ו כרזולוציה מקסימלית.

3 שמור על יחס גובה-רוחב של וידאו באמצעות ו כרזולוציה מינימלית.

דוגמה

dsize=800:600:0
מציין רזולוציית תצוגה של 800x600 לכל היותר, או פחות, ב
כדי לשמור על היבט.

עיגול כלפי מעלה כדי שהרוחב והגובה ניתנים לחלוקה ב (ברירת מחדל: 1).


לכפות יחס רוחב-גובה.

format=fmt= :colormatrix= :...
מגביל את מרחב הצבע עבור המסנן הבא מבלי לבצע המרה כלשהי. להשתמש
יחד עם מסנן קנה המידה להמרה אמיתית.

הערה:
לרשימה של פורמטים זמינים, ראה format=fmt=עזרה.

שם פורמט, למשל rgb15, bgr24, 420p וכו' (ברירת מחדל: אל תשתנה).


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


שולט בהמרת מרחב הצבע YUV ל-RGB בעת הפעלת וידאו. יש
תקנים שונים. בדרך כלל, יש להשתמש ב-BT.601 עבור וידאו SD, וב-BT.709
עבור וידאו HD. (זה נעשה כברירת מחדל.) שימוש במרחב צבע שגוי תוצאות
בצבעים מעט מתחת או יותר רוויים ומוחלפים.

אפשרויות אלה לא תמיד נתמכות. יציאות וידאו שונות מספקות
דרגות שונות של תמיכה. ה פתוח ו vdpau מנהלי התקנים של פלט וידאו
בדרך כלל מציעים תמיכה מלאה. ה xv פלט יכול להגדיר את מרחב הצבע אם
מנהל התקן הווידאו של המערכת תומך בו, אך לא ברמות הקלט והפלט. ה סולם
מסנן וידאו יכול להגדיר מרחב צבע ורמות קלט, אבל רק אם
פורמט הפלט הוא RGB (אם מנהל ההתקן של פלט הווידאו תומך בפלט RGB, אתה
יכול לכפות את זה עם -vf scale,format=rgba).

אם אפשרות זו מוגדרת ל המכונית (שהיא ברירת המחדל), צבע הסרטון
נעשה שימוש בדגל החלל. אם הדגל אינו מוגדר, מרחב הצבעים יהיה
נבחר אוטומטית. זה נעשה באמצעות היוריסטיקה פשוטה שמנסה
כדי להבחין בין וידאו SD ו-HD. אם הסרטון גדול מ-1279x576 פיקסלים,
ייעשה שימוש ב-BT.709 (HD); אחרת BT.601 (SD) נבחר.

מרחבי הצבע הזמינים הם:

המכונית בחירה אוטומטית (ברירת מחדל)

bt.601 ITU-R BT.601 (SD)

bt.709 ITU-R BT.709 (HD)

bt.2020-ncl
מערכת ITU-R BT.2020 לא קבועה

bt.2020-cl
מערכת ITU-R BT.2020 בהירות קבועה

smpte-240 מ'
SMPTE-240M


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

אותן מגבלות כמו עם להגיש מועמדות.

טווחי הצבעים הזמינים הם:

המכונית בחירה אוטומטית (טווח מוגבל בדרך כלל) (ברירת מחדל)

מוגבל
טווח מוגבל (16-235 ל-luma, 16-240 ל-chroma)

מלא טווח מלא (0-255 עבור לומה וכרומה כאחד)


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

אפשרות זו משפיעה רק על מנהלי התקנים של פלט וידאו שמבצעים צבע
ניהול, למשל פתוח עם target-prim or פרופיל icc
הגדרות משנה.

אם אפשרות זו מוגדרת ל המכונית (שזו ברירת המחדל), של הסרטון
ייעשה שימוש בדגל הפריימריז. אם הדגל הזה לא מוגדר, מרחב הצבעים יהיה
ייבחר אוטומטית, תוך שימוש בהיוריסטיקה הבאה: אם ה
מוגדר או נקבע כ-BT.2020 או BT.709, ה
נעשה שימוש בפריימריז המקביל. אחרת, אם גובה הסרטון הוא
בדיוק 576 (PAL), BT.601-625 משמש. אם זה בדיוק 480 או 486 (NTSC),
נעשה שימוש ב-BT.601-525. אם רזולוציית הווידאו היא משהו אחר, BT.709 כן
מְשׁוּמָשׁ.

פריימריז זמינים הם:

המכונית בחירה אוטומטית (ברירת מחדל)

bt.601-525
ITU-R BT.601 (SD) מערכות קו 525 (NTSC, SMPTE-C)

bt.601-625
ITU-R BT.601 (SD) מערכות קו 625 (PAL, SECAM)

bt.709 ITU-R BT.709 (HD) (אותם פריימריז כמו sRGB)

bt.2020
ITU-R BT.2020 (UHD)

תפוח Apple RGB

Adobe AdobeRGB (1998)

פרופוטו
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB


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

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

אם אפשרות זו מוגדרת ל המכונית (שהיא ברירת המחדל), הגמא תהיה
להיות מוגדר ל-BT.1886 עבור תוכן YCbCr, sRGB עבור תוכן RGB ולינארי
עבור תוכן XYZ.

פונקציות גמא זמינות הן:

המכונית בחירה אוטומטית (ברירת מחדל)

bt.1886
ITU-R BT.1886 (קירוב לעקומת BT.601/BT.709/BT.2020)

srgb IEC 61966-2-4 (sRGB)

קווים אור ליניארי

gamma1.8
עקומת כוח טהורה (גמא 1.8)

gamma2.2
עקומת כוח טהורה (גמא 2.2)

gamma2.8
עקומת כוח טהורה (גמא 2.8)

פרופוטו
עקומת ProPhoto RGB (ROMM).


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


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


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

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

הגדר את יחס הגובה-רוחב של מסגרת הווידאו. זו ציפה, אבל ערכית
כמו [16: 9] אפשר לעבור גם ([...] לציטוט כדי למנוע את האפשרות
מנתח מלפרש את : אופי).

noformat[=fmt]
מגביל את מרחב הצבע עבור המסנן הבא מבלי לבצע המרה כלשהי. בניגוד
מסנן הפורמט, זה יאפשר כל מרחב צבע מלבד זה שאתה מציין.

הערה:
לרשימה של פורמטים זמינים, ראה noformat=fmt=עזרה.

שם פורמט, למשל rgb15, bgr24, 420p וכו' (ברירת מחדל: 420p).

lavfi=graph[:sws-flags[:o=opts]]
סינון וידאו באמצעות libavfilter של FFmpeg.


מחרוזת הגרף libavfilter. המסנן חייב להיות בעל משטח קלט וידאו יחיד
ומשטח פלט וידאו בודד.

לִרְאוֹת https://ffmpeg.org/ffmpeg-filters.html עבור תחביר ומסננים זמינים.

אזהרה:
אם אתה רוצה להשתמש בתחביר המסנן המלא עם אפשרות זו, עליך לעשות זאת
ציטוט את גרף הסינון על מנת למנוע את התחביר של mpv ואת המסנן
תחביר גרף מהתנגשות.

דוגמאות

-vf lavfi=[gradfun=20:30,vflip]
gradfun מסנן עם פרמטרים שטויות, ואחריו א vflip
לְסַנֵן. (זה מדגים כיצד libavfilter לוקח גרף ולא
רק מסנן בודד.) מחרוזת גרף המסנן מצוטטת עם [
ו ]. זה לא דורש ציטוט נוסף או בריחה עם כמה
קונכיות (כמו bash), בעוד שאחרות (כמו zsh) דורשות תוספת "
מרכאות מסביב למחרוזת האפשרויות.

'--vf=lavfi="gradfun=20:30,vflip"'
אותו דבר כמו קודם, אבל משתמש בציטוט שאמור להיות בטוח עם כולם
פגזים. החיצוני ' מרכאות לוודא שהקליפה לא
להסיר את " ציטוטים הדרושים על ידי mpv.

'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'
זהה לקודם, אבל משתמש בפרמטרים בעלי שם לכל דבר.


אם libavfilter מוסיף מסננים להמרת פורמט פיקסלים, אפשרות זו
נותן את הדגלים שיש להעביר ל-libswscale. אפשרות זו היא מספרית
ולוקח שילוב קצת חכם של SWS_ דגלים.

לִרְאוֹת http://git.videolan.org/?p=ffmpeg.git;a=blob;f=libswscale/swscale.h.

הגדר אפשרויות AVFilterGraph. אלה צריכים להיות מתועדים על ידי FFmpeg.

דוגמה

'--vf=lavfi=yadif:o="threads=2,thread_type=slice"'
מאלץ תצורת השחלה מסוימת.

eq[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
אקולייזר תוכנה שמשתמש בטבלאות חיפוש (איטיות), המאפשר תיקון גמא פנימה
בנוסף להתאמת בהירות וניגודיות פשוטה. הפרמטרים ניתנים כ
ערכי נקודה צפה.

<0.1-10>
ערך גמא ראשוני (ברירת מחדל: 1.0)

<-2-2> ניגודיות ראשונית, כאשר ערכים שליליים מביאים לתמונה שלילית (ברירת מחדל:
1.0)

<-1-1> בהירות ראשונית (ברירת מחדל: 0.0)

<0-3> רוויה ראשונית (ברירת מחדל: 1.0)

<0.1-10>
ערך גמא עבור הרכיב האדום (ברירת מחדל: 1.0)

<0.1-10>
ערך גמא עבור הרכיב הירוק (ברירת מחדל: 1.0)

<0.1-10>
ערך גמא עבור הרכיב הכחול (ברירת מחדל: 1.0)

<0-1> ניתן להשתמש בפרמטר המשקל כדי להפחית את ההשפעה של ערך גמא גבוה
על אזורי תמונה בהירים, למשל למנוע מהם להיות מועצמים מדי וצודקים
לבן חלק. ערך של 0.0 מוריד את תיקון הגמא עד הסוף
בעוד 1.0 משאיר אותו במלוא עוצמתו (ברירת מחדל: 1.0).

pullup[=jl:jr:jt:jb:sb:mp]
פילטר היפוך משוך (היפוך telecine), המסוגל לטפל במעורב
hard-telecine, 24000/1001 fps פרוגרסיבי ותוכן פרוגרסיבי של 30000/1001 fps.
השמיים משיכה מסנן עושה שימוש בהקשר עתידי בקבלת ההחלטות שלו. זה
חסר מדינה במובן שהוא לא ננעל על דפוס שצריך לעקוב אחריו, אלא הוא
במקום זאת, מצפה לשדות הבאים כדי לזהות התאמות ו
לבנות מחדש מסגרות פרוגרסיביות.

jl, ג'וניור, jt, ו jb
אפשרויות אלו קובעות את כמות ה"זבל" להתעלם משמאל, ימין, למעלה,
ותחתית התמונה, בהתאמה. שמאל/ימין הם ביחידות של 8 פיקסלים,
בעוד העליון/תחתון הם ביחידות של 2 שורות. ברירת המחדל היא 8 פיקסלים על כל אחד
צַד.

sb (קַפְּדָנִי הפסקות)
הגדרת אפשרות זו ל-1 תקטין את הסיכויים של משיכה מייצר א
מדי פעם מסגרת לא תואמת, אבל זה עלול גם לגרום למספר מוגזם של
פריימים שיש להפיל במהלך רצפי תנועה גבוהה. לעומת זאת, להגדיר את זה
ל-1 יעשה משיכה להתאים שדות בקלות רבה יותר. זה עשוי לסייע בעיבוד של
סרטון שבו יש טשטוש קל בין השדות, אך עלול גם לגרום
יהיו מסגרות שלובות בפלט.

mp (מֶטרִי מָטוֹס)
אפשרות זו עשויה להיות מוגדרת ל u or v להשתמש במישור כרומה במקום הלומה
מטוס לעשייה משיכההחישובים של. זה עשוי לשפר את הדיוק על מאוד
חומר מקור נקי, אך סביר יותר שיפחית את הדיוק, במיוחד אם
יש רעש כרומה (אפקט קשת) או כל סרטון בגווני אפור. הראשי
מטרת ההגדרה mp למישור chroma זה להפחית את עומס המעבד וליצור
pullup שמיש בזמן אמת במכונות איטיות.

yadif=[מצב: interlaced-בלבד]
עוד מסנן לסירוגין



מסגרת פלט מסגרת אחת לכל מסגרת.

שדה פלט מסגרת אחת לכל שדה.

מסגרת-נו-מרחבית
כמו מסגרת אך מדלג על בדיקת השזירה המרחבית.

שדה-נו-מרחבי
כמו שדה אך מדלג על בדיקת השזירה המרחבית.



לא ביטול השזירה של כל המסגרות (ברירת מחדל).

כן רק מסגרות ביטול השזירה המסומנות כמשולבות (ברירת מחדל אם מסנן זה
מוכנס דרך deinterlace תכונה).

מסנן זה, מוכנס אוטומטית בעת שימוש ב- d מפתח (או כל מפתח אחר זה
מחליף את deinterlace נכס או בעת שימוש ב --deinterlace מתג), בהנחה
לפלט הווידאו אין תמיכה מקורית ב-deinterlacing.

אם אתה רק רוצה להגדיר את מצב ברירת המחדל, הכנס את המסנן הזה ואת האפשרויות שלו
--vf-ברירות מחדל במקום זאת, ואפשר דה-interlacing עם d or --deinterlace.

שימו לב גם כי ה- d המפתח הוא טיפש מספיק כדי להכניס דה-אינטרלייזר פעמיים כאשר
הכנסת yadif עם --vf, לכן מומלץ להשתמש בשיטות לעיל.

sub=[=bottom-margin:top-margin]
מעביר את עיבוד הכתוביות לנקודה שרירותית בשרשרת הסינון, או כוח
עיבוד כתוביות במסנן הווידאו בניגוד לשימוש ב-OSD של פלט וידאו
תומכים.


מוסיף פס שחור בתחתית המסגרת. המעבד SSA/ASS יכול למקם
כתוביות שם (עם --תת-שימוש-שוליים).


פס שחור בחלק העליון עבור כותרות עליונות (עם --תת-שימוש-שוליים).

דוגמאות

--vf=sub,eq
מעביר את עיבוד המשנה לפני מסנן ה-eq. זה ישים את שתי הכתוביות
צבעים ווידאו בהשפעת הגדרות הווידאו אקולייזר.

stereo3d[=in:out]
Stereo3d ממיר בין פורמטי תמונה סטריאוסקופיים שונים.

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

sbsl or side_by_side_left_first
מקביל זה לצד זה (עין שמאל שמאל, עין ימין ימין)

sbsr or side_by_side_right_first
עין צולבת זה לצד זה (עין ימין שמאל, עין שמאל ימין)

abl or למעלה_למטה_משמאל_תחילה
למעלה-למטה (עין שמאל למעלה, עין ימין למטה)

אפריל or למעלה_למטה_ימין_תחילה
למעלה-למטה (עין ימין למעלה, עין שמאל למטה)

ab2l or למעלה_מתחת_לחצי_גובה_לשמאל_תחילה
מעל-למטה ברזולוציית חצי גובה (עין שמאל מעל, עין ימין
להלן)

ab2r or למעלה_מתחת_לחצי_גובה_ימינה_תחילה
מעל-למטה ברזולוציית חצי גובה (עין ימין מעל, עין שמאל
להלן)

פורמט תמונה סטריאוסקופית של פלט. ערכים אפשריים הם כל הקלט
פורמטים וכן:

arcg or anaglyph_red_cyan_grey
אנגליף אדום/ציאן אפור (מסנן אדום בעין שמאל, מסנן ציאן בצד ימין
עַיִן)

קשת or anaglyph_red_cyan_half_color
אנגליף אדום/ציאן חצי צבעוני (מסנן אדום בעין שמאל, מסנן ציאן
בעין ימין)

ארק or anaglyph_red_cyan_color
צבע אנגליף אדום/ציאן (מסנן אדום בעין שמאל, מסנן ציאן מימין
עַיִן)

arcd or anaglyph_red_cyan_dubois
צבע אנגליף אדום/ציאן מותאם עם הקרנת הריבועים הקטנים ביותר
של Dubois (מסנן אדום בעין שמאל, מסנן ציאן בעין ימין)

agmg or anaglyph_green_magenta_grey
אנגליף ירוק/מגנטה אפור (מסנן ירוק בעין שמאל, מסנן מגנטה
בעין ימין)

אגמ or anaglyph_green_magenta_half_color
אנגליף ירוק/מגנטה חצי צבעוני (מסנן ירוק בעין שמאל,
מסנן מגנטה בעין ימין)

agmc or anaglyph_green_magenta_color
אנגליף בצבע ירוק/מגנטה (מסנן ירוק בעין שמאל, מגנטה
פילטר בעין ימין)

aybg or anaglyph_yellow_blue_grey
anaglyph צהוב/כחול אפור (מסנן צהוב בעין שמאל, פילטר כחול
עין ימין)

אייב or anaglyph_yellow_כחול_חצי_צבע
anaglyph צהוב/כחול חצי צבעוני (מסנן צהוב בעין שמאל, כחול
פילטר בעין ימין)

aybc or anaglyph_yellow_blue_color
אנגליף בצבע צהוב/כחול (מסנן צהוב בעין שמאל, פילטר כחול
בעין ימין)

IRL or interleave_rows_left_first
שורות משולבות (לעין שמאל יש שורה עליונה, עין ימין מתחילה בשורה הבאה)

irr or interleave_rows_right_first
שורות משולבות (לעין ימין יש שורה עליונה, עין שמאל מתחילה בשורה הבאה)

ml or מונו_שמאל
פלט מונו (בעין שמאל בלבד)

mr or מונו_ימין
פלט מונו (בעין ימין בלבד)

gradfun[=כוח[:radius|:size= ]]
תקן את חפצי הפסים המוכנסים לפעמים לאזורים כמעט שטוחים על ידי
חיתוך לעומק צבע של 8 סיביות. אינטרפולציה של ההדרגות שאמורות להגיע לאן
הלהקות הן, ומטרפות אותן.


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


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

גודל המסנן באחוזים מגודל אלכסוני התמונה. זה רגיל
חשב את גודל הרדיוס הסופי (ברירת מחדל: 1).

dlopen=dll[:a0[:a1[:a2[:a3]]]]
טוען ספרייה חיצונית כדי לסנן את התמונה. ממשק הספרייה הוא
vf_dlopen ממשק שצוין באמצעות libmpcodecs/vf_dlopen.h.

אזהרה:
מסנן זה הוצא משימוש.

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

a0=
ציין את הפרמטר הראשון שיעביר לספרייה.

a1=
ציין את הפרמטר השני שיעביר לספרייה.

a2=
ציין את הפרמטר השלישי שיעביר לספרייה.

a3=
ציין את הפרמטר הרביעי שיועבר לספרייה.

vapoursynth=file:buffered-frames:concurrent-frames
טוען סקריפט מסנן VapourSynth. זה מיועד לעיבוד זרם: mpv
למעשה מספק מסנן מקור, במקום להשתמש בסרטון VapourSynth מקורי
מָקוֹר. מקור mpv יענה על בקשות מסגרת רק בתוך חלון קטן של
מסגרות (הגודל של חלון זה נשלט באמצעות ה- מסגרות מאוחסנות פָּרָמֶטֶר),
ובקשות מעבר לכך יחזירו שגיאות. ככזה, אתה לא יכול להשתמש במלואו
כוח של VapourSynth, אבל אתה יכול להשתמש במסננים מסוימים.

אם אתה רק רוצה להפעיל וידאו שנוצר על ידי VapourSynth (כלומר באמצעות native
מקור וידאו VapourSynth), עדיף להשתמש בו vspipe ו-FIFO כדי להזין את הסרטון
ל-mpv. כך גם אם סקריפט הסינון דורש גישה אקראית למסגרת (ראה
מסגרות מאוחסנות פָּרָמֶטֶר).

מסנן זה הוא ניסיוני. אם יתברר שהוא עובד טוב ומשתמשים בו, זה
יועבר ל-libavfilter. אחרת, זה פשוט יוסר.

פילה שם הקובץ של מקור הסקריפט. נכון לעכשיו, זה תמיד סקריפט פיתון.
המשתנה video_in מוגדר למקור הווידאו mpv, והוא צפוי
שהתסריט קורא וידאו מתוכו. (אחרת, mpv לא יפענח וידאו,
ותור מנות הווידאו יעלה על גדותיו, ובסופו של דבר יוביל להופעת אודיו
הופסק.) התסריט צפוי לעבור גם דרך חותמות זמן באמצעות
_DurationNum ו _DurationDen מאפייני מסגרת.

דוגמא:

ייבוא ​​vapoursynth כמו vs
core = vs.get_core()
core.std.AddBorders(video_in, 10, 10, 20, 20).set_output()

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

מסגרות מאוחסנות
המספר המרבי של פריימים וידאו מפוענחים שיש לאחסן לפני ה-
מסנן (ברירת מחדל: 4). זה מציין את המספר המרבי של מסגרות בסקריפט
יכול בקשות לאחור. למשל אם buffed-frames=5, והתסריט פשוט
ביקש מסגרת 15, זה עדיין יכול לבקש מסגרת 10, אבל מסגרת 9 לא
זמין יותר. אם הוא מבקש מסגרת 30, mpv יפענח 15 פריימים נוספים,
ושמור רק מסגרות 25-30.

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

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

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

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

המשתנים הבאים מוגדרים על ידי mpv:

video_in
מקור הווידאו mpv כקליפ vapoursynth. שימו לב שאין לזה אורך מוגדר,
מה שמבלבל מסננים רבים. באמצעות מְטוּפָּח על הקליפ עם אורך דמה גבוה
יכול להפוך אותו לקליפ סופי.

video_in_dw, video_in_dh
גודל התצוגה של הסרטון. יכול להיות שונה מגודל הסרטון אם הסרטון
אינו משתמש בפיקסלים מרובעים (למשל DVD).

container_fps
ערך FPS כפי שדווח על ידי כותרות קבצים. ערך זה יכול להיות שגוי או לחלוטין
שבור (למשל 0 או NaN). גם אם הערך נכון, אם מסנן אחר
משנה את ה-FPS האמיתי (על ידי שחרור או הוספת מסגרות), הערך של זה
ייתכן שהמשתנה לא יהיה שימושי. שימו לב שה --fps אפשרות שורת פקודה
עוקף ערך זה.

שימושי עבור כמה מסננים שמתעקשים להחזיק FPS.

display_fps
קצב רענון של התצוגה הנוכחית. שימו לב שערך זה יכול להיות 0.

vapoursynth-עצלן
זהה ל vapoursynth, אך אינו טוען סקריפטים של Python. במקום זאת, backend מותאם אישית
באמצעות Lua ובשימוש בממשק ה-API הגולמי של VapourSynth. התחביר שונה לחלוטין,
ולחלוטין לא מסופקות תכונות נוחות. אין בדיקת סוגים
או, ואתה יכול להפעיל קריסות.

דוגמא:

video_out = invoke("morpho", "Open", {clip = video_in})

המשתנה המיוחד video_in הוא מקור הווידאו mpv, בעוד המשתנה המיוחד
וידאו_out משמש לקריאת וידאו. הארגומנט הראשון הוא הפלאגין (שאילתה עם
getPluginByNs), ה-2 הוא שם המסנן, והארגומנט השלישי הוא טבלה עם
הטיעונים. טיעונים מיקוםיים אינם נתמכים. הסוגים חייבים להתאים
בְּדִיוּק. מכיוון שלואה היא נוראית ואינה יכולה להבחין בין מספרים שלמים וצפים, מספר שלם
יש לשים קידומת של טיעונים i_, במקרה זה הקידומת מוסרת וה-
הטיעון יצוק למספר שלם. האם שם הטיעון צריך להתחיל ב i_, אתה
ללא מזל.

קליפים (VSNodeRef) מועברים כנתוני משתמש קלים, לכן מנסים להעביר כל אחד אחר
סוג נתוני משתמש יגרום לקריסות קשות.

vavpp עיבוד וידאו לאחר VA-AP-API. עובד עם --vo=vaapi ו --vo=opengl בלבד.
כרגע deinterlaces. מסנן זה מוכנס אוטומטית אם ביטול השזירה כן
מבוקש (באמצעות ה- d מפתח, כברירת מחדל ממופה לפקודה מחזור
deinterlace, או --deinterlace אוֹפְּצִיָה).

deint=
בחר באלגוריתם ביטול השזירה.

לא אל תבצע דה-שזירה.

שדה ראשון
הצג רק את השדה הראשון (עובר --דומיננטיות בשדה).

שילינג bob deinterlacing (ברירת מחדל).

לֶאֱרוֹג, מותאם לתנועה, פיצוי על תנועה
אלגוריתמים מתקדמים של השזירה. האם אלה באמת עובדים
תלוי בחומרת ה-GPU, מנהלי ההתקן של ה-GPU, באגים של מנהל ההתקן ו-mpv
באגים.



לא הסר את כל המסגרות.

כן רק מסגרות ביטול השזירה המסומנות כמשולבות (ברירת מחדל).

vdpaupp
עיבוד וידאו לאחר VDPAU. עובד עם --vo=vdpau ו --vo=opengl רק. זֶה
מסנן מוכנס אוטומטית אם מתבקש ביטול השזירה (באמצעות d
מפתח, כברירת מחדל ממופה לפקודה מחזור deinterlace, או --deinterlace
אוֹפְּצִיָה). כאשר מפעילים את השזירה, היא תמיד מועדפת על פני תוכנה
מסנני deinterlacer אם vdpau נעשה שימוש ב-VO, וגם אם פתוח משמש ו
פענוח החומרה הופעל לפחות פעם אחת (כלומר vdpau נטען).

לחדד=<-1-1>
עבור ערכים חיוביים, החל אלגוריתם חידוד על הסרטון, עבור שלילי
מעריך אלגוריתם טשטוש (ברירת מחדל: 0).

denoise=<0-1>
החל אלגוריתם הפחתת רעש על הסרטון (ברירת מחדל: 0; ללא רעש
צִמצוּם).

deint=
האם ביטול השזירה זמין (ברירת מחדל: לא). אם מופעל, הוא ישתמש ב-
מצב נבחר עם deint-mode.

deint-mode=
בחר מצב ביטול השזירה (ברירת מחדל: זמני). כל המצבים מכבדים
--דומיננטיות בשדה.

שימו לב שכרגע קיים מנגנון המאפשר את vdpau VO לשנות
מה היא deint-mode של הוכנס אוטומטית vdpaupp מסננים. כדי למנוע בלבול, זה
מומלץ לא להשתמש ב --vo=vdpau אפשרויות משנה הקשורות לסינון.

שדה ראשון
הצג רק את השדה הראשון.

שילינג בוב מבטל את השזירה.

זְמַנִי
ביטול השזירה הטמפורלית מותאמת לתנועה. עלול להוביל לביטול סינכרון A/V עם
חומרת וידאו איטית ו/או ברזולוציה גבוהה.

זמני-מרחבי
דה-שזירה מותאמת לתנועה עם מרחב מונחה קצוות
שִׁרבּוּב. צריך חומרת וידאו מהירה.

chroma-deint
גורם ל-deinterlacers הזמני לפעול הן על לומה והן על chroma (ברירת מחדל). להשתמש
no-chroma-deint להשתמש אך ורק בלומה ולהאיץ את השזירה המתקדמת.
שימושי עם זיכרון וידאו איטי.

משיכה נסה להחיל telecine הפוך, צריך תנועה אדפטיבית טמפורלית deinterlacing.

שלובים-בלבד=
If כן (ברירת מחדל), רק מסגרות ביטול השזירה המסומנות כמשולבות.

hqscaling=<0-9>

0 השתמש בקנה מידה VDPAU ברירת מחדל (ברירת מחדל).

1-9 החל קנה מידה VDPAU באיכות גבוהה (צריך חומרה בעלת יכולת).

vdpaurb
סרטון VDPAU נקרא בחזרה. עובד עם --vo=vdpau ו --vo=opengl רק. המסנן הזה
יקרא מסגרות לאחור שפוענחו על ידי VDPAU כך שמסננים אחרים, שאינם
תואם בדרך כלל עם VDPAU, ניתן להשתמש בו כמו רגיל. מסנן זה חייב להיות
שצוין קודם לכן vdpaupp בשרשרת המסנן אם vdpaupp משמש.

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

הַצפָּנָה

אתה יכול לקודד קבצים מפורמט/קודק אחד לאחר באמצעות מתקן זה.

--o=
מאפשר מצב קידוד ומציין את שם קובץ הפלט.

--של=
מציין את פורמט הפלט (עוקף את הזיהוי האוטומטי על ידי סיומת שם הקובץ של
הקובץ שצוין על ידי -o). זו יכולה להיות רשימה מופרדת בפסיק של פורמטים אפשריים
לנסות. לִרְאוֹת --of=עזרה לרשימה מלאה של פורמטים נתמכים.

--ofopts=
מציין את אפשרויות פורמט הפלט עבור libavformat. לִרְאוֹת --ofopts=עזרה למלא
רשימה של אפשרויות נתמכות.

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

--ofopts-add=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--ofopts-pre=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--ofopts-del=
מוחק את האפשרויות באינדקסים הנתונים. מספרי אינדקס מתחילים ב-0, שלילי
המספרים מתייחסים לסוף הרשימה (-1 הוא האחרון).

--ofopts-clr
מרוקן לחלוטין את רשימת האפשרויות.

--ofps= ערך>
מציין את בסיס הזמן של פורמט הפלט (ברירת מחדל: 24000). ערכים נמוכים כמו מגבלה של 25
FPS של וידאו על ידי שחרור פריימים.

--oautofps
מגדיר את בסיס הזמן של פורמט הפלט לקצב הפריימים המנחש של סרטון הקלט
(מדמה התנהגות MEncoder, שימושי עבור AVI; עלול לגרום לירידת מסגרת). שים לב ש
לא כל ה-codec ולא כל הפורמטים תומכים בקידוד VFR, וחלקם כן
באגים כאשר צוין קצב סיביות יעד - השתמש --אופס or --oautofps לכפות CFR
קידוד במקרים אלה.

--omaxfps= ערך>
מציין את המרחק המינימלי של מסגרות סמוכות (ברירת מחדל: 0, כלומר לא מוגדר).
תוכן של קצב פריימים נמוך יותר אינו מותאם מחדש לקצב פריימים זה; תוכן של גבוה יותר
קצב הפריימים מופחת לקצב הפריימים הזה.

--oharddup
אם מוגדר, קצב הפריימים שניתן על ידי --אופס מושגת לא על ידי דילוג על קודי זמן, אלא
על ידי שכפול מסגרות (מצב קצב פריימים קבוע).

- ירידה אחת
אם מוגדר, מסגרות לעולם אינן נשמטות. במקום זאת, קודי זמן של וידאו מותאמים מחדש
תמיד להגדיל. עם זאת, הדבר עלול לגרום לאי-סינכרון AV; כדי לעקוף את זה, השתמש ב-a
שימוש בבסיס זמן ב-fps גבוה --אופס ולהימנע לחלוטין --oautofps.

--oac=
מציין את ה-codec האודיו הפלט. זו יכולה להיות רשימה של אפשרויות מופרדות בפסיקים
קודקים לנסות. לִרְאוֹת --oac=עזרה לרשימה מלאה של רכיבי קודקים נתמכים.

--oaoffset=
העברת נתוני אודיו לפי הזמן הנתון (בשניות) על ידי הוספה/הסרה של דגימות ב-
הַתחָלָה.

--oacopts=
מציין את אפשרויות ה-codec של הפלט עבור libavcodec. לִרְאוֹת --oacopts=עזרה עבור
רשימה מלאה של אפשרויות נתמכות.

דוגמה

--oac=libmp3lame --oacopts=b=128000
בוחר קידוד MP128 של 3 kbps.

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

--oacopts-add=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--oacopts-pre=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--oacopts-del=
מוחק את האפשרויות באינדקסים הנתונים. מספרי אינדקס מתחילים ב-0, שלילי
המספרים מתייחסים לסוף הרשימה (-1 הוא האחרון).

--oacopts-clr
מרוקן לחלוטין את רשימת האפשרויות.

--אוה ראשון
כפה על זרם האודיו להפוך לזרם הראשון בפלט. כברירת מחדל ה
הסדר לא מוגדר.

--ovc=
מציין את ה-codec של הפלט וידאו. זו יכולה להיות רשימה של אפשרויות מופרדות בפסיקים
קודקים לנסות. לִרְאוֹת --ovc=עזרה לרשימה מלאה של רכיבי קודקים נתמכים.

--ovoffset=
העברת נתוני וידאו לפי הזמן הנתון (בשניות) על ידי הזזת ערכי ה-pts.

--ovcopts
מציין את אפשרויות ה-Codec של הפלט עבור libavcodec. ראה --ovcopts=עזרה עבור א
רשימה מלאה של אפשרויות נתמכות.

דוגמאות

"--ovc=mpeg4 --ovcopts=qscale=5"
בוחר בסולם quantizer קבוע 5 עבור קידוד MPEG-4.

"--ovc=libx264 --ovcopts=crf=23"
בוחר במקדם איכות VBR 23 עבור קידוד H.264.

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

--ovcopts-add=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--ovcopts-pre=
מוסיף את האפשרויות שניתנו כארגומנטים לרשימת האפשרויות.

--ovcopts-del=
מוחק את האפשרויות באינדקסים הנתונים. מספרי אינדקס מתחילים ב-0, שלילי
המספרים מתייחסים לסוף הרשימה (-1 הוא האחרון).

--ovcopts-clr
מרוקן לחלוטין את רשימת האפשרויות.

--ovfirst
כפה על זרם הווידאו להפוך לזרם הראשון בפלט. כברירת מחדל ה
הסדר לא מוגדר.

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

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

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

פקודה ממשק

ניתן לשלוט בליבת mpv באמצעות פקודות ומאפיינים. מספר דרכים לאינטראקציה
עם השחקן השתמש בהם: כריכות מפתח (input.conf), OSD (מציג מידע עם
מאפיינים), JSON IPC, ה-API של הלקוח (libmpv), ומצב העבדים הקלאסי.

input.conf
הקובץ input.conf מורכב מרשימה של כריכות מפתח, לדוגמה:

צילום מסך # צלם צילום מסך עם מקש s
חיפוש שמאלה 15 # מפה את מקש החץ שמאלה לחיפוש קדימה ב-15 שניות

כל שורה ממפה מפתח לפקודת קלט. מפתחות מצוינים בערכם המילולי
(אותיות גדולות אם בשילוב עם משמרת), או שם למפתחות מיוחדים. לדוגמה, a מפות ל
מה היא a מקש ללא Shift, ו A מפות ל a עם משמרת.

הקובץ ממוקם בספריית התצורה של mpv (בדרך כלל ב
~/.config/mpv/input.conf תלוי בפלטפורמה). כריכות ברירת המחדל מוגדרות כאן:

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

ניתן לקבל רשימה של מפתחות מיוחדים עם
Mpv --input-keylist

באופן כללי, ניתן לשלב מפתחות עם משמרת, Ctrl ו אחר:

ctrl+q צא

Mpv ניתן להפעיל במצב בדיקת קלט, המציג את כריכות המקשים ואת הפקודות
הם קשורים ל-OSD, במקום לבצע את הפקודות:

mpv --input-test --force-window --בטלה

(רק סגירת החלון תגרום Mpv יציאה, לחיצה על מקשים רגילים רק תציג את ה
מחייב, גם אם ממופה ליציאה.)

כללי קֶלֶט פיקוד תחביר
[Shift+][Ctrl+][Alt+][Meta+] [{ }] [ ] ( )* [;
]

שימו לב שכברירת מחדל, ניתן להשתמש במקש Alt הימני ליצירת תווים מיוחדים, וכך
אינו נרשם כמשנה. האפשרות --no-input-right-alt-gr משנה התנהגות זו.

שורות חדשות תמיד מתחילות כריכה חדשה. # מתחיל תגובה (מחוץ למחרוזת המצוטטת
טיעונים). כדי לאגד פקודות ל- # מַפְתֵחַ, חַד יכול לשמש.

הוא התו המילולי שהמפתח מייצר (תו ASCII או Unicode), או א
שם סמלי (כפי שהודפס על ידי --input-keylist).

(מוצמד עם { ו }) הוא קטע הקלט עבור פקודה זו.

טיעונים מופרדים על ידי רווח לבן. זה חל אפילו על ארגומנטים של מחרוזת. לזה
סיבה, יש לצטט ארגומנטים של מחרוזת ". בתוך מרכאות, בריחה בסגנון C יכולה להיות
מְשׁוּמָשׁ.

אתה יכול לאגד מספר פקודות למקש אחד. לדוגמה:
טקסט הצג "פקודה 1"; הצג טקסט "פקודה 2"

אפשר גם לאגד פקודה לרצף של מקשים:
abc show-text "הפעלת פקודה לאחר לחיצה על a, b, c"

(זה לא מוצג בתחביר הפקודה הכללי.)

If a or ab or b כבר קשורים, זה יפעיל את הפקודה הראשונה שתתאים, ואת ה-
פקודה מרובה מקשים לעולם לא תיקרא. ניתן לסמן מחדש מפתחות ביניים להתעלם in
כדי להימנע מבעיה זו. המספר המרבי של מקשים (לא משנה) עבור שילובים הוא
כרגע 4.

רשימה of קֶלֶט פקודות
להתעלם השתמש בזה כדי "לחסום" מפתחות שאמורים להיות לא קשורים, ולא לעשות כלום. שימושי ל
השבתת כריכות ברירת מחדל, מבלי לנטרל את כל הכריכות עם
--no-input-default-bindings.

לחפש [relative|absolute|absolute-percent|relative-percent|exact|keyframes]
שנה את מיקום ההשמעה. כברירת מחדל, חיפוש לפי כמות יחסית של שניות.

הארגומנט השני מורכב מדגלים השולטים במצב החיפוש:

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

מוחלט
חפש לזמן נתון.

אבסולוטי-אחוז
חפש למיקום אחוז נתון.

אחוז יחסי
חפש ביחס למיקום הנוכחי באחוזים.

פריים מפתח
הפעל תמיד מחדש את ההשמעה בגבולות פריים מפתח (מהיר).

מְדוּיָק בצע תמיד חיפושים מדויקים / שעות / מדויקים (איטיים).

ניתן לשלב מספר דגלים, למשל: absolute+keyframes.

כברירת מחדל, פריים מפתח משמש למחפשים יחסית, ו מְדוּיָק משמש למוחלט
מחפש.

לפני mpv 0.9, ה פריים מפתח ו מְדוּיָק דגלים היו צריכים לעבור כפרמטר שלישי
(בעצם באמצעות רווח במקום +). הפרמטר השלישי עדיין מנותח, אבל הוא
נחשב מודח.

revert-seek [מצב]
מבטל את ה לחפש פקודה, ועוד כמה פקודות שמחפשות (אך לא בהכרח את כולן
שלהם). קריאה לפקודה זו פעם אחת תקפוץ לעמדת ההשמעה לפני ה-
לְחַפֵּשׂ. לקרוא לזה פעם שנייה מבטלת את revert-seek הפקודה עצמה. רק זה
עובד בתוך קובץ בודד.

הארגומנט הראשון הוא אופציונלי ויכול לשנות את ההתנהגות:

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

השימוש בו ללא טיעונים נותן לך את התנהגות ברירת המחדל.

שלב-מסגרת
הפעל פריים אחד ואז השהה. לא עושה כלום עם השמעת אודיו בלבד.

מסגרת-חזרה-צעד
חזור בפריים אחד ואז השהה. שים לב שזה יכול להיות איטי מאוד (זה מנסה להיות
מדויק, לא מהיר), ולפעמים לא מצליח להתנהג כמצופה. כמה טוב זה עובד
תלוי אם חיפוש מדויק עובד כהלכה (למשל ראה את
--hr-seek-demuxer-offset אוֹפְּצִיָה). מסנני וידאו או וידאו אחר עיבוד אחר זה
משנה את התזמון של מסגרות (למשל deinterlacing) אמור לעבוד בדרך כלל, אבל עשוי לעשות
צעדים לאחור מתנהגים בשקט באופן שגוי במקרים פינתיים. באמצעות
--hr-seek-framedrop=no אמור לעזור, אם כי זה עשוי להפוך את החיפוש המדויק לאיטי יותר.

זה לא עובד עם השמעת אודיו בלבד.

סט
הגדר את המאפיין הנתון לערך הנתון.

להוסיף [ ]
הוסף את הערך הנתון לנכס. על הצפת או תת-פרק, מהדק את הנכס
למקסימום. אם מושמט, נניח 1.

מחזור [למעלה|למטה]
סבב את המאפיין הנתון. up ו מטה להגדיר את כיוון המחזור. על גלישה, הגדר את
הנכס חזרה למינימום, ב-underflow הגדר אותו למקסימום. אם up or מטה is
הושמט, נניח up.

להכפיל
מכפיל את הערך של מאפיין עם הגורם המספרי.

צילום מסך [כתוביות|סרטון|חלון|- [יחיד|כל-פריים]]
צלם מסך.

טיעון ראשון:

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


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


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


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

צילום מסך לקובץ [כתוביות|סרטון|חלון]
צלם צילום מסך ושמור אותו בקובץ נתון. הפורמט של הקובץ יהיה
מנחש לפי הרחבה (ו --פורמט צילום מסך מתעלמים - ההתנהגות מתי
ההרחבה חסרה או שאינה ידועה היא שרירותית).

הטיעון השני הוא כמו הטיעון הראשון ל צילום מסך.

אם הקובץ כבר קיים, הוא מוחלף.

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

פלייליסט-הבא [חלש|כוח]
עבור לערך הבא ברשימת ההשמעה.

חלש (ברירת מחדל)
אם הקובץ האחרון ברשימת ההשמעה מופעל כעת, אל תעשה דבר.

כּוֹחַ סיים את ההשמעה אם אין יותר קבצים ברשימת ההשמעה.

פלייליסט-קודם [חלש|כוח]
עבור לערך הקודם ברשימת ההשמעה.

חלש (ברירת מחדל)
אם הקובץ הראשון ברשימת ההשמעה מופעל כעת, אל תעשה דבר.

כּוֹחַ סיים את ההשמעה אם הקובץ הראשון מופעל.

טען קובץ [החלף|להוסיף|להוסיף-הפעל [אפשרויות]]
טען את הקובץ הנתון והפעל אותו.

טיעון שני:

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


הוסף את הקובץ לרשימת ההשמעה.


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

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

רשימת עומסים [החלף|להוסיף]
טען את קובץ הפלייליסט הנתון (כמו --רשימת השמעה).

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

רשימת השמעה-הסר נוכחי|
הסר את רשומת הפלייליסט באינדקס הנתון. ערכי אינדקס מתחילים לספור עם 0.
הערך המיוחד נוֹכְחִי מסיר את הערך הנוכחי. שים לב שהסרת הזרם
הערך גם מפסיק את ההשמעה ומתחיל לנגן את הערך הבא.

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

פלייליסט-ערבב
ערבב את רשימת ההשמעה. זה דומה למה שנעשה בהתחלה אם ה --לְעַרְבֵּב
נעשה שימוש באופציה.

לָרוּץ הפקודה arg1 arg2 ...
הפעל את הפקודה הנתונה. שלא כמו ב-MPlayer/mplayer2 ובגרסאות קודמות של mpv
(0.2.x ומעלה), זה לא קורא למעטפת. במקום זאת, הפקודה מופעלת
ישירות, כאשר כל טיעון מועבר בנפרד. כל טיעון מורחב כמו ב
נכס הרחבה. שימו לב שיש מגבלה סטטית של (נכון לכתיבת שורות אלו) 9
טיעונים (ניתן להעלות מגבלה זו לפי דרישה).

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

כדי לקבל את ההתנהגות הישנה, ​​השתמש / Bin / sh ו -c בתור שני הטיעונים הראשונים.

דוגמה

לָרוּץ "/ Bin / sh" "-ג" "הֵד ${title} > /tmp/משחק"

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

להפסיק [ ]
צא מהשחקן. אם ניתן ארגומנט, הוא משמש כקוד יציאה מהתהליך.

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

תוספת משנה [ [ [ ]]]
טען את קובץ הכתוביות הנתון. הוא נבחר ככתובית נוכחית לאחר טעינה.

השמיים דגלים args הוא אחד מהערכים הבאים:


בחר את הכתובית מיד.


אל תבחר את הכתובית. (או במצבים מיוחדים, תן את ברירת המחדל
מנגנון בחירת זרם להחליט.)


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

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

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

הסרה משנה [ ]
הסר את רצועת הכתוביות הנתונה. אם ה id ארגומנט חסר, הסר את הנוכחי
מַסלוּל. (עובד על קבצי כתוביות חיצוניים בלבד.)

טעינה מחדש [ ]
טען מחדש את רצועות הכתוביות הנתונות. אם ה id ארגומנט חסר, טען מחדש את הנוכחי
מַסלוּל. (עובד על קבצי כתוביות חיצוניים בלבד.)

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

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

חיפוש משנה
חפש אל הכתובית הבאה (דילוג מוגדר ל-1) או הקודמת (דילוג מוגדר ל-1). זֶה
דומה ל תת שלב, אלא שהוא מחפש וידאו ואודיו במקום להתאים
עיכוב הכתוביות.

עבור כתוביות מוטבעות (כמו עם Matroska), זה עובד רק עם אירועי כתוביות
שכבר הוצגו, או נמצאים בטווח אחזור קצר.

OSD [ ]
החלף את רמת ה-OSD. אם מוגדר, הגדר את מצב ה-OSD (ראה --רמת OS ל
ערכים חוקיים).

טקסט מודפס
הדפס טקסט ל-stdout. המחרוזת יכולה להכיל מאפיינים (ראה נכס הרחבה).

הצג-טקסט [ |- [ ]]
הצג טקסט ב-OSD. המחרוזת יכולה להכיל מאפיינים, אשר מורחבים כ
מתואר ב נכס הרחבה. זה יכול לשמש כדי להציג את זמן השמעה, שם הקובץ,
וכן הלאה.


הזמן ב-ms להצגת ההודעה עבורו. כברירת מחדל, הוא משתמש באותו ערך
as --osd-משך.


רמת ה-OSD המינימלית להצגת הטקסט בה (ראה --רמת OS).

להראות-התקדמות
הצג את סרגל ההתקדמות, את הזמן שחלף ואת משך הזמן הכולל של הקובץ ב-
OSD.

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

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

עכבר [ [יחיד|כפול]]
שלח אירוע עכבר עם קואורדינטה נתונה (, ).

טיעון שני:


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

טיעון שלישי:

(ברירת מחדל)
אירוע העכבר מייצג קליק בודד רגיל.


אירוע העכבר מייצג לחיצה כפולה.

לחץ על מקש
שלח אירוע מפתח דרך מטפל הקלט של mpv, מפעיל כל התנהגות שהיא
מוגדר למפתח הזה. שם מפתח משתמש input.conf ערכת שמות למפתחות ו
משנה. שימושי עבור ה-API של הלקוח: ניתן לשלוח אירועי מפתח ל-libmpv כדי לטפל בהם
פנימי.

מפתח
דומה לחץ על מקש, אבל מגדיר את KEYDOWN דגל כך שאם המפתח קשור ל-a
פקודה ניתנת לחזרה, היא תופעל שוב ושוב עם תזמון החזרה של מפתח mpv עד
מה היא מפתח למעלה הפקודה נקראת.

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

הוספת אודיו [ [ [ ]]]
טען את קובץ האודיו הנתון. לִרְאוֹת תוספת משנה פקודה.

הסר אודיו [ ]
הסר את רצועת האודיו הנתונה. לִרְאוֹת הסרה משנה פקודה.

טעינת אודיו מחדש [ ]
טען מחדש את רצועות האודיו הנתונות. לִרְאוֹת טעינה מחדש פקודה.

סרוק מחדש קבצים חיצוניים [ ]
סרוק מחדש קבצים חיצוניים בהתאם לזרם --תת אוטומטי ו ---audio-file-auto
הגדרות. זה יכול לשמש לטעינה אוטומטית של קבצים חיצוניים לאחר הקובץ נטען.

השמיים מצב הטיעון הוא אחד מהבאים:

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


אל תשנה את בחירת הרצועה הנוכחית.

קֶלֶט פקודות זֶה יש לו אפשר נושא ל שינוי
af set|הוסף|החלפה|del|clr filter1=params,filter2,...
שנה שרשרת מסנן אודיו. לִרְאוֹת vf פקודה.

vf set|הוסף|החלפה|del|clr filter1=params,filter2,...
שנה שרשרת מסנן וידאו.

הטיעון הראשון מחליט מה קורה:

סט החלף את שרשרת המסנן הקודמת בשרשרת הסינון החדשה.

להוסיף הוסף את שרשרת המסנן החדשה לקודמת.

לְמַתֵג בדוק אם המסנן הנתון (עם הפרמטרים המדויקים) כבר נמצא ב-
שרשרת וידאו. אם כן, הסר את המסנן. אם לא, הוסף את המסנן. (אם כמה
מסננים מועברים לפקודה, זה נעשה עבור כל מסנן.)

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

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

אתה יכול להקצות תוויות לסינון על ידי הקדמתם @שֵׁם: (איפה שם הוא
מזהה שרירותי שנבחר על ידי המשתמש). ניתן להשתמש בתוויות כדי להתייחס למסננים לפי שם
בכל פקודות שינוי שרשרת הסינון. ל להוסיף, באמצעות שימוש כבר בשימוש
התווית תחליף את המסנן הקיים.

השמיים vf הפקודה מציגה את רשימת המסננים המבוקשים ב-OSD לאחר שינוי ה-
שרשרת סינון. זה בערך שווה ערך ל הצג-טקסט ${vf}. שים לב ש
מסננים שהוכנסו אוטומטית להמרת פורמט אינם מוצגים ברשימה, רק מה
התבקש על ידי המשתמש.

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

דוגמה עבור input.conf

· a vf סט להעיף להפוך את הסרטון על הפוך על a מפתח

· b vf סט "" הסר את כל מסנני הווידאו מופעלים b

· c vf לְמַתֵג lavfi=gradfun להפעיל את ביטול הרצועה c

ערכי מחזור ["!לַהֲפוֹך"] ...
עברו על רשימת ערכים. כל הפעלת הפקודה תגדיר את הנתון
מאפיין לערך הבא ברשימה. הפקודה מקיימת מונה פנימי
איזה ערך לבחור הבא, ואיזה הוא בהתחלה 0. הוא מאופס ל-0 פעם אחרונה
הערך הגיע.

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

הטיעון המיוחד !לַהֲפוֹך ניתן להשתמש כדי לעבור את רשימת הערכים לאחור.
בהשוואה לפקודה שרק מפרטת את הערך הפוך, פקודה זו תעשה זאת
למעשה לשתף את המונה הפנימי עם קשירת המפתחות לרכיבה קדימה (כל עוד
שכן שאר הטיעונים זהים).

שימו לב שיש מגבלה סטטית של (נכון לכתיבת שורות אלו) 10 ארגומנטים (מגבלה זו
ניתן להעלות לפי דרישה).

הפעל-סעיף [דגלים]
אפשר את כל כריכות המקשים בקטע הקלט עם השם.

מקטעי הקלט המופעלים יוצרים מחסנית. כריכות בקטעים בחלק העליון של
ערימה עדיפה על חלקים נמוכים יותר. פקודה זו שמה את הקטע על גבי ה
לַעֲרוֹם. אם הקטע כבר היה בערימה, הוא מוסר באופן מרומז
מִרֹאשׁ. (קטע לא יכול להיות בערימה יותר מפעם אחת.)

השמיים דגלים פרמטר יכול להיות שילוב (מופרד ב +) מהדגלים הבאים:


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


לא ניתן להשתמש בתכונה זו דרך ה-API הציבורי.


אותו.

השבת-סעיף
השבת את קטע הקלט בעל השם. מתבטל הפעל-סעיף.

להגדיר-סעיף [ברירת מחדל|מאולץ]
צור קטע קלט בעל שם, או החלף את התוכן של קלט שכבר קיים
סָעִיף. ה תוכן פרמטר משתמש באותו תחביר כמו ה- input.conf קובץ (למעט
שאסור להשתמש בתחביר הסעיף בו), כולל הצורך להפריד
כריכות עם תו חדש.

אם תוכן הפרמטר הוא מחרוזת ריקה, הקטע מוסר.

הקטע עם השם ברירת מחדל הוא קטע הקלט הרגיל.

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

לפרמטר האחרון יש את המשמעות הבאה:

(גַם מְשׁוּמָשׁ if פרמטר הושמט)
השתמש בכריכת מפתחות המוגדרת בסעיף זה רק אם המשתמש עדיין לא עשה זאת
קשר את המפתח הזה לפקודה.


תמיד קשר מפתח. (קטע הקלט שנעשה פעיל לאחרונה
מנצח אם יש אי בהירות.)

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

שכבות-על מוצגות בדרך כלל ברזולוציית מסך, אבל עם כמה VOs, ה
הרזולוציה מצטמצמת לזו של הסרטון. אתה יכול לקרוא את רוחב osd ו
osd-height נכסים. לפחות עם --vo-xv ווידאו אנמורפי (כגון DVD),
osd-par יש לקרוא גם כן, ויש לתת פיצוי על שכבת-העל.
(כיוונים עתידיים: אולי mpv צריך לטפל בחלק מהדברים האלה
אוטומטית, אבל קשה לדעת היכן למתוח את הגבול.)

id הוא מספר שלם בין 0 ל-63 המזהה את אלמנט השכבה. תעודת הזהות יכולה להיות
משמש להוספת חלקי שכבת-על מרובים, עדכן חלק על-ידי שימוש בפקודה זו עם an
מזהה שכבר קיים, או להסיר חלק איתו שכבת-על-הסר. שימוש בעבר
מזהה שלא נעשה בו שימוש יוסיף שכבת-על חדשה, בעוד ששימוש חוזר במזהה יעדכן אותו. (עתיד
כיוונים: צריך להיות משהו כדי להבטיח שתוכניות שונות ירצו
יצירת שכבות-על אינן מתנגשות זו עם זו, אם אי פעם יהיה צורך בכך.)

x ו y ציין את המיקום שבו יש להציג את ה-OSD.

פילה מציין את הקובץ שממנו נקראים נתוני התמונה הגולמיים. זה יכול להיות או מספרי
מתאר קובץ UNIX עם קידומת @ (לְמָשָׁל @4), או שם קובץ. הקובץ יהיה
ממופה לתוך הזיכרון עם ממפה (). חלק מה-VOs יעבירו ישירות את המצביע הממוף
הצג ממשקי API (למשל opengl או vdpau), כך שלא מדובר בהעתקה בפועל. קטיעה
קובץ המקור בזמן שהשכבה פעילה יקרוס את הנגן. אתה לא צריך
שנה את הנתונים בזמן שהשכבה פעילה, מכיוון שהנתונים הם בעצם
גישה אליו בנקודות אקראיות. במקום זאת, התקשר שכבת-על-הוסף שוב (רצוי עם א
אזור זיכרון שונה למניעת קריעה).

אפשר גם להעביר כתובת זיכרון גולמית לשימוש כזיכרון Bitmap על ידי
העברת כתובת זיכרון כמספר שלם עם קידומת an & דמות. עובר את
דבר שגוי כאן יקרוס את הנגן. מצב זה עשוי להיות שימושי לשימוש עם
libmpv. ה לקזז הפרמטר פשוט מתווסף לכתובת הזיכרון (מאז mpv
0.8.0, התעלמו ממנו קודם).

לקזז הוא היסט בתים של הפיקסל הראשון בקובץ המקור. (הנוכחי
יישום תמיד mmap הוא כל הקובץ ממיקום 0 עד סוף הקובץ
תמונה, לכן יש להימנע מהיסטים גדולים. לפני mpv 0.8.0, ההיסט היה
למעשה עבר ישירות ל mmap, אך הוא שונה כדי להקל על השימוש.)

fmt היא מחרוזת המזהה את פורמט התמונה. נכון לעכשיו, בלבד bgra מוגדר. זֶה
לפורמט יש 4 בתים לפיקסלים, עם 8 ביטים לכל רכיב. הפחות משמעותי 8
סיביות כחולות, ו-8 הסיביות המשמעותיות ביותר הן אלפא (באנדיאן הקטן, ה-
הרכיבים הם BGRA, עם B בתור בייט ראשון). זה משתמש מראש ב-alpha: every
רכיב הצבע כבר מוכפל עם רכיב האלפא. זה אומר את
הערך המספרי של כל רכיב שווה לרכיב האלפא או קטן ממנו.
(הפרת כלל זה תוביל לתוצאות שונות עם VOs שונים: מספריים
הצפות הנובעות ממיזוג ערכי אלפא שבורים נחשבת למשהו ש
לא אמור לקרות, וכתוצאה מכך יישומים לא מבטיחים שתקבל
התנהגות צפויה במקרה זה.)

w, h, ו פסיעה ציין את גודל שכבת העל. w הוא הרוחב הנראה של ה
שכבת-על, תוך כדי פסיעה נותן את הרוחב בבתים בזיכרון. במקרה הפשוט, ו
עם bgra פוּרמָט, צעד==4*וו. באופן כללי, כמות הזיכרון הכוללת שניגשת אליה
is פסיעה * h. (טכנית, הגודל המינימלי יהיה פסיעה * (h - 1) + w * 4,
אך לשם הפשטות, השחקן ייגש לכולם פסיעה * h בתים.)

אזהרה

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

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

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

script-הודעה-to ...
כמו script_message, אבל שלח אותו רק ללקוח ששמו . כל לקוח
(סקריפטים וכו') יש שם ייחודי. לדוגמה, סקריפטים של Lua יכולים לקבל את שמם באמצעות
mp.get_script_name().

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

הטיעון הוא שם הכריכה.

זה יכול להיות אופציונלי לקבל קידומת עם שם הסקריפט, באמצעות / כמפריד,
לְמָשָׁל script_binding שם תסריט/שם מחייב.

למען השלמות, הנה איך פקודה זו פועלת באופן פנימי. הפרטים יכולים
לשנות בכל עת. בכל אירוע מפתח תואם, script_message_to or script_message is
call (תלוי אם שם הסקריפט כלול), שבו הארגומנט הראשון
הוא המחרוזת קשירת מפתחות, הטיעון השני הוא שם הכריכה, וה-
ארגומנט שלישי הוא מצב המפתח כמחרוזת. מצב המפתח מורכב ממספר של
אותיות. האות הראשונה היא אחת מ d (המקש נלחץ למטה), u (שוחרר), r
(המקש עדיין למטה, והוא חזר על עצמו; רק אם חזרת מקש מופעלת עבור זה
כריכה), p (המקש נלחץ; קורה אם לא ניתן לעקוב מעלה/מטה). השני
מכתב אם האירוע מקורו בעכבר m (לחצן העכבר) או -
(משהו אחר).

ab-loop
עברו על מצבי לולאת AB. הפקודה הראשונה תגדיר את A נקודה (ה
אב-לופ-א תכונה); השני את B נקודה, והשלישית תנקה את שתי הנקודות.

vo-cmdline
אפס את אפשרות המשנה של ה-VO הנוכחי. כרגע עובד עם פתוח (כולל
opengl-hq). הארגומנט הוא המחרוזת של אפשרויות המשנה המועברת בדרך כלל ל-VO ב-
שורת הפקודה. לא ניתן להגדיר את כל תתי האפשרויות, אבל אלו שיוכלו יאופסו
גם אם הם לא מופיעים בטיעון. פקודה זו עשויה להשתנות או
יוסר בעתיד.

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

צילום מסך-גולמי [כתוביות|סרטון|חלון]
החזר צילום מסך לזיכרון. ניתן להשתמש בזה רק דרך ה-API של הלקוח. ה
MPV_FORMAT_NODE_MAP המוחזר על ידי פקודה זו יש את w, h, פסיעה שדות מוגדרים ל
תוכן ברור. א פוּרמָט שדה מוגדר ל bgr0 כברירת מחדל. הפורמט הזה הוא
מאורגן כ B8G8R8X8 (איפה B הוא ה-LSB). תוכן הריפוד X is
לא מוגדר. ה נתונים השדה הוא מסוג MPV_FORMAT_BYTE_ARRAY עם התמונה בפועל
נתונים. התמונה משתחררת ברגע שצומת התוצאה משתחרר.

פקודות לא מתועדות: טלוויזיה-ערוץ אחרון (טלוויזיה/DVB בלבד), ao-טעינה מחדש (ניסיוני/פנימי).

הוקס
הוקס הם אירועים סינכרוניים בין ליבת שחקן לתסריט או דומה. זה חל על
לקוח API (כולל ממשק הסקריפטים של Lua). בדרך כלל, אירועים אמורים להיות
אסינכרוני, וה-Hook API מספק דרך מביכה ולא ברורה לטפל באירועים כאלה
דורשים תיאום קפדני יותר. אין ערובות יציבות API. לא עוקב
הפרוטוקול בדיוק יכול לגרום לנגן לקפוא באופן אקראי. בעיקרון, אף אחד לא צריך להשתמש
ה-API הזה.

מדובר בשתי פקודות מיוחדות. כמו כן, על הלקוח להקשיב להודעות הלקוח
(MPV_EVENT_CLIENT_MESSAGE ב-C API).

הוק-הוסף
הירשם ל-hook המזוהה על ידי הארגומנט הראשון (בעצם, השם של
מִקרֶה). ה id ארגומנט הוא מספר שלם שרירותי שנבחר על ידי המשתמש. עדיפות is
משמש כדי למיין את כל מטפלי הקרסים ברחבי העולם על פני כל הלקוחות. כל לקוח יכול
רשום מספר מטפלי קרס (אפילו עבור אותו שם קרס). ברגע שהוו הוא
רשום, לא ניתן לבטל את הרישום.

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

1. המחרוזת hook_run

2. ה id ארגומנט שה-hook נרשם איתו כמחרוזת (אפשר להשתמש בזה
לטפל בצורה נכונה במספר ווים שנרשמו על ידי אותו לקוח, כל עוד id
הטיעון הוא ייחודי בלקוח)

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

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

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

הוק-ack
הפעל את הוו הבא בשרשרת הווים העולמית. הטיעון הוא הטיעון השלישי של
הודעת הלקוח שמתחילה ביצוע Hook עבור הלקוח הנוכחי.

הווים הבאים מוגדרים כעת:

on_load
נקרא כאשר יש לפתוח קובץ, לפני שמשהו נעשה בפועל. לדוגמה,
אתה יכול לקרוא ולכתוב את stream-open-filename מאפיין שאליו ניתן להפנות כתובת אתר
משהו אחר (שקול תמיכה באתרי סטרימינג שלעתים רחוקות נותנים למשתמש א
כתובת URL ישירה של מדיה), או שאתה יכול להגדיר אפשרויות לכל קובץ על ידי הגדרת המאפיין
file-local-options/ שם>. השחקן ימתין עד שכל הווים יופעלו.

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

קֶלֶט פיקוד קידומות
קידומות אלה ממוקמות בין שם המפתח לבין הפקודה בפועל. קידומות מרובות יכולות
יצוין. הם מופרדים על ידי רווח לבן.

osd-auto (ברירת מחדל)
השתמש בהתנהגות ברירת המחדל עבור פקודה זו.

אין-osd אל תשתמש באף OSD עבור פקודה זו.

osd-bar
אם אפשר, הצג סרגל עם פקודה זו. פקודות חיפוש יציגו את ההתקדמות
bar, פקודות לשינוי מאפיינים עשויות להראות את הערך החדש שהוגדר.

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

osd-msg-bar
שלב osd-bar ו-osd-msg.

חי אל תרחיב מאפיינים בארגומנטים של מחרוזת. (כמו "${property-name}".)

להרחיב-מאפיינים (ברירת מחדל)
כל הארגומנטים של המחרוזת מורחבים כמתואר ב נכס הרחבה.

הָדִיר
עבור פקודות מסוימות, לחיצה על מקש אינה מפעילה את הפקודה שוב ושוב. זֶה
הקידומת מאלצת המאפשרת חזרה על מפתח בכל מקרה.

כל קידומות ה-OSD עדיין מוחקות על ידי הגלובלי --רמת OS הגדרות.

קֶלֶט סעיפים
קטעי קלט מקבצים קבוצה של כריכות, ומפעילים או משביתים אותם בבת אחת. ב
input.conf, כל כריכת מקשים מוקצית לקטע קלט, במקום שיש למעשה
קטעי טקסט מפורשים.

ראה גם enable_section ו disable_section פקודות.

כריכות מוגדרות מראש:

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

לְהַצְפִּין מדור שפעיל במצב קידוד. זה מופעל באופן בלעדי, כך ש
כריכות ב ברירת מחדל מתעלמים מקטעים.

פרויקטים
מאפיינים משמשים להגדרת אפשרויות mpv במהלך זמן ריצה, או לשאילתות מידע שרירותי.
ניתן לתמרן אותם עם סט/להוסיף/מחזור פקודות, ואחזר עם הצג-טקסט, או
כל דבר אחר שמשתמש בהרחבת נכס. (לִרְאוֹת נכס הרחבה.)

שם הנכס מסומן ב-RW כדי לציין אם הנכס הוא בדרך כלל
ניתן לכתוב.

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

נכס רשימה
ברמת osd (RW)
לִרְאוֹת --רמת OS.

osd-scale (RW)
מכפיל גודל גופן OSD, ראה --- osd-scale.

לולאה (RW)
לִרְאוֹת --לוּלָאָה.

קובץ לולאה (RW)
לִרְאוֹת --לולאה-קובץ (שימושים כן/לא).

מְהִירוּת (RW)
לִרְאוֹת --מְהִירוּת.

תיקון מהירות אודיו, וידאו-מהירות-תיקון
פקטור מוכפל עם מְהִירוּת שבו הנגן מנסה להפעיל את הקובץ. בְּדֶרֶך כְּלַל
זה בדיוק 1. (מצב סנכרון תצוגה יהפוך את זה לשימושי.)

עיצוב OSD יציג אותו בצורה של +% 1.23456, כשהמספר הוא (גלם
- 1) * 100 עבור ערך הנכס הגולמי הנתון.

display-sync-active
החזר אם --video-sync=display הוא למעשה פעיל.

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

גודל הקובץ
אורך בבתים של קובץ המקור/זרם. (זה אותו דבר כמו ${stream-end}. פורום
פרקים שהוזמנו וכאלה, מוחזר גודל הקטע המושמע כעת.)

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

הערה:
זוהי הערכה בלבד. (זה מחושב משתי כמויות לא אמינות: fps ו
אורך הזרם.)

מספר מסגרת משוער
מספר המסגרת הנוכחית בזרם הנוכחי.

הערה:
זוהי הערכה בלבד. (זה מחושב משתי כמויות לא אמינות: fps ו
אולי חותמות זמן מעוגלות.)

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

כותרת מדיה
אם לקובץ המושמע כעת יש א כותרת תג, השתמש בזה.

אחרת, אם סוג המדיה הוא DVD, החזר את מזהה אמצעי האחסון של ה-DVD.

אחרת, החזר את שם הקובץ נכס.

פורמט קובץ
שם סמלי של פורמט הקובץ. במקרים מסוימים, זוהי רשימה מופרדת בפסיקים של
שמות פורמטים, למשל mp4 הוא mov,mp4,m4a,3gp,3g2,mj2 (הרשימה עשויה לגדול בעתיד
לכל פורמט).

דמוקסר
שם ה-demuxer הנוכחי. (זה חסר תועלת.)

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

זרם-פוז (RW)
מיקום בתים גולמי בזרם המקור.

קצה זרם
מיקום קצה גולמי בבתים בזרם המקור.

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

זה מחליף את אורך נכס, שהוצא משימוש לאחר שחרור mpv 0.9.
(הסמנטיקה זהה.)

avsync הבדל סנכרון A/V אחרון. לא זמין אם אודיו או וידאו מושבתים.

total-avsync-change
תיקון AV סינכרון כולל נעשה. לא זמין אם אודיו או וידאו מושבתים.

drop-frame-count
מסגרות וידאו נפלו על ידי מפענח, מכיוון שהווידאו נמצא רחוק מדי מאחורי האודיו (בעת השימוש
--framedrop=מפענח). לפעמים, זה עשוי להיות מוגבר במצבים אחרים, למשל
כאשר מנות הווידאו פגומות, או שהמפענח אינו פועל לפי הכללים הרגילים.
לא זמין אם הסרטון מושבת.

vo-drop-frame-count
מסגרות ירדות ב-VO (בעת שימוש --framedrop=vo).

ספירת פריימים שגויה
מספר מסגרות הווידאו שלא תוזמנו כראוי במצב סנכרון תצוגה עבור
למען שמירה על סינכרון A/V. זה לא כולל נסיבות חיצוניות, כגון
עיבוד וידאו איטי מדי או שמנהל ההתקן הגרפי מדלג איכשהו על vsync. זה
לא כולל גם שגיאות עיגול (מה שיכול לקרות במיוחד עם רע
חותמות זמן של מקור). לדוגמה, באמצעות ביטול סינכרון של תצוגה מצב לא אמור להשתנות
ערך זה מ-0.

vsync-ratio
עבור כמה vsyncs מוצגת מסגרת בממוצע. זה זמין אם
סינכרון התצוגה פעיל בלבד. עבור וידאו של 30 FPS על מסך 60 הרץ, זה יהיה 2.
זה הממוצע הנע של מה שתוכנן בפועל, אז 24 FPS על 60 הרץ
לעולם לא יישאר בדיוק על 2.5, אבל ריצוד תלוי בפריים האחרון המוצג.

vo-delayed-frame-count
מספר משוער של פריימים שעוכב עקב נסיבות חיצוניות בסנכרון התצוגה
מצב. שימו לב שבאופן כללי, mpv צריך לנחש שזה קורה, ואת הניחוש
יכול להיות לא מדויק.

אחוז-פוז (RW)
מיקום בקובץ הנוכחי (0-100). היתרון על השימוש בזה במקום
חישוב זה מתוך מאפיינים אחרים הוא שהוא חוזר כראוי לאומדן
מיקום ההשמעה ממיקום הבתים, אם משך הקובץ אינו ידוע.

זמן-פוז (RW)
מיקום בקובץ הנוכחי בשניות.

זמן-התחלה
הוצא משימוש. תמיד מחזיר 0. לפני mpv 0.14, זה נהג להחזיר את שעת ההתחלה
של הקובץ (יכול להשפיע למשל על זרמי תחבורה). לִרְאוֹת --rebase-start-time אוֹפְּצִיָה.

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

זמן משחק שנותר
זמן שנותר בקנה מידה לפי הזרם מְהִירוּת.

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

פרק (RW)
מספר הפרק הנוכחי. המספר של הפרק הראשון הוא 0.

מהדורה (RW)
מספר מהדורת MKV נוכחית. הגדרת מאפיין זה לערך שונה תופעל מחדש
השמעה. המספר של המהדורה הראשונה הוא 0.

כותרות דיסק
מספר כותרי BD/DVD.

יש לזה מספר מאפייני משנה. החלף N עם אינדקס המהדורה מבוסס 0.

כותרות/ספירה של דיסקים
מספר כותרים.

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

כותרות/אורך דיסק
אורך בשניות. יכול להיות לא זמין במספר מקרים (כרגע זה
עובד עבור libdvdnav בלבד).

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל מהדורה)
"מזהה" MPV_FORMAT_INT64
"אורך" MPV_FORMAT_DOUBLE

דיסק-כותרות-רשימת
רשימת כותרי BD/DVD.

כותרת הדיסק (RW)
מספר כותר נוכחי של BD/DVD. כתיבה עובדת רק עבור dvdnav:// ו bd:// (ו
כינויים עבור אלה).

פרקים
מספר פרקים.

מהדורות
מספר מהדורות MKV.

רשימת מהדורות
רשימת המהדורות, הערך הנוכחי מסומן. נכון לעכשיו, ערך הנכס הגולמי הוא
חסר תועלת.

יש לזה מספר מאפייני משנה. החלף N עם אינדקס המהדורה מבוסס 0.

רשימת מהדורות/ספירה
מספר מהדורות. אם אין מהדורות, זה יכול להיות 0 או 1 (1 אם
יש מהדורת דמה חסרת תועלת).

edition-list/N/id
מזהה מהדורה כמספר שלם. השתמש בזה כדי להגדיר את מהדורה תכונה. כַּיוֹם,
זה זהה לאינדקס המהדורה.

מהדורות-רשימת/N/ברירת מחדל
כן אם זו מהדורת ברירת המחדל, לא אחרת.

מהדורה-רשימת/N/כותרת
כותרת המהדורה כפי שמאוחסנת בקובץ. לא תמיד זמין.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל מהדורה)
"מזהה" MPV_FORMAT_INT64
"כותרת" MPV_FORMAT_STRING
"ברירת מחדל" MPV_FORMAT_FLAG

אב-לופ-א, אב-לולאה-ב (RW)
הגדר/קבל נקודות לולאה AB. ראה אפשרויות מתאימות ו ab_loop פקודה. ה
ערך מיוחד לא בכל אחד מהמאפיינים האלה משבית את הלולאה.

זָוִית (RW)
זווית DVD נוכחית.

מטה
צמדי מפתח/ערך של מטא נתונים.

אם הגישה לנכס מתבצעת באמצעות Lua's mp.get_property_native, זה מחזיר טבלה
עם מפתחות מטא נתונים המיפויים לערכי מטא נתונים. אם יש גישה אליו עם הלקוח
API, זה מחזיר א MPV_FORMAT_NODE_MAP, עם מפתחות תג מיפוי לערכי תג.

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

יש לזה מספר מאפייני משנה:

מטא נתונים/לפי מפתח/
ערך הזנת מטא נתונים .

מטא נתונים/רשימה/ספירה
מספר ערכי מטא נתונים.

metadata/list/N/key
שם המפתח של ערך המטא נתונים ה-N. (הערך הראשון הוא 0).

metadata/list/N/value
הערך של ערך המטא נתונים ה-N.

מטא נתונים/
גרסה ישנה של מטא נתונים/לפי מפתח/. השימוש אינו מונע, כי
מחרוזת מפתח מטא נתונים עלולה להתנגש עם מאפייני משנה אחרים.

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

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_MAP
(ערך מפתח ומחרוזת עבור כל ערך מטא נתונים)

מטא נתונים מסוננים
כמו מטה, אך כולל רק שדות המפורטים ב- --display-tags אוֹפְּצִיָה. זֶה
היא אותה קבוצה של תגים שמודפסת למסוף.

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

מטא נתונים לפי פרק נדירים מאוד. בדרך כלל, רק שם הפרק (כותרת) מוגדר.

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

vf-metadata/
מטא נתונים הוספו על ידי מסנני וידאו. נגיש על ידי תווית המסנן, ואם לא
צוין במפורש באמצעות ה @filter-label: תחביר, יהיה NN.

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

דוגמה למטא נתונים מסוג זה הם פרמטרי החיתוך שנוספו על ידי
--vf=lavfi=Cropdetect.

af-metadata/
שווה ערך ל vf-metadata/, אבל עבור מסנני אודיו.

הפסקה (RW)
השהה סטטוס. זה בדרך כלל כן or לא. לראות --הַפסָקָה.

להתבטל לחזור כן אם לא נטען קובץ, אבל הנגן נשאר בסביבה בגלל ה
--לְהִתְבַּטֵל אוֹפְּצִיָה.

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

גם זה חוזר כן אם ההשמעה מתחילה מחדש או אם שום דבר לא מתנגן. ב
במילים אחרות, זה רק לא אם באמת מתנגן וידאו. (התנהגות מאז mpv
<br>

מטמון מצב מילוי מטמון רשת (0-100.0).

גודל המטמון (RW)
גודל מטמון הרשת ב-KB. זה דומה ל --מטמון. זה מאפשר להגדיר את המטמון
גודל בזמן ריצה. נכון לעכשיו, לא ניתן להפעיל או להשבית את המטמון ב
זמן ריצה באמצעות מאפיין זה, רק כדי לשנות את גודל המטמון הקיים.

זה לא כולל את גודל המאגר האחורי (שונה לאחר mpv 0.10.0).

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

אל תשתמש בזה בעת הפעלת DVD או Blu-ray.

ללא מטמון (R)
גודל המטמון החינמי הכולל ב-KB.

בשימוש במטמון (R)
גודל המטמון הכולל בשימוש ב-KB.

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

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

demuxer-cache-time
זמן משוער של וידאו מאוחסן ב-demuxer, בשניות. כמו
דמקס-מטמון-משך אבל מחזיר את חותמת הזמן האחרונה של נתונים מאוחסנים ב-demuxer.

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

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

מצב אחסון מטמון
החזר את האחוז (0-100) של מצב מילוי המטמון עד שהשחקן יעשה זאת
בטל הפסקה (קשור ל מושהה-למטמון).

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

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

hr-seek (RW)
לִרְאוֹת --hr-חפש.

כֶּרֶך (RW)
נפח נוכחי (ראה --כרך לפרטים).

המהלך (RW)
מצב השתקה נוכחי (כן/לא).

עיכוב שמע (RW)
לִרְאוֹת --השהיית שמע.

אודיו-קודק
Codec שמע נבחר לפענוח.

אודיו-codec-name
Codec אודיו.

פרמטרים אודיו
פורמט שמע כפלט על ידי מפענח השמע. יש לזה מספר מאפייני משנה:

אודיו פרמטרים/פורמט
פורמט הדוגמה כמחרוזת. זה משתמש באותם שמות כמו בשמות אחרים
מקומות של mpv.

אודיו פרמטרים/דגימה
קצב דגימה.

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

פרמטרים אודיו/ערוצי שעות
As ערוצים, אבל במקום הפריסה הקריפטית בפועל שנשלחה ל-
מכשיר אודיו, תחזיר טופס אנושי יותר קריא בתקווה. (בדרך כלל בלבד
אודיו-out-params/hr-channels הגיוני.)

פרמטרים אודיו/ספירת ערוצים
מספר ערוצי שמע. זה מיותר ל- ערוצים שדה שתואר
מֵעַל.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_MAP
"פורמט" MPV_FORMAT_STRING
"לדגום" MPV_FORMAT_INT64
"ערוצים" MPV_FORMAT_STRING
"ספירת ערוצים" MPV_FORMAT_INT64
"hr-channels" MPV_FORMAT_STRING

פרמטרים של יציאת שמע
כמו פרמטרים אודיו, אלא הפורמט של הנתונים שנכתבו ל-Audio API.

סיוע (RW)
רצועת אודיו נוכחית (דומה ל --סיוע).

אודיו (RW)
כינוי עבור סיוע.

לאזן (RW)
איזון ערוץ אודיו. (היישום של תכונה זו הוא די מוזר. זה
אינו משנה את עוצמת הקול של כל ערוץ, אלא מגדיר מטריצת פאן למיקס
הערוצים השמאלי והימני.)

מסך מלא (RW)
לִרְאוֹת --מסך מלא.

deinterlace (RW)
לִרְאוֹת --deinterlace.

דומיננטיות בשטח (RW)
לִרְאוֹת --דומיננטיות בשדה

colormatrix (R)
מפנה אל וידאו-פרמס/קולורמטריקס. פרמטר זה (כמו גם דומים) יכול
להיות עוקף עם פוּרמָט מסנן וידאו.

colormatrix-input-range (R)
לִרְאוֹת colormatrix.

רמות פלט וידאו (RW)
לִרְאוֹת --רמות פלט וידאו,

colormatrix-primarys (R)
לִרְאוֹת colormatrix.

על (RW)
לִרְאוֹת --עליון.

גבול (RW)
לִרְאוֹת --גבול.

על כל חללי העבודה (RW)
לִרְאוֹת --על כל חללי העבודה. ייתכן שהביטול לא יעבוד בכל ה-WMs.

מסגרת (RW)
לִרְאוֹת --framedrop.

גמא (RW)
לִרְאוֹת --גמא.

בְּהִירוּת (RW)
לִרְאוֹת --בְּהִירוּת.

לעומת זאת (RW)
לִרְאוֹת --בניגוד.

רווי (RW)
לִרְאוֹת --רִוּוּי.

גוון (RW)
לִרְאוֹת --צֶבַע.

hwdec (RW)
משקף את --hwdec אוֹפְּצִיָה.

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

שלא כמו ב-mpv 0.9.x ומקודם, זה לא מחזיר את החומרה הפעילה כרגע
מפענח.

hwdec-active
לחזור כן or לא, תלוי אם סוג כלשהו של פענוח חומרה נמצא בפועל
שימוש.

hwdec-זיהוי
אם פענוח התוכנה פעיל, זה מחזיר את מפענח החומרה שנמצא בשימוש.
אחרת, זה גם חוזר לא, או אם רלוונטי, החומרה הטעונה כעת
API לפענוח. זה ידוע רק לאחר פתיחת ה-VO (ואולי מאוחר יותר). עם
כמה VOs (כמו פתוח), זה אף פעם לא ידוע מראש, אלא רק כאשר המפענח
ניסה ליצור את מפענח ה-hw בהצלחה. כמו כן, מפענחי hw עם -עותק
הסיומת תחזור לא בזמן ששום סרטון לא מפוענח. כל זה משקף איך
זיהוי מפענחי hw מזוהים ונעשה בהם שימוש פנימי ב-mpv.

סריקה במחבת (RW)
לִרְאוֹת --סריקה במחבת.

פורמט וידאו
פורמט וידאו כמחרוזת.

Codec וידאו
נבחר codec וידאו לפענוח.

רוֹחַב, גובה
גודל סרטון. זה משתמש בגודל של הסרטון כפי שפוענח, או אם אין מסגרת וידאו
פוענח עדיין, המיכל (אולי לא נכון) ציין את הגודל.

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

וידאו-פרמטרים/פיקסלפורמט
פורמט הפיקסלים כמחרוזת. זה משתמש באותם שמות כמו במקומות אחרים
של mpv.

video-params/average-bpp
סיביות ממוצעות לפיקסל כמספר שלם. פורמטים מישוריים שנדגמו משנה משתמשים בפורמט שונה
רזולוציה, וזו הסיבה שהערך הזה לפעמים יכול להיות מוזר או
מְבַלבֵּל. יכול להיות לא זמין בפורמטים מסוימים.

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

וידאו-params/w, פרמטרים של וידאו/שעה
גודל הסרטון כמספרים שלמים, ללא תיקון גובה-רוחב.

video-params/dw, video-params/dh
גודל הסרטון כמספרים שלמים, בקנה מידה ליחס רוחב-גובה נכון.

פרמטרים/היבט וידאו
הצג יחס רוחב-גובה כצף.

video-params/par
יחס רוחב-גובה של פיקסל.

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

פרמטרים / רמות צבע
רמות הצבע כמחרוזת. (הערכים המדויקים עשויים להשתנות.)

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

וידאו-פראמים/גמא
פונקציית הגמא בשימוש כמחרוזת. (הערכים המדויקים עשויים להשתנות.)

video-params/chroma-location
מיקום Chroma כמחרוזת. (הערכים המדויקים עשויים להשתנות.)

פרמטרים של וידאו/סיבוב
סיבוב התצוגה המיועד במעלות (בכיוון השעון).

פרמטרים של וידאו/סטריאו-אין
מצב סטריאו 3D קובץ מקור. (לִרְאוֹת --מצב וידאו-סטריאו אוֹפְּצִיָה.)

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_MAP
"פורמט פיקסל" MPV_FORMAT_STRING
"w" MPV_FORMAT_INT64
"h" MPV_FORMAT_INT64
"dw" MPV_FORMAT_INT64
"dh" MPV_FORMAT_INT64
"היבט" MPV_FORMAT_DOUBLE
"par" MPV_FORMAT_DOUBLE
"colormatrix" MPV_FORMAT_STRING
"רמות צבע" MPV_FORMAT_STRING
"primarys" MPV_FORMAT_STRING
"chroma-location" MPV_FORMAT_STRING
"סובב" MPV_FORMAT_INT64
"סטריאו-אין" MPV_FORMAT_STRING

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

אלה בעלי אותם ערכים כמו וידאו-out-params/dw ו וידאו-out-params/dh.

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

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

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

מאפייני משנה:

video-frame-info/picture-type video-frame-info/interlaced video-frame-info/tff
video-frame-info/repeat

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

estimated-vf-fps
FPS משוער/מדוד של פלט שרשרת מסנן הווידאו. (אם לא נעשה שימוש במסננים,
זה מתאים לפלט המפענח.) זה משתמש בממוצע של 10 המסגרת בעבר
משכי זמן לחישוב ה-FPS. זה יהיה לא מדויק אם מדובר בהורדת פריימים
(כגון כאשר framedrop מופעל במפורש, או לאחר חיפוש מדויק). קבצים
עם חותמות זמן לא מדויקות (כגון Matroska) עלול להוביל לתוצאות לא יציבות.

בקנה מידה חלונות (RW)
מכפיל גודל חלון. הגדרה זו תשנה את גודל חלון הווידאו לערכים
הכלול ב רוחב ו dheight מוכפל בערך שהוגדר עם מאפיין זה.
הגדרת 1 ישנה את הגודל לגודל הסרטון המקורי (או ליתר דיוק, את גודל הסרטון
פלט מסננים). 2 יקבע את הגודל הכפול, 0.5 מחצה את הגודל.

חלון ממוזער
החזר אם חלון הווידאו ממוזער או לא.

שמות תצוגה
שמות הצגים שחלון mpv מכסה. ב-X11, אלו הם ה-xrandr
שמות (LVDS1, HDMI1, DP1, VGA1 וכו').

display-fps (RW)
קצב הרענון של התצוגה הנוכחית. נכון לעכשיו, זהו ה-FPS הנמוך ביותר מכל אחד
תצוגה מכוסה על ידי הסרטון, כפי שאוחזר על ידי ממשקי ה-API של המערכת (למשל
xrandr ב-X11). זה לא ה-FPS הנמדד. זה לא בהכרח זמין בכולם
פלטפורמות. שים לב שכל אחת מהעובדות המפורטות עשויה להשתנות בכל עת ללא אזהרה.

אומדן-display-fps
זמין רק אם מצב סנכרון תצוגה (כפי שנבחר על ידי --סנכרון וידאו) פעיל.
מחזירה את הקצב בפועל שבו נראה כי רענון התצוגה מתרחש, נמדד לפי
זמן מערכת.

vsync-jitter
גורם סטייה משוער של משך ה-vsync.

היבט וידאו (RW)
היבט וידאו, ראה --היבט וידאו.

רוחב osd, osd-height
רוחב ה-OSD האחרון הידוע (יכול להיות 0). זה נחוץ אם אתה רוצה להשתמש ב- overlay_add
פקודה. זה נותן לך את גודל ה-OSD האמיתי, שיכול להיות שונה מהחלון
גודל במקרים מסוימים.

osd-par
היבט פיקסל של תצוגת OSD האחרון הידוע (יכול להיות 0).

vid (RW)
רצועת וידאו נוכחית (דומה ל --vid).

וידאו (RW)
כינוי עבור vid.

video-align-x, video-align-y (RW)
לִרְאוֹת --video-align-x ו --video-align-y.

video-pan-x, video-pan-y (RW)
לִרְאוֹת --video-pan-x ו --video-pan-y.

זום וידאו (RW)
לִרְאוֹת -- וידאו-זום.

וידאו ללא קנה מידה (W)
לִרְאוֹת -- וידאו ללא קנה מידה.

התוכנית (W)
החלף תוכנית TS (לכתיבה בלבד).

סיד (RW)
רצועת כתוביות נוכחית (דומה ל --סיד).

משני-צד (RW)
רצועת כתוביות משנית (ראה --צד משני).

להלן (RW)
כינוי עבור סיד.

עיכוב משנה (RW)
לִרְאוֹת --תת עיכוב.

תת-תפקידים (RW)
לִרְאוֹת --תת-פוזי.

נראות משנה (RW)
לִרְאוֹת --נראות משנה.

תת-כפוי בלבד (RW)
לִרְאוֹת --תת-כפוי בלבד.

תת סולם (RW)
מכפיל גודל גופן כתוביות.

תחת-כוח-שוליים (RW)
לִרְאוֹת ---ass-force-margins.

שולי תת-שימוש (RW)
לִרְאוֹת --תת-שימוש-שוליים.

ass-vsfilter-aspect-compat (RW)
לִרְאוֹת --ass-vsfilter-aspect-compat.

עקיפה בסגנון התחת (RW)
לִרְאוֹת --עקיפה בסגנון התחת.

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

בהירות טלוויזיה, ניגודיות טלוויזיה, רוויה בטלוויזיה, tv-hue (RW)
דברים בטלוויזיה.

פלייליסט-פוז (RW)
מיקום נוכחי ברשימת ההשמעה. הערך הראשון הוא בעמדה 0. כתיבה ל-
המאפיין יפעיל מחדש את ההשמעה ברשומה הכתובה.

ספירת רשימות השמעה
מספר סך כל הרשומות בפלייליסט.

רשימת השמעה
רשימת השמעה, הערך הנוכחי מסומן. נכון לעכשיו, ערך הנכס הגולמי חסר תועלת.

יש לזה מספר מאפייני משנה. החלף N עם ערך רשימת השמעה מבוסס 0
אינדקס.

רשימת השמעה/ספירה
מספר רשומות הפלייליסט (זהה ל ספירת רשימות השמעה).

רשימת השמעה/N/שם קובץ
שם הקובץ של הערך ה-N.

רשימת השמעה/N/נוכחית, רשימת השמעה/N/משחק
כן אם ערך זה מופעל כעת (או נטען). לא זמין או לא
אחרת. בעת שינוי קבצים, נוֹכְחִי ו משחק יכול להיות שונה,
מכיוון שהקובץ המתנגן כרגע לא נפרק עדיין; במקרה הזה,
נוֹכְחִי מתייחס לבחירה החדשה. (מאז mpv 0.7.0.)

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

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל רשומת פלייליסט)
"שם קובץ" MPV_FORMAT_STRING
"נוכחי" MPV_FORMAT_FLAG (ייתכן שחסר; מאז mpv 0.7.0)
"מנגן" MPV_FORMAT_FLAG (אותו)
"כותרת" MPV_FORMAT_STRING (אופציונלי)

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

יש לזה מספר מאפייני משנה. החלף N עם מדד המסלול מבוסס 0.

רשימת רצועות/ספירה
מספר כולל של רצועות.

track-list/N/id
תעודת הזהות כפי שהיא משמשת צד/--סיוע/--vid. זה ייחודי בתוך רצועות של
אותו סוג (משנה/שמע/וידאו), אבל אחרת לא.

רשימת רצועות/N/סוג
מחרוזת המתארת ​​את סוג המדיה. אחד מ אודיו, וידאו, להלן.

track-list/N/src-id
מזהה מסלול כפי שנעשה בו שימוש בקובץ המקור. לא תמיד זמין.

רשימת רצועות/N/כותרת
כותרת הרצועה כפי שהיא מאוחסנת בקובץ. לא תמיד זמין.

רשימת רצועות/N/lang
עקוב אחר השפה כפי שזוהתה על ידי הקובץ. לא תמיד זמין.

רשימת רצועות/N/ערוצי אודיו
עבור רצועות שמע, מספר ערוצי השמע בזרם השמע. לֹא
תמיד מדויק (תלוי ברמזים למיכל). לא תמיד זמין.

רשימת רצועות/N/אלבום אלבום
כן אם זהו רצועת וידאו המורכבת מתמונה בודדת, לא or
לא זמין אחרת. זה משמש עבור רצועות וידאו שהם באמת
תמונות מצורפות בקבצי אודיו.

רשימת רצועות/N/ברירת מחדל
כן אם למסלול מוגדר דגל ברירת המחדל בקובץ, לא אחרת.

רשימת רצועות/N/מאולץ
כן אם למסלול יש את הדגל הכפוי בקובץ, לא אחרת.

רשימת רצועות/N/codec
שם ה-codec המשמש את המסלול הזה, למשל h264. לא זמין בחלקם
מקרים נדירים.

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

track-list/N/external-filename
שם הקובץ אם הרצועה היא מקובץ חיצוני, לא זמין אחרת.

רשימת רצועות/N/נבחרה
כן אם הרצועה מפוענחת כעת, לא אחרת.

track-list/N/ff-index
אינדקס הזרם כפי שמשתמשים בו בדרך כלל על ידי כלי השירות FFmpeg. שימו לב שזה יכול
יכול להיות שגוי אם מכשיר דה-מקס שונה מ-libavformat (--demuxer=lavf) הוא
בשימוש. עבור קבצי mkv, האינדקס בדרך כלל יתאים גם אם ברירת המחדל
נעשה שימוש ב-demuxer (מובנה), אך אין אחריות קשה.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל רצועה)
"מזהה" MPV_FORMAT_INT64
"הקלד" MPV_FORMAT_STRING
"src-id" MPV_FORMAT_INT64
"כותרת" MPV_FORMAT_STRING
"lang" MPV_FORMAT_STRING
"ערוצי שמע" MPV_FORMAT_INT64
"אלבום ארט" MPV_FORMAT_FLAG
"ברירת מחדל" MPV_FORMAT_FLAG
"מאולץ" MPV_FORMAT_FLAG
"חיצוני" MPV_FORMAT_FLAG
"שם קובץ חיצוני" MPV_FORMAT_STRING
"קודק" MPV_FORMAT_STRING

רשימת פרקים
רשימת פרקים, הערך הנוכחי מסומן. נכון לעכשיו, ערך הנכס הגולמי הוא
חסר תועלת.

יש לזה מספר מאפייני משנה. החלף N עם אינדקס פרק מבוסס 0.

רשימת פרקים/ספירה
מספר פרקים.

רשימת פרק/N/כותרת
כותרת הפרק כפי שמאוחסנת בקובץ. לא תמיד זמין.

רשימת פרקים/N/זמן
זמן תחילת הפרק בשניות כמו צף.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל פרק)
"כותרת" MPV_FORMAT_STRING
"זמן" MPV_FORMAT_DOUBLE

af (RW)
לִרְאוֹת --af ו af פקודה.

vf (RW)
לִרְאוֹת --vf ו vf פקודה.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל ערך מסנן)
"שם" MPV_FORMAT_STRING
"תווית" MPV_FORMAT_STRING [אופציונלי]
"params" MPV_FORMAT_NODE_MAP [אופציונלי]
"מפתח" MPV_FORMAT_STRING
"ערך" MPV_FORMAT_STRING

אפשר גם לכתוב את המאפיין בפורמט זה.

סיבוב וידאו (RW)
לִרְאוֹת --סיבוב וידאו אוֹפְּצִיָה.

ניתן לחפש
החזר אם זה אפשרי בדרך כלל לחפש בקובץ הנוכחי.

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

אם מאפיין זה מחזיר אמת, ניתן לחפש גם יחזור אמיתי.

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

הסמן-הסתר אוטומטי (RW)
לִרְאוֹת --cursor-autohide. הגדרה זו לערך חדש תמיד תעדכן את הסמן,
ואפס את הטיימר הפנימי.

osd-sym-cc
מכניס את סמל ה-OSD הנוכחי כקוד בקרה אטום ב-OSD (cc). זה הגיוני
רק עם הצג-טקסט פקודה או אפשרויות שמגדירות הודעות OSD. השליטה
הקוד הוא יישום ספציפי והוא חסר תועלת לכל דבר אחר.

osd-ass-cc
${osd-ass-cc/0} משבית בריחה של רצפי ASS של טקסט ב-OSD, ${osd-ass-cc/1}
מאפשר זאת שוב. כברירת מחדל, רצפי ASS מופעלים על מנת להימנע מקריות
עיצוב, ומאפיין זה יכול להשבית התנהגות זו. שימו לב שהמאפיינים
להחזיר קוד בקרה OSD אטום, וזה הגיוני רק עבור הצג-טקסט הפקודה
או אפשרויות שמגדירות הודעות OSD.

דוגמה

· --osd-status-msg='זה is ${osd-ass-cc/0}{\\b1}מודגש טֶקסט'

· הצג-טקסט "זֶה is ${osd-ass-cc/0}{\b1}מודגש טֶקסט"

ניתן להשתמש בכל תגי עקיפת ASS כפי שהם מבינים על ידי libass.

שים לב שאתה צריך לברוח מה \ תו, מכיוון שהמחרוזת מעובדת עבור C
רצפי בריחה לפני העברתם לקוד ה-OSD.

רשימה של תגים ניתן למצוא כאן: http://docs.aegisub.org/latest/ASS_Tags/

vo-configured
החזר אם ה-VO מוגדר כעת. בדרך כלל זה מתאים לשאלה אם
חלון הווידאו גלוי. אם ה --חלון כוח נעשה שימוש באפשרות, זה בדרך כלל
תמיד חוזר כן.

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

היחידה היא ביטים לשנייה. עיצוב OSD הופך את הערכים האלה בקילוביט (או
מגה-ביט, אם מתאים), שניתן למנוע על ידי שימוש בערך המאפיין הגולמי,
למשל עם ${=video-bitrate}.

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

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

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

packet-video-bitrate, packet-audio-bitrate, קצב-משנה של מנות
נכסים ישנים ומוותרים עבור קצב העברת וידאו, bitrate אודיו, תת-קצב סיביות. הֵם
מתנהגים בדיוק אותו הדבר, אבל מחזירים ערך בקילוביט. כמו כן, אין להם
עיצוב OSD, אם כי ניתן להשיג אותו הדבר עם למשל ${=video-bitrate}.

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

רשימת התקני שמע
החזר את רשימת התקני האודיו שהתגלו. זה בעיקר לשימוש עם הלקוח
API, ומשקף מה --audio-device=help עם שורת הפקודה חוזר נגן.

בעת שאילתה על הנכס עם ה-API של הלקוח באמצעות MPV_FORMAT_NODE, או עם לואה
mp.get_property_native, זה יחזיר mpv_node עם התוכן הבא:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (עבור כל ערך מכשיר)
"שם" MPV_FORMAT_STRING
"תיאור" MPV_FORMAT_STRING

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

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

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

מכשיר אודיו (RW)
הגדר את התקן השמע. זה קורא/כותב ישירות את --מכשיר אודיו אפשרות, אבל על
גישה לכתיבה, פלט האודיו יתוזמן לטעינה מחדש.

כתיבת מאפיין זה בזמן שאין פלט אודיו פעיל לא תאפשר אוטומטית
שֶׁמַע. (זה נכון גם במקרה שבו האודיו הושבת עקב
כשל באתחול מחדש לאחר גישת כתיבה קודמת ל מכשיר אודיו.)

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

אופן הטיפול בפרטים אלו עשוי להשתנות בעתיד.

הנוכחי-ו
מנהל התקן פלט וידאו נוכחי (שם בשימוש עם --ו).

הנוכחי-ao
מנהל התקן פלט אודיו נוכחי (שם בשימוש עם --ao).

אודיו-out-detected-device
החזר את התקן האודיו שנבחר על ידי מנהל ההתקן של AO (מיושם רק בחלקם
נהגים: כרגע בלבד קוראודיו).

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

רשימת פרוטוקול
רשימת קידומות פרוטוקולים שיכולות להיות מזוהות על ידי השחקן. הם מוחזרים
בלי נגרר :/ / סיומת (שעדיין נדרשת תמיד). במקרים מסוימים, ה
הפרוטוקול לא יתמך בפועל (שקול https אם ffmpeg אינו הידור
עם תמיכת TLS).

גרסת mpv
החזר את גרסת mpv/מחרוזת זכויות יוצרים. תלוי איך הבינארי נבנה, זה
עשוי להכיל גרסת שחרור, או רק hash של git.

תצורת mpv
החזר את ארגומנטי התצורה שהועברו למערכת ה-build (בדרך כלל
הדרך ./ואף להגדיר ... הופעל).

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

file-local-options/
דומה אפשרויות/, אבל כשמגדירים אפשרות דרך מאפיין זה, ה
האפשרות מאופסת לערך הישן שלה לאחר שהקובץ הנוכחי הפסיק לפעול. מנסה
כתיבת אפשרות בזמן ששום קובץ לא מופעל (או נטען) מביא ל-
שגיאה.

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

אפשרות-מידע/
מידע נוסף לכל אופציה.

יש לזה מספר מאפייני משנה. החלף עם שם של רמה עליונה
אוֹפְּצִיָה. לא ניתנת ערובה ליציבות לאף אחד מתתי המאפיינים הללו - הם
עשוי להשתנות באופן קיצוני בתכונה.

אפשרות-מידע/ /שֵׁם
מחזירה את שם האפשרות.

אפשרות-מידע/ /סוּג
החזר את השם של סוג האופציה, כמו מחרוזת or מספר שלם. לרבים
סוגים מורכבים, זה לא מאוד מדויק.

אפשרות-מידע/ /set-from-commandline
לחזור כן אם האפשרות הוגדרה משורת הפקודה mpv, לא אחרת.
מה זה מוגדר אם האפשרות משתנה למשל בזמן ריצה נשאר
לא מוגדר (כלומר זה יכול להשתנות בעתיד).

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

אפשרות-מידע/ /ערך ברירת מחדל
ערך ברירת המחדל של האפשרות. אולי לא תמיד זמין.

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

אפשרות-מידע/ /בחירות
אם האפשרות היא אפשרות בחירה, האפשרויות האפשריות. בחירות שכן
מספרים שלמים עשויים להיכלל או לא (ניתן לרמוז על ידי דקות ו מקסימום).
שים לב שאפשרויות שמתנהגות כמו אפשרויות בחירה, אך אינן בפועל
אפשרויות בחירה פנימיות, ייתכן שלא יהיה מידע זה זמין.

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

נכס הרחבה
כל ארגומנטי המחרוזת לפקודות קלט כמו גם אפשרויות מסוימות (כמו
--term-playing-sg) כפופים להרחבת הנכס. שימו לב שהרחבת הנכס כן
לא יעבוד במקומות שבהם צפויים פרמטרים מספריים למשל. (לדוגמה, ה להוסיף
הפקודה לא עושה הרחבת נכס. ה סט פקודה היא חריג ולא כללי
כְּלָל.)

דוגמה עבור input.conf

i הצג-טקסט שם קובץ: ${filename}
מציג את שם הקובץ של הקובץ הנוכחי בעת לחיצה על i מפתח

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

ההרחבות הבאות נתמכות:

${NAME}
מתרחב לערך הנכס שֵׁם. אם אחזור הנכס נכשל, הרחב
למחרוזת שגיאה. (להשתמש ${NAME:} עם נגרר : כדי להרחיב למחרוזת ריקה
במקום זאת.) אם שֵׁם יש קידומת עם =, הרחב לערך הגולמי של הנכס (ראה
הסעיף למטה).

${NAME:STR}
מתרחב לערך הנכס שֵׁם, או STR אם הנכס לא יכול להיות
הוחזר. STR מורחב באופן רקורסיבי.

${?NAME:STR}
מתרחב ל STR (רקורסיבית) אם הנכס שֵׁם זמין.

${!NAME:STR}
מתרחב ל STR (רקורסיבית) אם הנכס שֵׁם לא ניתן לאחזר.

${?NAME==VALUE:STR}
מתרחב ל STR (רקורסיבית) אם הנכס שֵׁם מתרחב למחרוזת השווה ל
ערך. אתה יכול לעשות קידומת שֵׁם עם = על מנת להשוות את הערך הגולמי של נכס
(ראה סעיף למטה). אם הנכס אינו זמין, או שגיאות אחרות מתרחשות כאשר
משחזר אותו, הערך לעולם לא נחשב שווה. שים לב ש ערך לא יכול להכיל
כל אחת מהדמויות : or }. כמו כן, ייתכן כי לברוח עם " or % יכול
יתווסף בעתיד, אם יתעורר הצורך.

${!NAME==VALUE:STR}
אותו דבר כמו עם ? גרסה, אבל STR מורחב אם הערך אינו שווה. (באמצעות
אותה סמנטיקה כמו עם ?.)

$$ מתרחב ל $.

$} מתרחב ל }. (כדי לייצר דמות זו בתוך התרחבות רקורסיבית.)

$> השבתת הרחבת נכס וטיפול מיוחד ב $ עבור שאר המחרוזת.

במקומות שבהם מותרת הרחבת נכס, לרוב מתקבלות גם בריחה בסגנון C.
דוגמא:

· \n הופך לדמות חדשה

· \\ מתרחב ל \

חי ו מעוצב פרויקטים
בדרך כלל, מאפיינים מעוצבים כטקסט הניתן לקריאה על ידי אדם, שנועדו להיות מוצג ב-OSD או
על הטרמינל. אפשר לשלוף ערך לא מעוצב (גולמי) מנכס על ידי
קידומת השם שלו =. ניתן לנתח ערכים גולמיים אלה על ידי תוכניות אחרות ולעקוב אחר הערכים
אותן מוסכמות כמו האפשרויות המשויכות לנכסים.

דוגמאות

· ${time-pos} מתרחב ל 00:14:23 (אם מיקום ההשמעה הוא 14 דקות 23 שניות)

· ${=time-pos} מתרחב ל 863.4 (אותו זמן, בתוספת 400 אלפיות שניות - אלפיות שניות הן
בדרך כלל לא מוצג ברישיות המעוצבות)

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

ON מסך בקר

הבקר על המסך (קיצור: OSC) הוא GUI מינימלי המשולב עם mpv כדי להציע בסיסי
יכולת שליטה בעכבר. זה נועד להקל על האינטראקציה עבור משתמשים חדשים ו-ל
לאפשר חיפוש מדויק וישיר.

ה-OSC מופעל כברירת מחדל אם mpv הידור עם תמיכת Lua. זה יכול להיות מושבת
משתמש לחלוטין ב --osc=לא אוֹפְּצִיָה.

שימוש מה היא CSO
כברירת מחדל, ה-OSC יופיע בכל פעם שהעכבר מועבר בתוך חלון הנגן ו
יתחבא אם העכבר לא יוזז מחוץ ל-OSC למשך 0.5 שניות או אם העכבר עוזב
החלון.

השמיים מִמְשָׁק
+----------------+------------+-------------------- --+
| פלייליסט הקודם | כותרת | רשימת השמעה הבאה |
+-------+------+----+--+------+-+----+------+------ --+
| אודיו | דלג | לחפש | | לחפש | דלג | מלא |
+-------+ חזרה | חזרה | לשחק | frwd | frwd | מסך |
| תת | | | | | | |
+-------+------+-------+--------------+------+------ --+
| seekbar |
+----------------+---------------+----------------- --+
| הזמן עבר | מצב מטמון | הזמן שנותר |
+----------------+---------------+----------------- --+

רשימת השמעה קודם

───────────────┬─────────────────────
│ לחיצה ימנית │ הפעל את הקובץ הקודם ברשימת ההשמעה │
───────────────┼─────────────────────────
│ Shift+L-לחץ │ הצג רשימת השמעה │
│

כותרת
מציג כותרת מדיה או שם קובץ נוכחיים

─────────────┬────────────────────────
│ לחיצה ימנית │ הצג את מיקום רשימת ההשמעה ו│
│ │ אורך וכותרת מלאה │
├────────────┼─────────────────────────────
│ קליק ימני │ הצג את שם הקובץ │
│

רשימת השמעה הבא

┌──────────────┬──────────────────
│ לחיצה ימנית │ הפעל את הקובץ הבא ברשימת ההשמעה │
├──────────────┼────────────────────────────
│ Shift+L-לחץ │ הצג רשימת השמעה │
└──────────────┴──────────────────────────

אודיו ו להלן
מציג את הרצועה שנבחרה ואת כמות הרצועות הזמינות

┌──────────────┬────────────────────────────────── ┐
│ לחיצה ימנית │ העבר רצועות שמע/משנה קדימה │
├──────────────┼────────────────────────────────── ┤
│ לחיצה ימנית │ מחזור רצועות אודיו/משנה לאחור │
├──────────────┼────────────────────────────────── ┤
│ Shift+L-לחץ │ הצג רצועות שמע/משנה זמינות │
└──────────────┴────────────────────────────────── ┘

לדלג בחזרה

┌──────────────┬────────────────────────────────── ┐
│ קליק שמאל │ עבור לתחילת הפרק / │
│ │ הפרק הקודם │
├──────────────┼────────────────────────────────── ┤
│ Shift+L-לחץ │ הצג פרקים │
└──────────────┴────────────────────────────────── ┘

לחפש בחזרה

┌──────────────┬────────────────────
│ קליק שמאל │ דלג אחורה 5 שניות │
├──────────────┼────────────────────
│ קליק ימני │ דלג אחורה 30 שניות │
├──────────────┼────────────────────
│ Shift-L-לחץ │ דלג אחורה מסגרת אחת │
└──────────────┴─────────────────────

לשחק

┌───────────┬───────────────────
│ לחיצה שמאלית │ החלפת הפעלה/השהיה │
└───────────┴───────────────────

לחפש frwd

┌──────────────┬────────────────────────
│ קליק שמאל │ דלג קדימה 10 שניות │
├──────────────┼─────────────────────────
│ קליק ימני │ דלג קדימה 60 שניות │
├──────────────┼─────────────────────────
│ Shift-L-לחץ │ דלג קדימה מסגרת אחת │
└──────────────┴─────────────────────────

לדלג frwd

┌──────────────┬───────────────────
│ קליק שמאל │ עבור לפרק הבא │
├──────────────┼───────────────────
│ Shift+L-לחץ │ הצג פרקים │
└──────────────┴─────────────────────

מסך מלא

┌───────────┬───────────────────
│ לחיצה ימנית │ החלפת מסך מלא │
└───────────┴───────────────────

seekbar
מציין את מיקום ההשמעה הנוכחי ומיקום הפרקים

┌───────────┬──────────────────┐
│ לחיצה ימנית │ חפש למיקום │
└───────────┴───────────────────

זמן עבר
מציג חותמת זמן של מיקום ההשמעה הנוכחי

────────────┬────────────────────────
│ לחיצה ימנית │ החלף את הצגת קודי הזמן עם │
│ │ אלפיות שניות │
└───────────┴─────────────────────────

מטמון מצב
מציג את סטטוס מילוי המטמון הנוכחי (נראה רק כאשר מתחת ל-45%)

זמן נותר
מציג את חותמת זמן ההפעלה שנותרה

────────────┬────────────────────────
│ לחיצה ימנית │ לעבור בין סך ל- │
│ │ זמן שנותר │
└───────────┴─────────────────────────

מפתח כריכות
כריכות מקשים אלו פעילות כברירת מחדל אם שום דבר אחר כבר לא קשור למפתחות אלו.
במקרה של התנגשות, הפונקציה צריכה להיות קשורה למפתח אחר. ראה את תסריט
פקודות סָעִיף.

┌────┬──────────────────────────────────
│del │ הסתר את ה-OSC לצמיתות עד │
│ │ mpv מופעל מחדש. │
└────┴───────────────────────────────────

תְצוּרָה
ה-OSC מציע תצורה מוגבלת באמצעות קובץ תצורה lua-settings/osc.conf ממוקם ב
מנהל המשתמש של mpv ודרך ה --script-opts אפשרות שורת הפקודה. אפשרויות הניתנות דרך
שורת הפקודה תעקוף את אלה מקובץ התצורה.

Config תחביר
קובץ התצורה חייב לעקוב בדיוק אחר התחביר הבא:

# זו תגובה
optionA=value1
optionB=value2

# ניתן להשתמש רק בתחילת שורה וייתכן שלא יהיו רווחים מסביב ל = or
בכל מקום אחר.

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

דוגמא:

--script-opts=osc-optionA=value1,osc-optionB=value2

להגדרה אפשרויות
בחלון ראווה
ברירת מחדל: כן
הפעל את ה-OSC בחלון

הצג מסך מלא
ברירת מחדל: כן
הפעל את ה-OSC במסך מלא

scalewindowed
ברירת מחדל: 1.0
גורם קנה המידה של ה-OSC בעת חלון

מסך מלא
ברירת מחדל: 1.0
גורם קנה מידה של ה-OSC במסך מלא

חלון מאולץ בקנה מידה
ברירת מחדל: 2.0
גורם קנה מידה של ה-OSC כאשר הוא מוצג על חלון מאולץ (דמה).

vidscale
ברירת מחדל: כן
שנה את ה-OSC עם הסרטון
לא מנסה לשמור על גודל OSC קבוע ככל שגודל החלון מאפשר

valign
ברירת מחדל: 0.8
יישור אנכי, -1 (למעלה) ל-1 (למטה)

הליגן
ברירת מחדל: 0.0
יישור אופקי, -1 (שמאל) עד ​​1 (ימין)

בוקסלפא
ברירת מחדל: 80
אלפא של תיבת הרקע, 0 (אטום) עד 255 (שקוף לחלוטין)

זמן הסתרה
ברירת מחדל: 500
משך ב-ms עד שה-OSC מסתיר אם אין תנועת עכבר, ערך שלילי
משבית הסתרה אוטומטית

דעיכה
ברירת מחדל: 200
משך הדעיכה ב-ms, 0 = ללא דהייה

גודל אזורי מת
ברירת מחדל: 0
גודל אזור המתים. אזור המתים הוא אזור שגורם לעכבר לפעול
כמו לצאת מהחלון. תנועה לשם לא תגרום ל-OSC להופיע ו
הוא יסתתר מיד אם העכבר ייכנס אליו. אזור המתים מתחיל
בגבול החלון שממול ל-OSC והגודל שולט בכמה
של החלון שהוא יתפרש. ערכים בין 0 ל-1.

minmousemove
ברירת מחדל: 3
כמות מינימלית של פיקסלים שעל העכבר לעבור בין תקלות כדי ליצור
ה-OSC מופיע

פריסה
ברירת מחדל: תיבה
הפריסה עבור OSC. הזמינים כרגע הם: קופסה, slimbox,
סרגל תחתון וסרגל עליון.

seekbarstyle
ברירת מחדל: מחוון
מגדיר את הסגנון של סרגל החיפוש, המחוון (סמן יהלומים) או סרגל (מילוי)

סה"כ זמן
ברירת מחדל: לא
הצג את הזמן הכולל במקום את הזמן שנותר

זמנים
ברירת מחדל: לא
הצג קודי זמן עם אלפיות שניות

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

enable-osc
מבטל disable-osc או ההשפעה של דל מַפְתֵחַ.

disable-osc
הסתר את ה-OSC לצמיתות. זה גם מה ש דל מפתח עושה זאת.

osc-הודעה
הצג הודעה על המסך באמצעות OSC. טיעון ראשון הוא המסר, שני הטיעון
משך בשניות.

דוגמה

אתה יכול להכניס את זה input.conf כדי להסתיר את ה-OSC עם a מפתח ולחשוף אותו באמצעותו b:

a script_message disable-osc
b script_message enable-osc

LUA סקריפט

mpv יכול לטעון סקריפטים של Lua. סקריפטים הועברו ל- --תַסרִיט אפשרות, או נמצא ב- סקריפטים
ספריית משנה של ספריית תצורת mpv (בדרך כלל ~/.config/mpv/scripts/) יהיה
נטען עם תחילת התוכנית. mpv מוסיף גם את סקריפטים ספריית משנה לסוף של Lua
נתיב כך שתוכל לייבא סקריפטים גם משם. מכיוון שהוא נוסף עד הסוף, אל תכתוב שם
סקריפטים שברצונך לייבא זהה לספריות Lua מכיוון שהם יהיו בצל
אותם.

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

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

דוגמה
סקריפט שיוצא ממצב מסך מלא כאשר הנגן מושהה:

function on_pause_change(שם, ערך)
אם ערך == נכון אז
mp.set_property("מסך מלא", "לא")
סוף
סוף
mp.observe_property("pause", "bool", on_pause_change)

פרטים on מה היא תסריט אתחול ו מעגל החיים
הסקריפט שלך ייטען על ידי הנגן עם תחילת התוכנית מה- סקריפטים תצורה
ספריית משנה, או מנתיב שצוין עם ה- --תַסרִיט אוֹפְּצִיָה. כמה סקריפטים נטענים
פנימית (כמו --osc). כל סקריפט פועל בשרשור משלו. הסקריפט שלך מופעל תחילה "כמו
is", וברגע שזה נעשה, נכנסת לולאת האירועים. לולאת אירוע זו תישלח
אירועים שהתקבלו על ידי mpv והתקשרו למטפלי האירועים שלכם שאיתם נרשמתם
mp.register_event, או טיימרים שנוספו עם mp.add_timeout או דומה.

כאשר השחקן יוצא, כל התסריטים יתבקשו להפסיק. זה קורה דרך א כיבוי
event, אשר כברירת מחדל יגרום ללולאת האירוע לחזור. אם התסריט שלך נכנס ל-
לולאה אינסופית, mpv כנראה יתנהג בסדר במהלך ההשמעה (אלא אם כן הנגן
מושעה, ראה mp.suspend), אך הוא לא יסתיים בעת יציאה, כי הוא ממתין
התסריט שלך.

באופן פנימי, קוד C יקרא לפונקציה Lua mp_event_loop לאחר טעינת Lua
תַסרִיט. פונקציה זו מוגדרת בדרך כלל על ידי קדם ברירת המחדל שנטען לפני הסקריפט שלך
(ראה player/lua/defaults.lua במקורות mpv). לופ האירוע ימתין לאירועים ו
אירועי שיגור שנרשמו עם mp.register_event. זה גם יטפל בטיימרים שנוספו איתם
mp.add_timeout ודומה (על ידי המתנה עם פסק זמן).

מאז mpv 0.6.0, הנגן ימתין עד שהסקריפט ייטען במלואו לפני שימשיך
פעולה רגילה. השחקן מחשיב סקריפט כטעון במלואו ברגע שהוא מתחיל
מחכה לאירועי mpv (או שהוא יוצא). בפועל זה אומר שהשחקן יהיה פחות או יותר
נתקע עד שהתסריט יחזור מהנתח הראשי (ו mp_event_loop נקרא), או ה
שיחות תסריט mp_event_loop or mp.dispatch_events בצורה ישירה. זה נעשה כדי לעשות את זה
אפשר לסקריפט להגדיר באופן מלא מטפלים באירועים וכו' לפני שההשמעה מתחילה בפועל.
בגרסאות mpv ישנות יותר, זה קרה באופן אסינכרוני.

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

mp.command(string)
הפעל את הפקודה הנתונה. זה דומה לפקודות המשמשות ב-input.conf. לִרְאוֹת
רשימה of קֶלֶט פקודות.

כברירת מחדל, זה יראה משהו ב-OSD (בהתאם לפקודה), כאילו
זה שימש ב input.conf. לראות קֶלֶט פיקוד קידומות כיצד להשפיע על השימוש ב-OSD
לכל פקודה.

החזרים נָכוֹן על הצלחה, או אפס, שגיאה על טעות.

mp.commandv(arg1, arg2, ...)
דומה mp.command, אבל העבר כל ארגומנט פקודה כפרמטר נפרד. זֶה
יש את היתרון שאתה לא צריך לדאוג לצטט ולברוח בחלק
במקרים.

דוגמא:

mp.command("loadfile " .. שם קובץ .. " append")
mp.commandv("loadfile", שם קובץ, "append")

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

שימו לב שמאפיינים הם לֹא מוּרחָב. אתה יכול להשתמש בשניהם mp.command, ה
להרחיב-מאפיינים קידומת, או את mp.get_property משפחת פונקציות.

שונה mp.command, גם זה לא ישתמש ב-OSD כברירת מחדל (למעט חלק
פקודות ספציפיות ל-OSD).

mp.command_native(table [,def])
דומה mp.commandv, אבל העבר את רשימת הארגומנטים כטבלה. יש לזה יתרון
שלפחות בחלק מהמקרים ניתן להעביר טיעונים כטיפוסים מקומיים.

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

mp.get_property(name [,def])
החזר את הערך של המאפיין הנתון כמחרוזת. אלה אותם מאפיינים כמו
בשימוש ב-input.conf. לִרְאוֹת פרויקטים לרשימת נכסים. המחרוזת המוחזרת היא
בפורמט דומה ל ${=name} (ראה נכס הרחבה).

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

mp.get_property_osd(name [,def])
דומה mp.get_property, אך החזר את ערך המאפיין המעוצב עבור OSD. זֶה
היא אותה מחרוזת כמו שהודפסה איתה $ {name} בשימוש ב-input.conf.

מחזיר את המחרוזת על הצלחה, או דפ, שגיאה על טעות. def הוא הפרמטר השני
מסופק לפונקציה, והוא מחרוזת ריקה אם היא חסרה. בניגוד
get_property(), הקצאת ערך ההחזרה למשתנה תמיד תגרום ל-a
מחרוזת.

mp.get_property_bool(name [,def])
דומה mp.get_property, אך החזר את ערך המאפיין כבולאני.

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

mp.get_property_number(שם [,def])
דומה mp.get_property, אבל החזר את ערך המאפיין כמספר.

שימו לב שאמנם Lua לא מבחין בין מספרים שלמים ל-floats, אבל פנימיים של mpv
לַעֲשׂוֹת. פונקציה זו פשוט מבקשת ציפה כפולה מ-mpv, ו-mpv בדרך כלל
המרת ערכי מאפיינים שלמים לצוף.

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

mp.get_property_native(name [,def])
דומה mp.get_property, אך החזר את ערך המאפיין באמצעות סוג Lua הטוב ביותר
עבור הנכס. לרוב, זה יחזיר מחרוזת, בוליאנית או מספר. כמה
מאפיינים (לדוגמה רשימת פרקים) מוחזרים כטבלאות.

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

mp.set_property(name, ערך)
הגדר את המאפיין הנתון לערך המחרוזת הנתון. לִרְאוֹת mp.get_property ו
פרויקטים למידע נוסף על נכסים.

מחזיר נכון על הצלחה, או אפס, שגיאה על טעות.

mp.set_property_bool(שם, ערך)
דומה mp.set_property, אך הגדר את המאפיין הנתון לערך הבוליאני הנתון.

mp.set_property_number(שם, ערך)
דומה mp.set_property, אך הגדר את המאפיין הנתון לערך המספרי הנתון.

שימו לב שאמנם Lua לא מבחין בין מספרים שלמים ל-floats, אבל פנימיים של mpv
לַעֲשׂוֹת. פונקציה זו תבדוק אם ניתן לייצג את המספר כמספר שלם, וכן
אם כן, הוא יעביר ערך של מספר שלם ל-mpv, אחרת ציפה כפולה.

mp.set_property_native(שם, ערך)
דומה mp.set_property, אך הגדר את המאפיין הנתון באמצעות הסוג המקורי שלו.

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

mp.get_time()
החזר את הזמן הפנימי הנוכחי של mpv בשניות כמספר. זה בעצם ה
זמן מערכת, עם היסט שרירותי.

mp.add_key_binding(key, שם|fn [,fn [,דגלים]])
רשום התקשרות חוזרת שתבוצע על כריכת מפתחות. הכריכה תמופה ל-
נתן מפתח, שהיא מחרוזת המתארת ​​את המפתח הפיזי. זה משתמש באותו מפתח
שמות כמו ב-input.conf, וגם מאפשר שילובים (למשל ctrl+a).

לאחר קריאה לפונקציה זו, לחיצות מקשים יגרמו לפונקציה fn להיקרא
(אלא אם המשתמש מייפה מחדש את המפתח עם כריכה אחרת).

השמיים שם הארגומנט צריך להיות מחרוזת סמלית קצרה. זה מאפשר למשתמש לבצע מיפוי מחדש
קשירת המפתח באמצעות input.conf באמצעות ה- script_message פקודה, והשם של
כריכת המפתחות (ראה להלן דוגמה). השם צריך להיות ייחודי על פני אחרים
כריכות באותו סקריפט - אם לא, הכריכה הקודמת עם אותו שם תעשה זאת
להיות מוחלף. אתה יכול להשמיט את השם, ובמקרה זה נוצר שם אקראי
פנימי.

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

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

מורכב
אם מוגדר ל נָכוֹן, לאחר מכן fn נקרא גם באירועי מעלה ומטה (כמו כן
כחזרה על מפתח, אם מופעלת), כאשר הארגומנט הראשון הוא טבלה. זֶה
לשולחן יש אירוע ערך, המוגדר לאחת מהמחרוזות מטה,
לחזור על, up or ללחוץ (האחרון אם לא ניתן לעקוב אחר מקש למעלה/למטה). זה
עוד יש הוא_עכבר ערך, המספר אם האירוע נגרם
על ידי כפתור עכבר.

פנימית, כריכות מפתח נשלחות דרך script_message_to or script_binding
פקודות קלט ו mp.register_script_message.

ניסיון למפות מספר פקודות למקש יעדיף בעצם כריכה אקראית,
ואילו שאר הכריכות אינן נקראות. זה מובטח שהמשתמש מוגדר
כריכות ב-sinput.conf המרכזיות עדיפות על פני כריכות שנוספו עם זה
פונקציה (אבל ראה mp.add_forced_key_binding).

דוגמא:

function something_handler()
print ("המקש נלחץ")
סוף
mp.add_key_binding("x", "משהו", משהו_מטפל)

פעולה זו תדפיס את ההודעה מה היא מפתח היה לחוץ מתי x נלחץ.

המשתמש יכול למפות מחדש את כריכות המפתח הללו. לאחר מכן המשתמש צריך להכניס את הדברים הבאים
input.conf שלו כדי למפות מחדש את הפקודה ל- y מפתח:

y script_binding משהו

זה ידפיס את ההודעה כאשר המפתח y נלחץ. (x עדיין יעבוד, אלא אם כן
המשתמש ממפה אותו מחדש.)

אתה יכול גם לשלוח הודעה במפורש לסקריפט בעל שם בלבד. נניח את האמור לעיל
הסקריפט השתמש בשם הקובץ fooscript.lua:

y script_binding fooscript.something

mp.add_forced_key_binding(...)
זה עובד כמעט כמו mp.add_key_binding, אך רושם את כריכת המפתח
דרך שתחליף את הכריכות המותאמות אישית של המשתמש ב-input.conf שלו.
(mp.add_key_binding מחליף רק כריכות ברירת מחדל של מפתחות, אך לא אלה של ה-
input.conf. של המשתמש)

mp.remove_key_binding(name)
הסר כריכת מפתח שנוספה איתו mp.add_key_binding or mp.add_forced_key_binding.
השתמש באותו השם שבו השתמשת בעת הוספת הכריכות. לא ניתן להסיר
כריכות שעבורן השמטת את השם.

mp.register_event(שם, fn)
התקשר לפונקציה ספציפית כאשר מתרחש אירוע. שם האירוע הוא מחרוזת, וה-
הפונקציה fn היא ערך פונקציית Lua.

לחלק מהאירועים יש נתונים משויכים. זה מוכנס לשולחן Lua ומועבר בתור
טיעון ל-fn. טבלת Lua כברירת מחדל מכילה א שם שדה, שהוא מחרוזת
המכיל את שם האירוע. אם לאירוע יש שגיאה משויכת, ה שגיאה שדה
מוגדר למחרוזת המתארת ​​את השגיאה, לאחר הצלחה היא לא מוגדרת.

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

מחזירה true אם קיים אירוע כזה, false אחרת.

לִרְאוֹת אירועים ו רשימה of אירועים לקבלת פרטים.

mp.unregister_event(fn)
בטל mp.register_event(..., fn). זה מסיר את כל מטפלי האירועים ששווים ל
מה היא fn פָּרָמֶטֶר. זה משתמש בלואה רגילה == השוואה, אז היזהר בעת התמודדות
עם סגירות.

mp.observe_property(שם, סוג, fn)
צפו בנכס לשינויים. אם הנכס שם משתנה, ואז הפונקציה
fn(שם) יקרא. סוג יכול להיות אפס, או להיות מוגדר לאחד מ אף לא אחד, יליד, bool,
מחרוזת, או מספר. אף לא אחד הוא זהה אפס. עבור כל שאר הערכים, הערך החדש של
הנכס יועבר כטיעון שני ל fnבאמצעות mp.get_property_
כדי לאחזר אותו. זה אומר אם סוג הוא למשל מחרוזת, fn נקרא בערך כמו
in fn(שם, mp.get_property_string(name)).

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

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

אם סוג is אף לא אחד or אפס, יתכנו אירועים ספורדיים של שינוי רכוש. זֶה
פירושו פונקציית השינוי fn ניתן להתקשר גם אם הנכס לא ממש
לשנות.

mp.unobserve_property(fn)
בטל mp.observe_property(..., fn). זה מסיר את כל מטפלי המאפיינים שיש
שווה ל fn פָּרָמֶטֶר. זה משתמש בלואה רגילה == השוואה, אז היזהר מתי
התמודדות עם סגירות.

mp.add_timeout(שניות, fn)
התקשר לפונקציה הנתונה fn כאשר מספר השניות הנתון חלף. שים לב ש
מספר השניות יכול להיות חלקי. לעת עתה, הרזולוציה של הטיימר עשויה להיות כמו
נמוך עד 50 אלפיות השנייה, אם כי זה ישופר בעתיד.

זהו טיימר של צילום אחד: הוא יוסר כאשר הוא ייורה.

מחזיר אובייקט טיימר. לִרְאוֹת mp.add_periodic_timer לקבלת פרטים.

mp.add_periodic_timer(שניות, fn)
התקשר לפונקציה הנתונה מעת לעת. זה כמו mp.add_timeout, אבל הטיימר הוא
נוספה מחדש לאחר הפעלת הפונקציה fn.

החזרים a שעון עצר אובייקט. השמיים שעון עצר אובייקט מספק מה היא הבא שיטות:

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

לַהֲרוֹג() השבת את הטיימר. מאפס את הזמן שחלף. קורות חיים() יפעיל מחדש את
שָׁעוֹן עֶצֶר.

קורות חיים()
הפעל מחדש את הטיימר. אם הטיימר היה מושבת עם תפסיק(), זה יהיה
לחדש בזמן שהופסק. אם הטיימר היה מושבת עם
לַהֲרוֹג(), או אם זה טיימר שנורה קודם לכן (נוסף עם
add_timeout()), זה מפעיל את הטיימר מההתחלה, באמצעות ה-
פסק זמן שהוגדר תחילה.

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

אם אתה כותב את זה, אתה יכול להתקשר t:kill() ; t:resume() כדי לאפס את
פסק הזמן הנוכחי לחדש. (t:stop() לא ישתמש בפסק הזמן החדש.)

Oneshot (RW)
האם הטיימר הוא תקופתי (שקר) או יורה רק פעם אחת (נָכוֹן). זה
הערך משמש כאשר יפוג הטיימר (אך לפני הקריאה חזרה של הטיימר
הפונקציה fn מופעלת).

שים לב שאלו הם שיטה, ואתה צריך לקרוא להם באמצעות : במקום . (מתייחס
ל http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

דוגמא:

שניות = 0
טיימר = mp.add_periodic_timer(1, function()
print("נקרא כל שנייה")
# עצור אותו לאחר 10 שניות
שניות = שניות + 1
אם שניות >= 10 אז
טיימר:kill()
סוף
סוף)

mp.get_opt(key)
החזר הגדרה מה- --script-opts אוֹפְּצִיָה. זה תלוי במשתמש ובתסריט
כיצד נעשה שימוש במנגנון זה. נכון לעכשיו, כל הסקריפטים יכולים לגשת לזה באופן שווה, אז אתה
צריך להיזהר מהתנגשויות.

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

דוגמה

התסריט /path/to/fooscript.lua הופך להיות fooscript.

mp.osd_message(text [,מֶשֶׁך])
הצג הודעת OSD על המסך. משך הוא בשניות, והוא אופציונלי (משתמשים
--osd-משך כברירת מחדל).

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

mp.suspend()‎
השעה את הלולאה הראשית של mpv. יש הסבר ארוך על זה ב-C API
פונקציה mpv_suspend(). בקיצור, זה מונע מהשחקן להציג את הבא
מסגרת וידאו, כדי שלא תיחסם כשאתה מנסה לגשת לנגן.

זה נקרא אוטומטית על ידי מטפל האירוע.

mp.resume()
בטל אחד mp.suspend()‎ שיחה. mp.suspend()‎ מגדיל מונה פנימי, ו
mp.resume() מקטין אותו. כשמגיעים ל-0, השחקן ממש מתחדש.

mp.resume_all()
זה מאפס את מונה ההשעיה הפנימי ומחדש את השחקן. (זה כמו להתקשר
mp.resume() עד שהשחקן יתחדש בפועל.)

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

mp.get_wakeup_pipe()
שיחות mpv_get_wakeup_pipe() ומחזיר את קצה הקריאה של צינור ההתעוררות. (לִרְאוֹת
לקוח.ח לפרטים.)

mp.get_next_timeout()
החזר את הזמן היחסי בשניות כאשר הטיימר הבא (mp.add_timeout ו
דומה) יפוג. אם אין טיימר, חזור אפס.

mp.dispatch_events([allow_wait])
זה יכול לשמש להפעלת לולאות אירועים מותאמים אישית. אם אתה רוצה שליטה ישירה במה
הסקריפט של Lua עושה זאת (במקום להיקרא על ידי לולאת האירועים המוגדרת כברירת מחדל), אתה יכול
הגדר את המשתנה הגלובלי mp_event_loop לפונקציה משלך שמפעילה את לולאת האירוע.
מלולאת האירוע שלך, אתה צריך להתקשר mp.dispatch_events() לעמוד בתור ולשלוח
אירועי mpv.

אם לאפשר_להמתין פרמטר מוגדר ל נָכוֹן, הפונקציה תחסום עד הבא
האירוע מתקבל או שהטיימר הבא יפוג. אחרת (וזו ברירת המחדל
התנהגות), הוא חוזר ברגע שלולאת האירוע מתרוקנת. זה חזק
מומלץ להשתמש mp.get_next_timeout() ו mp.get_wakeup_pipe() אם אתה
מעוניין בהתראה תקין על אירועים חדשים וטיימרים עובדים.

פונקציה זו קוראת mp.suspend()‎ ו mp.resume_all() בעצמו.

mp.enable_messages(level)
הגדר את רמת היומן המינימלית של פלט הודעת mpv לקבל. ההודעות האלה
מודפסים בדרך כלל למסוף. על ידי קריאה לפונקציה זו, אתה יכול להגדיר את
רמת יומן מינימום של הודעות שאמורות להתקבל עם יומן-הודעה מִקרֶה.
ראה את התיאור של אירוע זה לפרטים. הרמה היא מיתר, תראה msg.log
עבור רמות יומן מותרות.

mp.register_script_message(שם, fn)
זהו עוזר לשיגור script_message or script_message_to קריאות ללואה
פונקציות. fn נקרא אם script_message or script_message_to (עם התסריט הזה בתור
יעד) פועל עם שם כפרמטר ראשון. שאר הפרמטרים מועברים
ל fn. אם הודעה עם השם הפרטי כבר רשומה, היא נמחקת.

בשימוש על ידי mp.add_key_binding, אז היזהר מהתנגשויות שמות.

mp.unregister_script_message(name)
בטל רישום קודם עם mp.register_script_message. לא עושה כלום אם
שם לא היה רשום.

mp.msg פונקציות
מודול זה מאפשר להוציא הודעות למסוף, וניתן לטעון אותו לדרוש
'mp.msg'.

msg.log(level, ...)
פרמטר הרמה הוא עדיפות ההודעה. זה מחרוזת ואחד מ קטלני, שגיאה,
להזהיר, מידע, v, באגים. הגדרות המשתמש יקבעו איזו מההודעות הללו
יהיה גלוי. בדרך כלל, כל ההודעות גלויות, למעט v ו באגים.

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

אין צורך להוסיף שורות חדשות.

msg.fatal(...), msg.error(...), msg.warn(...), msg.info(...), msg.verbose(...),
msg.debug(...)
כל אלו הם קיצורי דרך ושווים למתאים msg.log(level, ...)
שיחה.

mp.options פונקציות
mpv מגיע עם מודול מובנה לניהול אפשרויות מקבצי תצורה ושורת הפקודה.
כל מה שאתה צריך לעשות הוא לספק טבלה עם אפשרויות ברירת מחדל לפונקציה read_options.
הפונקציה תחליף את ערכי ברירת המחדל בערכים שנמצאו בקובץ ה-config and
שורת הפקודה (בסדר זה).

options.read_options(טבלה [, מזהה])
A שולחן עם צמדי מפתח-ערך. סוג ערכי ברירת המחדל חשוב עבור
המרת הערכים שנקראו מקובץ התצורה או משורת הפקודה חזרה. אל תשתמש
אפס כערך ברירת מחדל!

השמיים מזהה משמש לזיהוי קובץ התצורה ואפשרויות שורת הפקודה.
אלה צריכים להיות ייחודיים כדי למנוע התנגשויות עם סקריפטים אחרים. ברירת מחדל ל
mp.get_script_name().

יישום לדוגמא:

דורש 'mp.options'
אפשרויות מקומיות = {
optionA = "defaultvalueA",
optionB = -0.5,
optionC = true,
}
read_options(Options, "myscript")
print(options.optionA)

קובץ התצורה יאוחסן ב lua-settings/identifier.conf בתיקיית המשתמש של mpv.
ניתן להתחיל שורות הערה ב-# ולא מוסרים רווחים תועים. ערכים בוליאניים יהיו
להיות מיוצג עם כן/לא.

תצורה לדוגמה:

# תגובה
optionA=שלום עולם
optionB=9999
optionC=לא

אפשרויות שורת הפקודה נקראות מה- --script-opts פָּרָמֶטֶר. כדי למנוע התנגשויות, הכל
יש להקדים את המפתחות מזהה-.

שורת פקודה לדוגמה:

--script-opts=myscript-optionA=TEST,myscript-optionB=0,myscript-optionC=yes

mp.utils אפשרויות
מודול מובנה זה מספק פונקציות עוזר גנריות עבור Lua, ויש להן למהדרין
שום קשר ל-MPV או להשמעת וידאו/אודיו. הם מסופקים מטעמי נוחות. רוב
לפצות על הספרייה הסטנדרטית הדלה של לואה.

הוזהר שכל אחת מהפונקציות הללו עשויה להיעלם בכל עת. הם לא לגמרי חלק
של ה-API המובטח.

utils.getcwd()
מחזירה את הספרייה שממנה הופעל mpv. בשגיאה, אפס, שגיאה מוחזר.

utils.readdir(path [, לְסַנֵן])
מנה את כל הערכים בנתיב הנתון במערכת הקבצים, והחזר אותם בתור
מַעֲרָך. כל ערך הוא ערך ספרייה (ללא הנתיב). הרשימה אינה ממוינת
(בכל סדר שמערכת ההפעלה מחזירה אותו).

אם לסנן ניתן ארגומנט, הוא חייב להיות אחת מהמחרוזות הבאות:

קבצים רשימת קבצים רגילים בלבד. זה לא כולל ספריות, קבצים מיוחדים (כמו
קבצי מכשירי UNIX או FIFO), וקישורים סימליים מתים. זה כולל קישורי UNIX
לקבצים רגילים.

דירס רשום ספריות בלבד, או קישורים סימנים לספריות. . ו .. אינם
כּוֹלֵל.

נוֹרמָלִי כלול את התוצאות של שניהם קבצים ו דירס. (זו ברירת המחדל.)

את כל רשום את כל הערכים, אפילו קבצי מכשיר, קישורים סימליים מתים, FIFOs וה- . ו
.. ערכים.

בשגיאה, אפס, שגיאה מוחזר.

utils.split_path(path)
פצל נתיב לרכיב ספרייה ורכיב שם קובץ, והחזר אותם. ה
ערך ההחזרה הראשון הוא תמיד הספרייה. ערך ההחזר השני הוא הנגרר
חלק מהנתיב, ערך הספרייה.

utils.join_path(p1, עמ' 2)
החזר את השרשור של 2 השבילים. מנסה להיות חכם. לדוגמה, אם `עמ'2 is
נתיב מוחלט, p2 מוחזר ללא שינוי.

utils.subprocess(t)
מפעיל תהליך חיצוני ומחכה עד שהוא יוצא. מחזיר את מצב התהליך ואת
פלט שנלכד.

הפרמטר t הוא שולחן. הפונקציה קוראת את הערכים הבאים:

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

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

גודל מקסימלי
אופציונאלי. הגודל המקסימלי בבתים של הנתונים שמהם ניתן ללכוד
stdout. (ברירת מחדל: 16 MB.)

הפונקציה מחזירה טבלה כתוצאה מכך עם הערכים הבאים:

מצב מצב היציאה הגולמי של התהליך. זה יהיה שלילי על טעות.

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

שגיאה אפס על הצלחה. המיתר נהרג אם התהליך הסתיים ב- an
דרך לא רגילה. המיתר init אם לא ניתן היה להתחיל את התהליך.

ב- Windows, נהרג מוחזר רק כאשר התהליך הופסק על ידי
mpv כתוצאה מ ניתן לביטול להיות מוגדר ל נָכוֹן.

נהרג_על ידינו
מכוון ל נָכוֹן אם התהליך נהרג על ידי mpv כתוצאה מ
ניתן לביטול להיות מוגדר ל נָכוֹן.

בכל המקרים, mp.resume_all() נקרא במרומז.

utils.parse_json(str [, שביל])
מנתח את ארגומנט המחרוזת הנתון בתור JSON, ומחזיר אותו כטבלת Lua. בשגיאה,
החזרות אפס, שגיאה. (כַּיוֹם, שגיאה הוא רק קריאת מחרוזת שגיאה, כי שם
אינו דיווח על שגיאות דק מכל סוג שהוא.)

הערך המוחזר משתמש במוסכמות דומות כמו mp.get_property_native() ל
להבחין בין אובייקטים ומערכים ריקים.

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

utils.format_json(v)
עצב את טבלת Lua (או ערך) נתון כמחרוזת JSON והחזר אותה. בשגיאה,
החזרות אפס, שגיאה. (שגיאות קורות בדרך כלל רק בסוגי ערכים שאינם תואמים
JSON.)

ערך הארגומנט משתמש במוסכמות דומות כמו mp.set_property_native() ל
להבחין בין אובייקטים ומערכים ריקים.

utils.to_string(v)
הפוך את הערך הנתון למחרוזת. עיצוב טבלאות ותוכנן. זה לא
לעשות כל דבר מיוחד; זה נחוץ רק בגלל שלואה היא נוראית.

אירועים
אירועים הם הודעות מליבת השחקן לתסריטים. אתה יכול לרשום מטפל באירועים
עם mp.register_event.

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

דוגמא:

function my_fn(event)
print("תחילת השמעה!")
סוף

mp.register_event("קובץ טעון", my_fn)

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

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

לאירוע יש את טעם שדה, שלוקח אחד מהערכים הבאים:

eof הקובץ הסתיים. זה יכול (אך לא חייב) לכלול קבצים לא שלמים
או חיבורי רשת שבורים בנסיבות.

להפסיק ההשמעה הסתיימה בפקודה.

להפסיק ההשמעה הסתיימה על ידי שליחת פקודת היציאה.

שגיאה קרתה שגיאה. במקרה זה, א שגיאה השדה קיים עם השגיאה
מחרוזת.

הפניה
קורה עם רשימות השמעה וכדומה. פרטים ראו MPV_END_FILE_REASON_REDIRECT
ב-C API.

לא ידוע
לא ידוע. בדרך כלל לא קורה, אלא אם ה-API של Lua אינו מסונכרן עם
C API. (כמו כן, זה יכול לקרות שהתסריט שלך מקבל מחרוזות סיבה
לא היה קיים עדיין בזמן כתיבת התסריט שלך.)

הקובץ נטען
קורה לאחר טעינת קובץ ומתחיל הפעלה.

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

השמעה-הפעלה מחדש
התחלת השמעה לאחר חיפוש או לאחר טעינת הקובץ.

להתבטל נכנס למצב סרק. זה קורה כשההשמעה הסתיימה והנגן הופעל
עם --לְהִתְבַּטֵל or --חלון כוח. מצב זה מסתיים באופן מרומז כאשר קובץ התחלה or
כיבוי קורים אירועים.

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

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

יומן-הודעה
מקבל הודעות מופעלות עם mp.enable_messages. נתוני ההודעה כלולים ב
הטבלה הועברה כפרמטר ראשון למטפל באירועים. הטבלה מכילה, ב
בנוסף לשדות האירועים המוגדרים כברירת מחדל, השדות הבאים:

קידומת קידומת המודול, מזהה את שולח ההודעה. זה מה שה
נגן מסוף שם לפני ההודעה טקסט בעת שימוש ב --v אוֹפְּצִיָה,
וזה גם מה שמשמש --msg-level.

רָמָה רמת היומן כמחרוזת. לִרְאוֹת msg.log עבור שמות אפשריים ברמת יומן. הערה
שגרסאות מאוחרות יותר של mpv עשויות להוסיף רמות חדשות או להסיר (לא מתועד)
קיימים.

טֶקסט הודעת היומן. הטקסט יסתיים עם תו חדש. לפעמים זה
יכול להכיל מספר שורות.

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

קבל-נכס-תשובה
לא מתועד (לא שימושי עבור סקריפטים של Lua).

set-property-reply
לא מתועד (לא שימושי עבור סקריפטים של Lua).

פקודה-תשובה
לא מתועד (לא שימושי עבור סקריפטים של Lua).

מסר-לקוח
לא מתועד (בשימוש פנימי).

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

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

האירועים הבאים מתרחשים גם הם, אך הם הוצאו משימוש: מסלולים שונו, מחליף מסלול,
הפסקה, לבטל את ההשהיה, עדכון מטא נתונים, שינוי פרק. להשתמש mp.observe_property() במקום.

תמצית
זה מתעד תכונות ניסיוניות, או תכונות "מיוחדות מדי" מכדי להבטיח א
ממשק יציב.

mp.add_hook(type, עדיפות, fn)
הוסף התקשר חזרה עבור סוג (מחרוזת המזהה סוג מסוים של וו). אלה
הוקס מאפשרים לשחקן לקרוא לפונקציות סקריפט ולהמתין לתוצאה שלהן
(בדרך כלל, ממשק הסקריפט של Lua הוא אסינכרוני מנקודת המבט של
ליבת השחקן). עדיפות הוא מספר שלם שרירותי המאפשר סדר בין ווים
מאותו סוג. השימוש בערך 50 מומלץ כערך ברירת מחדל ניטרלי. fn is
הפונקציה שתיקרא במהלך ביצוע ה-hook.

לִרְאוֹת הוקס עבור הווים הקיימים כרגע ומה שהם עושים - רק רשימת הווים היא
מעניין; הטיפול בביצוע Hook נעשה על ידי פונקציית הסקריפט Lua
באופן אוטומטי.

JSON IPC

mpv יכול להיות נשלט על ידי תוכניות חיצוניות באמצעות פרוטוקול IPC מבוסס JSON. זה יכול להיות
מופעל על ידי ציון הנתיב לשקע יוניקס באמצעות האפשרות --input-unix-socket.
לקוחות יכולים להתחבר לשקע זה ולשלוח פקודות לנגן או לקבל ממנו אירועים
זה.

אזהרה:
זה לא נועד להיות פרוטוקול רשת מאובטח. זה בפירוש לא בטוח: שם
אין אימות, אין הצפנה, וגם הפקודות עצמן אינן מאובטחות. ל
לדוגמה, ה לָרוּץ הפקודה נחשפת, שיכולה להריץ פקודות מערכת שרירותיות. ה
use-case שולט בנגן באופן מקומי. זה לא שונה מה-MPlayer
פרוטוקול עבדים.

סוקאט דוגמה
אתה יכול להשתמש ב סוקט כלי לשליחת פקודות (וקבלת תשובה) מהקליפה. בהנחה
mpv התחיל עם:

mpv file.mkv --input-unix-socket=/tmp/mpvsocket

אז אתה יכול לשלוט בו באמצעות socat:

> echo '{ "command": ["get_property", "playback-time"] }' | socat - /tmp/mpvsocket
{"data":190.482000,"error":"success"}

במקרה זה, socat מעתיק נתונים בין stdin/stdout לחיבור שקע mpv.

ראה --לְהִתְבַּטֵל אפשרות כיצד לגרום ל-MPV להתחיל מבלי לצאת מיד או להפעיל קובץ.

אפשר גם לשלוח פקודות טקסט בסגנון input.conf בלבד:

> echo 'show_text ${playback-time}' | socat - /tmp/mpvsocket

אבל לא תקבל תשובה על השקע. (פקודה מסוימת זו מציגה את ההשמעה
זמן ב-OSD של הנגן.)

פרוטוקול
לקוחות יכולים לבצע פקודות בנגן על ידי שליחת הודעות JSON בצורה הבאה:

{ "command": ["command_name", "param1", "param2", ...] }

איפה command_name הוא שם הפקודה שיש לבצע, ואחריה רשימה של
פרמטרים. יש לעצב פרמטרים כערכי JSON מקוריים (מספרים שלמים, מחרוזות,
בוליאנים,...). כל הודעה צריך להסתיים עם \n. בנוסף, \n אסור להופיע
בכל מקום בתוך ההודעה. בפועל זה אומר שצריך לצמצם הודעות
לפני שנשלח ל-mpv.

mpv אז ישלח בחזרה תשובה המציינת אם הפקודה בוצעה כהלכה, ו- an
שדה נוסף המכיל את נתוני ההחזרה הספציפיים לפקודה (הוא יכול גם להיות null).

{ "error": "success", "data": null }

mpv גם ישלח אירועים ללקוחות עם הודעות JSON בצורה הבאה:

{ "event": "event_name" }

איפה שם אירוע הוא שם האירוע. שדות נוספים ספציפיים לאירוע יכולים להיות גם
מתנה. לִרְאוֹת רשימה of אירועים לרשימה של כל האירועים הנתמכים.

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

לדוגמה, בקשה זו:

{ "command": ["get_property", "time-pos"], "request_id": 100 }

ייצור את התגובה הזו:

{ "error": "success", "data": 1.468135, "request_id": 100 }

כל הפקודות, התשובות והאירועים מופרדים זה מזה עם מעבר שורה
אופי (\n).

אם התו הראשון (לאחר דילוג על רווח לבן) אינו {, הפקודה תהיה
מתפרשים כפקודות טקסט שאינן JSON, כפי שהן משמשות ב-input.conf (or
mpv_command_string() בממשק API של הלקוח). בנוסף, קו שמתחיל ב # וריק
מתעלמים מהקווים.

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

פקודות
בנוסף לפקודות המתוארות ב רשימה of קֶלֶט פקודות, כמה פקודות נוספות
ניתן להשתמש גם כחלק מהפרוטוקול:

שם לקוח
החזר את שם הלקוח כמחרוזת. זו המחרוזת ipc-N כאשר N הוא an
מספר שלם.

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

get_property
החזר את הערך של הנכס הנתון. הערך יישלח בשדה הנתונים של
הודעת השידור החוזר.

דוגמא:

{ "command": ["get_property", "volume"] }
{ "data": 50.0, "error": "success" }

get_property_string
כמו get_property, אבל הנתונים שיתקבלו יהיו תמיד מחרוזת.

דוגמא:

{ "command": ["get_property_string", "volume"] }
{ "data": "50.000000", "error": "success" }

set_property
הגדר את המאפיין הנתון לערך הנתון. לִרְאוֹת פרויקטים לפרטים נוספים
לגבי נכסים.

דוגמא:

{ "command": ["set_property", "pause", true] }
{ "error": "success" }

set_property_string
כמו set_property, אך יש להעביר את ערך הארגומנט כמחרוזת.

דוגמא:

{ "command": ["set_property_string", "pause", "yes"] }
{ "error": "success" }

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

דוגמא:

{ "command": ["observe_property", 1, "volume"] }
{ "error": "success" }
{ "event": "property-change", "id": 1, "data": 52.0, "name": "volume" }

observe_property_string
כמו observe_property, אבל הנתונים שיתקבלו יהיו תמיד מחרוזת.

דוגמא:

{ "command": ["observe_property_string", 1, "volume"] }
{ "error": "success" }
{ "event": "property-change", "id": 1, "data": "52.000000", "name": "volume" }

unobserve_property
בטל observe_property or observe_property_string. זה דורש את המזהה המספרי
הועבר לפקודה observe כטיעון.

דוגמא:

{ "command": ["unobserve_property", 1] }
{ "error": "success" }

request_log_messages
אפשר פלט של הודעות יומן mpv. הם יתקבלו כאירועים. הפרמטר
לפקודה זו יש רמת היומן (ראה mpv_request_log_messages פונקציית C API).

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

אפשר_אירוע, disable_event
מפעיל או משבית את האירוע בעל השם. מראות את mpv_request_event פונקציית C API.
אם המחרוזת את כל משמש במקום שם אירוע, כל האירועים מופעלים או
נכה.

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

לְהַשְׁעוֹת
השעה את הלולאה הראשית של mpv. יש הסבר ארוך על זה ב-C API
פונקציה mpv_suspend(). בקיצור, זה מונע מהשחקן להציג את הבא
מסגרת וידאו, כדי שלא תיחסם כשאתה מנסה לגשת לנגן.

קורות חיים בטל אחד לְהַשְׁעוֹת שיחה. לְהַשְׁעוֹת מגדיל מונה פנימי, ו קורות חיים
מקטין אותו. כשמגיעים ל-0, השחקן ממש מתחדש.

get_version
מחזירה את גרסת ה-API של הלקוח שה-C API של מופע mpv המרוחק מספק. (גַם
לִרְאוֹת DOCS/client-api-changes.rst.)

UTF-8
בדרך כלל, כל המחרוזות נמצאות ב-UTF-8. לפעמים זה יכול לקרות שמיתרים נמצאים בחלק
קידוד שבור (לעיתים קרובות קורה עם תגיות קבצים וכאלה, ושמות קבצים ביוניקס רבים כן
לא חייב להיות גם ב-UTF-8). זה אומר ש-mpv לפעמים שולח JSON לא חוקי. אם
זו בעיה עבור מנתח יישום הלקוח, עליו לסנן את הנתונים הגולמיים עבור
רצפי UTF-8 לא חוקיים ולבצע את ההחלפה הרצויה, לפני הזנת הנתונים
מנתח ה-JSON שלו.

mpv לא ינסה לבנות UTF-8 לא חוקי עם רצפי בריחה שבורים.

CHANGELOG

אין יומן שינויים אמיתי, אבל אתה יכול להסתכל על הדברים הבאים:

· יומן השינויים של הגרסה, שאמור להכיל את רוב השינויים הגלויים למשתמש, כולל חדשים
תכונות ותיקוני באגים:

https://github.com/mpv-player/mpv/releases

· יומן git, שהוא יומן השינויים ה"אמיתי".

· הקובץ mplayer-changes.rst ב DOCS ספריית משנה במאגר git, שהשתמש
להיות במקום סעיף זה. זה מתעד כמה שינויים שקרו מאז mplayer2
הוציא את ה-MPlayer.

הטמעה לתוך אחר תוכניות (LIBMPV)

mpv יכול להיות מוטבע בתוכניות אחרות כחלק אחורי של הפעלת וידאו/אודיו. המומלץ
הדרך לעשות זאת היא באמצעות libmpv. לִרְאוֹת libmpv/client.h במאגר קוד המקור mpv. זֶה
מספק C API. כריכות לשפות אחרות עשויות להיות זמינות (ראה ויקי).

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

ישנם מספר משתני סביבה שניתן להשתמש בהם כדי לשלוט בהתנהגות של
mpv.

בית, XDG_CONFIG_HOME
משמש לקביעת ספריית התצורה של mpv. אם XDG_CONFIG_HOME אינו מוגדר,
$HOME/.config/mpv משמש.

$HOME/.mpv תמיד מתווסף לרשימת נתיבי החיפוש של התצורה עם ערך נמוך יותר
עדיפות.

XDG_CONFIG_DIRS
אם מוגדר, נעשה שימוש בספריות תצורת מערכת בסגנון XDG. אחרת, ה-UNIX
מוסכמה (PREFIX/etc/mpv/) משמש.

מונח משמש לקביעת סוג המסוף.

MPV_HOME
ספרייה שבה mpv מחפש הגדרות משתמש. עוקפים עמוד הבית, ו-mpv ינסה לעשות זאת
טען את קובץ התצורה בשם $MPV_HOME/mpv.conf.

MPV_VERBOSE (ראה גם -v ו --msg-level)
הגדר את רמת הדיבור הראשונית בכל מודולי ההודעות (ברירת מחדל: 0). זה
מספר שלם, והדיבור המתקבל תואם למספר של --v אפשרויות
עבר לשורת הפקודה.

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

LADSPA_PATH
מציין את נתיב החיפוש עבור תוספים של LADSPA. אם הוא לא מוגדר, נתיב מוסמך לחלוטין
יש להשתמש בשמות.

תצוגה
שם תצוגה רגיל X11 לשימוש.

FFmpeg/Libav:
ספרייה זו ניגשת למשתני סביבה שונים. עם זאת, הם לא
מתועדים באופן מרכזי, ותיעודם אינו התפקיד שלנו. לכן, רשימה זו היא
לא שלם.

משתני סביבה בולטים:

http_proxy
כתובת URL ל-proxy עבור http:// ו https:// כתובות אתרים.

no_proxy
רשימה של דפוסי תחום שעבורם אין להשתמש ב-proxy. ערכי רשימה הם
מופרדים על ידי ,. דפוסים יכולים לכלול *.

libdvdcss:

DVDCSS_CACHE
ציין ספרייה שבה לאחסן ערכי מפתח כותרת. זה יאיץ
פירוק של תקליטורי DVD שנמצאים במטמון. ה DVDCSS_CACHE הספרייה היא
נוצר אם הוא לא קיים, ונוצרת ספריית משנה על שם ה
שם ה-DVD או תאריך הייצור. אם DVDCSS_CACHE לא מוגדר או ריק,
libdvdcss ישתמש בערך ברירת המחדל שהוא ${HOME}/.dvdcss/ תחת יוניקס
וספריית נתוני האפליקציה הנודדת (%% AppData) תחת Windows. ה
ערך מיוחד "כבוי" משבית את האחסון במטמון.

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

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

דיסק היא שיטה חוזרת כאשר המפתח נכשל. במקום להשתמש בנגן
מפתחות, libdvdcss יפצח את מפתח הדיסק באמצעות כוח גס
אַלגוֹרִיתְם. תהליך זה הוא אינטנסיבי במעבד ודורש 64 מגה-בייט של זיכרון
לאחסון נתונים זמניים.

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

DVDCSS_RAW_DEVICE
ציין את ההתקן הגולמי לשימוש. השימוש המדויק יהיה תלוי בהפעלתך
מערכת, כלי השירות של לינוקס להגדרת התקנים גולמיים הוא חי(8) למשל.
שימו לב שברוב מערכות ההפעלה, שימוש במכשיר גולמי מחייב
מאגרים מיושרים מאוד: לינוקס דורשת יישור של 2048 בתים (שזה
גודל של מגזר DVD).

DVDCSS_VERBOSE
מגדיר את רמת המילוליות libdvdcss.

0 לא מוציא הודעות בכלל.

1 מוציא הודעות שגיאה ל-stderr.

2 מפלט הודעות שגיאה והודעות איתור באגים ל-stderr.

DVDREAD_NOKEYS
דלג על אחזור כל המפתחות בעת ההפעלה. כרגע מושבת.

עמוד הבית FIXME: תעד את זה.

יְצִיאָה קודים

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

1 שגיאה באתחול mpv. זה מוחזר גם אם מועברות לאפשרויות לא ידועות
mpv.

2 לא ניתן היה להפעיל את הקובץ שהועבר ל-mpv. זה קצת מטושטש: כרגע,
השמעה של קובץ נחשבת כמוצלחת אם האתחול היה בעיקר
מצליח, גם אם ההשמעה נכשלת מיד לאחר האתחול.

3 היו כמה קבצים שניתן להפעיל, וכמה קבצים שלא ניתן (באמצעות
ההגדרה של הצלחה מלמעלה).

4 צא עקב אות, Ctrl+c בחלון VO ​​(כברירת מחדל), או מברירת המחדל
צא מכריכות מקשים במצב קידוד.

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

השתמש ב-mpv מקוון באמצעות שירותי onworks.net