ncplayer(1) General Commands Manual ncplayer(1)

ncplayer - رندر تصاویر و ویدیو در یک ترمینال

ncplayer [-h] [-V] [-q] [-d delaymult] [-l loglevel] [-b blitter] [-s scalemode] [-k] [-L] [-t seconds] [-n] [-a color] files

برنامه ncplayer از یک نسخه چندرسانه‌ای Notcurses برای رندر تصاویر و ویدیوها درون ترمینال استفاده می‌کند. به‌طور پیش‌فرض، مقیاس‌بندی از نوع stretch (کشش) برای پر کردن ناحیه رندر استفاده می‌شود و باکیفیت‌ترین بلیتِر (blitter) موجود به کار گرفته خواهد شد.

-d delaymult: اعمال یک ضریب گویای غیرمنفی به مقیاس تاخیر (delayscale). تنها برای رسانه‌های چندفریمی مانند ویدیو و تصاویر متحرک اعمال می‌شود. همراه با -k پشتیبانی نمی‌شود.

-t seconds: تاخیر به میزان seconds ثانیه پس از هر فایل. اگر از این گزینه استفاده شود، اعلان «press any key to continue» نمایش داده نخواهد شد. مقدار seconds می‌تواند هر عدد غیرمنفی باشد.

-l loglevel: ثبت گزارش در خروجی استاندارد خطا (stderr) بین همه چیز (سطح گزارش ۷) و هیچ چیز (سطح گزارش ۰).

-s scalemode: حالت مقیاس‌بندی؛ یکی از موارد none، hires، scale، scalehi یا stretch.

-b blitter: بلیتِر (blitter)؛ یکی از موارد ascii، half، quad، sex، oct، braille یا pixel.

-m margins: تعیین حاشیه‌های رندر (به بخش زیر مراجعه کنید).

-L: تکرار حلقه‌ای فریم‌ها تا زمانی که کلیدی فشرده شود. همراه با -k پشتیبانی نمی‌شود.

-k: استفاده از حالت مستقیم (بخش notcurses_direct(3) را ببینید). این گزینه موجب باقی ماندن خروجی روی صفحه پس از خروج از برنامه شده و آن را به صورت درون‌سطحی (inline) تولید می‌کند (به‌جای پاک کردن صفحه و قرار دادن آن در بالا). همراه با -L یا -d پشتیبانی نمی‌شود.

-q: عدم چاپ اطلاعات فریم/زمان‌بندی در بالای صفحه، و همچنین عدم چاپ خلاصه خروجی هنگام خروج.

-a: رفتار با color به عنوان رنگ شفاف (transparent).

-n: استفاده از مقیاس‌بندی بدون درون‌یابی (non-interpolative). نتیجه معمولاً از لحاظ بصری جذابیت کمتری دارد، اما رنگ‌های جدید تولید نمی‌کند.

-V: چاپ نام و نسخه برنامه، و خروج با وضعیت موفقیت‌آمیز.

-h: چاپ اطلاعات راهنما، و خروج با وضعیت موفقیت‌آمیز.

files: انتخاب اینکه کدام فایل‌ها رندر شوند و ترتیب رندر آن‌ها چگونه باشد.

حاشیه‌های پیش‌فرض همگی ۰ هستند و مقیاس‌بندی پیش‌فرض stretch است. بنابراین تمام ناحیه رندر استفاده خواهد شد. با استفاده از -m، می‌توان حاشیه‌ها را مشخص کرد. یک عدد واحد برای تنظیم هر چهار حاشیه روی همان مقدار ارائه دهید، یا چهار مقدار جداشده با کاما را به ترتیب برای حاشیه‌های بالا، راست، پایین و چپ مشخص کنید. هنگام استفاده از -k، حاشیه‌های بالا، راست و پایین نادیده گرفته می‌شوند. حاشیه‌های منفی مجاز نیستند.

حالت مقیاس‌بندی stretch اندازه شیء را دقیقاً مطابق با ناحیه رندر هدف تغییر می‌دهد. مگر اینکه یک بلیتِر با -b مشخص شده باشد، stretch از باکیفیت‌ترین بلیتِر در دسترس استفاده خواهد کرد. حالت scale اندازه شیء را طوری تغییر می‌دهد که لبه طولانی‌تر ناحیه رندر دقیقاً منطبق شود، و لبه دیگر برای حفظ نسبت تصویر تنظیم می‌گردد. حالت none از اندازه اصلی تصویر استفاده می‌کند. هر دو حالت scale و none نسبت تصویر ۱:۱ را هدف قرار می‌دهند، و بنابراین half را به quad، sex، oct یا braille ترجیح خواهند داد. حالت‌های scalehi و hires از بالاترین وضوح بلیتِر موجود استفاده می‌کنند.

بلیتِرها را می‌توان در زمان اجرا با فشردن کلیدهای «0» تا «6» انتخاب کرد. مقدار NCBLIT_DEFAULT متناظر با «0» است. بلیتِرهای مختلف در notcurses_visual(3) شرح داده شده‌اند. اگر بلیتِری در محیط فعلی قابل استفاده نباشد، بلیتِر فعلی حفظ خواهد شد.

رسانه‌های چندفریمی را می‌توان با فشردن کلید فاصله (Space) متوقف (pause) کرد. کلید فاصله (یا هر کلید کنترلی معتبر دیگر) را فشار دهید تا پخش ادامه یابد.

اگر به دنبال یک نمایشگر تصویر سریع و درون‌سطحی برای پوسته (shell) هستید، اجرای ncplayer -k -t0 -q را امتحان کنید.

نمایش بهینه نیازمند ترمینالی است که قابلیت rgb را در terminfo(5) ارائه دهد، یا اینکه متغیر محیطی COLORTERM روی 24bit تعریف شده باشد (و ترمینال از این متغیر پشتیبانی کند)، همراه با یک فونت تک‌فاصله (fixed-width) با پوشش مناسبی از نویسه‌های رسم بلوک یونیکد (Unicode Block Drawing Characters).

حالت مستقیم برای رسانه‌های چندفریمی اساساً تا حدی غیربهینه است و هنوز با -L یا -d پشتیبانی نمی‌شود. هنگام استفاده از حالت مستقیم، حاشیه‌های بالا، راست و پایین بدون هشدار نادیده گرفته می‌شوند.

notcurses(3), notcurses_direct(3), notcurses_visual(3), terminfo(5), unicode(7)

nick black nickblack@linux.com.

v3.0.17