نام (NAME)

ffplay - پخش‌کننده رسانه‌ای بسیار ساده و پرتابل FFplay

شرح مختصر (SYNOPSIS)

ffplay [گزینه‌ها] [نشانی_اینترنتی_ورودی]

توضیحات (DESCRIPTION)

برنامه FFplay یک پخش‌کننده رسانه‌ای بسیار ساده و پرتابل است که از کتابخانه‌های FFmpeg و کتابخانه SDL استفاده می‌کند. این برنامه بیشتر به عنوان بستری برای آزمودن رابط‌های برنامه‌نویسی مختلف FFmpeg به کار می‌رود.

گزینه‌ها (OPTIONS)

تمامی گزینه‌های عددی، چنانچه به نحو دیگری مشخص نشده باشد، یک رشته نشان‌دهنده یک عدد را به عنوان ورودی می‌پذیرند که ممکن است با یکی از پیشوندهای یکای بین‌المللی (SI) مانند 'K'، 'M' یا 'G' همراه باشد.

اگر حرف 'i' به پیشوند یکای SI الحاق شود، پیشوند کامل به عنوان پیشوند برای مضارب دودویی تفسیر می‌شود که بر پایه توان‌های ۱۰۲۴ به جای توان‌های ۱۰۰۰ هستند. افزودن 'B' به پیشوند یکای SI مقدار را در ۸ ضرب می‌کند. این اجازه می‌دهد تا به عنوان مثال از 'KB'، 'MiB'، 'G' و 'B' به عنوان پسوندهای عددی استفاده شود.

گزینه‌هایی که آرگومان دریافت نمی‌کنند، گزینه‌های بولی هستند و مقدار مربوطه را روی درست (true) تنظیم می‌کنند. می‌توان آن‌ها را با افزودن پیشوند "no" به نام گزینه روی نادرست (false) تنظیم کرد. به عنوان مثال استفاده از "-nofoo" گزینه بولی با نام "foo" را روی false قرار می‌دهد.

گزینه‌های دارای آرگومان از یک ساختار نحوی ویژه پشتیبانی می‌کنند که در آن آرگومان داده‌شده در خط فرمان به عنوان مسیری به فایلی تفسیر می‌شود که مقدار واقعی آرگومان از آن بارگیری می‌شود. برای استفاده از این قابلیت، یک ممیز رو به جلو '/' بلافاصله پیش از نام گزینه (پس از خط تیره ابتدایی) اضافه کنید. برای نمونه:

ffplay -/vf filter.script input.mp4

توصیف گراف فیلتر را از فایلی به نام filter.script بارگیری می‌کند.

تعیین‌کننده‌های استریم (Stream specifiers)

برخی گزینه‌ها برای هر استریم به طور جداگانه اعمال می‌شوند، مانند نرخ بیت یا کدک. تعیین‌کننده‌های استریم برای مشخص کردن دقیق اینکه یک گزینه معین به کدام استریم یا استریم‌ها تعلق دارد، استفاده می‌شوند.

تعیین‌کننده استریم رشته‌ای است که معمولاً به نام گزینه الحاق شده و با دو نقطه از آن جدا می‌شود. به عنوان مثال "-codec:a:1 ac3" شامل تعیین‌کننده استریم "a:1" است که با دومین استریم صوتی مطابقت دارد؛ بنابراین کدک ac3 را برای دومین استریم صوتی انتخاب می‌کند.

یک تعیین‌کننده استریم می‌تواند با چندین استریم مطابقت داشته باشد، به طوری که گزینه روی تمام آن‌ها اعمال شود. برای مثال تعیین‌کننده استریم در "-b:a 128k" با تمامی استریم‌های صوتی مطابقت دارد.

تعیین‌کننده استریم خالی با تمام استریم‌ها مطابقت دارد. به عنوان مثال "-codec copy"; یا "-codec: copy" تمام استریم‌ها را بدون بازکدگذاری کپی می‌کند.

شکل‌های ممکن تعیین‌کننده‌های استریم عبارتند از:

stream_index: با استریم دارای این اندیس مطابقت دارد. شماره‌گذاری استریم‌ها بر اساس ترتیب شناسایی توسط libavformat است.
stream_type[:additional_stream_specifier]: مقدار stream_type یکی از موارد زیر است: 'v' یا 'V' برای ویدیو، 'a' برای صدا، 's' برای زیرنویس، 'd' برای داده و 't' برای پیوست‌ها. 'v' با تمام استریم‌های ویدیو مطابقت دارد، 'V' تنها با استریم‌های ویدیویی که تصاویر پیوست‌شده، بندانگشتی‌ها یا طرح‌های جلد نیستند مطابقت دارد.
p:program_id[:additional_stream_specifier]: با استریم‌هایی که در برنامه با شناسه program_id قرار دارند مطابقت دارد.
#stream_id or i:stream_id: تطبیق استریم بر پایه شناسه استریم (مانند PID در کانتینر MPEG-TS).
m:key[:value]: با استریم‌هایی که برچسب فراداده‌ای key با مقدار مشخص‌شده دارند مطابقت پیدا می‌کند.
u: با استریم‌های با پیکربندی قابل استفاده مطابقت دارد (کدک تعریف شده و اطلاعات ضروری مانند ابعاد تصویر یا نرخ نمونه‌برداری صدا موجود باشند).

گزینه‌های عمومی (Generic options)

این گزینه‌ها میان تمامی ابزارهای مجموعه ff* به صورت مشترک پشتیبانی می‌شوند.

-L, -license: نمایش مجوز برنامه (License).
-h, -?, -help, --help [arg]: نمایش راهنما. یک پارامتر اختیاری می‌تواند برای چاپ راهنما درباره یک مورد خاص مشخص شود:

long: چاپ گزینه‌های پیشرفته ابزار علاوه بر گزینه‌های پایه.
full: چاپ فهرست کامل تمامی گزینه‌ها شامل گزینه‌های مشترک و خصوصی برای انکودرها، دیکودرها، دی‌ماکسرها، ماکسرها، فیلترها و غیره.
decoder=decoder_name: چاپ اطلاعات دقیق درباره دیکودر مشخص‌شده با decoder_name.
encoder=encoder_name: چاپ اطلاعات تفصیلی درباره انکودر مشخص‌شده با encoder_name.
demuxer=demuxer_name: چاپ اطلاعات تفصیلی درباره دی‌ماکسر مشخص‌شده با demuxer_name.
muxer=muxer_name: چاپ اطلاعات تفصیلی درباره ماکسر مشخص‌شده با muxer_name.
filter=filter_name: چاپ اطلاعات کامل درباره فیلتر مشخص‌شده با filter_name.

-version: نمایش نسخه برنامه و کتابخانه‌های مورد استفاده.
-buildconf: نمایش پیکربندی ساخت برنامه.
-formats: نمایش تمام قالب‌های در دسترس (شامل دستگاه‌ها).
-demuxers: نمایش تمامی دی‌ماکسرهای در دسترس.
-muxers: نمایش تمامی ماکسرهای در دسترس.
-devices: نمایش تمامی دستگاه‌های ورودی و خروجی در دسترس.
-codecs: نمایش تمام کدک‌های شناخته‌شده برای libavcodec.
-decoders: نمایش دیکودرهای در دسترس.
-encoders: نمایش انکودرهای در دسترس.
-filters: نمایش تمامی فیلترهای در دسترس.
-protocols: نمایش تمامی پروتکل‌های شبکه و فایل در دسترس.
-loglevel [flags+]loglevel: تنظیم سطح گزارش‌دهی پیام‌ها (LogLevel)؛ گزینه‌های ممکن شامل: quiet, panic, fatal, error, warning, info, verbose, debug.
-v loglevel: نام مستعار برای -loglevel.
-report: تولید گزارش کامل خط فرمان و لاگ در فایلی با نام مشخص در دایرکتوری جاری.
-hide_banner: پنهان کردن بنر پیش‌فرض متنی حاوی اطلاعات کپی‌رایت و بیلد.

گزینه‌های AVOptions

این گزینه‌ها مستقیماً توسط کتابخانه‌های libavformat، libavdevice و libavcodec ارائه می‌شوند. برای مشاهده فهرست گزینه‌ها از -help استفاده کنید.

گزینه‌های اصلی (Main options)

-x عرض: اجبار به نمایش با این عرض (عرض تصویر).
-y ارتفاع: اجبار به نمایش با این ارتفاع (ارتفاع تصویر).
-fs: شروع در حالت تمام صفحه (fullscreen).
-an: غیرفعال کردن صدا.
-vn: غیرفعال کردن ویدیو.
-sn: غیرفعال کردن زیرنویس.
-ss موقعیت: پرش به موقعیت زمانی مشخص‌شده. توجه داشته باشید که در بیشتر قالب‌ها امکان پرش کاملاً دقیق وجود ندارد، بنابراین ffplay به نزدیک‌ترین نقطه کلیدی به این موقعیت پرش می‌کند.
-t مدت_زمان: پخش به میزان مشخص‌شده از صدا/ویدیو (به ثانیه).
-bytes: پرش بر پایه بایت به جای زمان.
-seek_interval: تنظیم فاصله سفارشی پرش (بر حسب ثانیه) هنگام استفاده از کلیدهای چپ/راست. پیش‌فرض ۱۰ ثانیه است.
-nodisp: غیرفعال کردن نمایش گرافیکی تصویر.
-noborder: نمایش پنجره بدون حاشیه (borderless window).
-alwaysontop: پنجره همواره در بالا قرار داشته باشد.
-volume: تنظیم بلندی صدای آغازین. 0 به معنای سکوت و 100 به معنای حجم صدای طبیعی بدون کاهش یا افزایش است.
-f قالب: اجبار قالب فایل ورودی.
-window_title عنوان: تنظیم عنوان پنجره (پیش‌فرض نام فایل ورودی است).
-left موقعیت_افقی: تنظیم موقعیت افقی x برای سمت چپ پنجره (پیش‌فرض پنجره وسط‌چین است).
-top موقعیت_عمودی: تنظیم موقعیت عمودی y برای بالای پنجره (پیش‌فرض پنجره وسط‌چین است).
-loop تعداد: تکرار پخش فیلم به میزان <تعداد> بار. مقدار 0 به معنای تکرار نامحدود است.
-showmode حالت: تنظیم حالت نمایش مورد استفاده. مقادیر ممکن عبارتند از:

0, video: نمایش ویدیو
1, waves: نمایش امواج صوتی
2, rdft: نمایش باند فرکانس صوتی با استفاده از RDFT

مقدار پیش‌فرض "video" است. با فشردن کلید w می‌توانید بین حالت‌ها جابه‌جا شوید.

-vf filtergraph: ایجاد گراف فیلتر مشخص‌شده و استفاده از آن برای فیلتر کردن استریم ویدیو.
-af filtergraph: گراف فیلتر برای اعمال روی صدای ورودی.
-i url: خواندن از نشانی ورودی.

گزینه‌های پیشرفته (Advanced options)

-stats: چاپ آمارهای مختلف پخش شامل مدت استریم، پارامترهای کدک، موقعیت فعلی در استریم و رانش همگام‌سازی صدا/تصویر. برای غیرفعال کردن از "-nostats" استفاده کنید.
-fast: بهینه‌سازی‌های غیراستاندارد برای افزایش سرعت.
-genpts: تولید pts (برچسب‌های زمانی ارائه).
-sync name: تنظیم ساعت مرجع اصلی روی صدا ("type=audio")، ویدیو ("type=video") یا خارجی ("type=ext"). پیش‌فرض صدا است.
-ast تعیین‌کننده_استریم_صدا: انتخاب استریم صوتی دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
-vst تعیین‌کننده_استریم_ویدیو: انتخاب استریم ویدیویی دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
-sst تعیین‌کننده_استریم_زیرنویس: انتخاب استریم زیرنویس دلخواه با استفاده از تعیین‌کننده استریم داده‌شده.
-autoexit: خروج خودکار از برنامه هنگام پایان یافتن پخش ویدیو.
-exitonkeydown: خروج در صورت فشرده شدن هر کلیدی روی صفحه‌کلید.
-exitonmousedown: خروج در صورت کلیک شدن هر دکمه‌ای از موش‌واره (ماوس).
-codec:media_specifier codec_name: اجبار پیاده‌سازی یک دیکودر خاص برای استریم مشخص‌شده با media_specifier (شامل "a" برای صدا، "v" برای ویدیو و "s" برای زیرنویس).
-acodec codec_name: اجبار دیکودر صوتی خاص.
-vcodec codec_name: اجبار دیکودر ویدیویی خاص.
-scodec codec_name: اجبار دیکودر زیرنویس خاص.
-autorotate: چرخش خودکار ویدیو بر اساس فراداده فایل. به طور پیش‌فرض فعال است. برای غیرفعال کردن از -noautorotate استفاده کنید.
-framedrop: ریختن فریم‌های ویدیویی (Drop frames) در صورت عدم هماهنگی ویدیو با صدا.
-infbuf: نامحدود کردن اندازه بافر ورودی، خواندن هرچه سریع‌تر داده‌ها از ورودی.
-filter_threads nb_threads: تعیین تعداد رشته‌های پردازشی (threads) مورد استفاده برای پایپ‌لاین فیلتر.
-enable_vulkan: استفاده از رندرکننده Vulkan به جای رندرکننده داخلی SDL. وابسته به libplacebo است.
-hwaccel: استفاده از شتاب‌دهنده سخت‌افزاری برای رمزگشایی.

هنگام پخش (While playing)

کلیدهای میانبر در زمان پخش:

q, ESC: خروج از برنامه.
f: جابه‌جایی بین حالت تمام‌صفحه و پنجره‌ای.
p, فاصله (SPC): مکث (Pause) و ادامه پخش.
m: قطع/وصل صدا (Mute).
9, 0
/, *: کاهش و افزایش حجم صدا به ترتیب.
a: جابه‌جایی بین کانال‌های صوتی در برنامه جاری.
v: جابه‌جایی بین کانال‌های ویدیویی.
t: جابه‌جایی بین کانال‌های زیرنویس در برنامه جاری.
c: جابه‌جایی بین برنامه‌ها (Programs).
w: جابه‌جایی بین حالت‌های نمایش صوتی یا فیلترهای ویدیویی.
s: گام به فریم بعدی (نمایش فریم‌به‌فریم).
چپ/راست (left/right): پرش به عقب/جلو به میزان ۱۰ ثانیه (یا فاصله سفارشی با -seek_interval).
پایین/بالا (down/up): پرش به عقب/جلو به میزان ۱ دقیقه.
صفحه بعد/صفحه قبل (page down/page up): پرش به فصل قبل/بعد (یا ۱۰ دقیقه عقب/جلو در صورت عدم وجود فصل‌ها).
راست‌کلیک موش‌واره (right mouse click): پرش به درصدی از فایل متناظر با عرض پنجره کلیک‌شده.
دوبار‌کلیک چپ موش‌واره (left mouse double-click): تغییر وضعیت تمام صفحه.

همچنین ببینید (SEE ALSO)

ffplay-all(1), ffmpeg(1), ffprobe(1), ffmpeg-utils(1), ffmpeg-scaler(1), ffmpeg-resampler(1), ffmpeg-codecs(1), ffmpeg-bitstream-filters(1), ffmpeg-formats(1), ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)

نویسندگان (AUTHORS)

توسعه‌دهندگان FFmpeg.

برای جزئیات درباره نویسندگی، به تاریخچه گیت پروژه در https://git.ffmpeg.org/ffmpeg مراجعه نمایید.