.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "ncplayer" "1" "v3.0.17" ""
.SH "نام (NAME)"
ncplayer \- رندر تصاویر و ویدیو در یک ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]ncplayer\f[R]\ [\f[B]\-h\f[R]]\ [\f[B]\-V\f[R]] [\f[B]\-q\f[R]]
[\f[B]\-d\f[R]\ \f[B]\f[BI]delaymult\f[B]\f[R]]\ [\f[B]\-l\f[R]\ \f[B]\f[BI]loglevel\f[B]\f[R]]
[\f[B]\-b\f[R] \f[B]\f[BI]blitter\f[B]\f[R]] [\f[B]\-s\f[R]
\f[B]\f[BI]scalemode\f[B]\f[R]] [\f[B]\-k\f[R]] [\f[B]\-L\f[R]]
[\f[B]\-t\f[R] \f[B]\f[BI]seconds\f[B]\f[R]] [\f[B]\-n\f[R]]
[\f[B]\-a\f[R] \f[B]\f[BI]color\f[B]\f[R]] files
.SH "توضیحات (DESCRIPTION)"
برنامه \f[B]ncplayer\f[R] از یک نسخه چندرسانه‌ای Notcurses برای رندر تصاویر و ویدیوها درون ترمینال استفاده می‌کند.
به‌طور پیش‌فرض، مقیاس‌بندی از نوع \f[B]stretch\f[R] (کشش) برای پر کردن ناحیه رندر استفاده می‌شود و باکیفیت‌ترین بلیتِر (blitter) موجود به کار گرفته خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
\f[B]\-d\f[R] \f[B]\f[BI]delaymult\f[B]\f[R]: اعمال یک ضریب گویای غیرمنفی به مقیاس تاخیر (delayscale).
تنها برای رسانه‌های چندفریمی مانند ویدیو و تصاویر متحرک اعمال می‌شود.
همراه با \f[B]\-k\f[R] پشتیبانی نمی‌شود.
.PP
\f[B]\-t\f[R] \f[B]\f[BI]seconds\f[B]\f[R]: تاخیر به میزان \f[B]seconds\f[R] ثانیه پس از هر فایل.
اگر از این گزینه استفاده شود، اعلان «press any key to continue» نمایش داده نخواهد شد.
مقدار \f[B]seconds\f[R] می‌تواند هر عدد غیرمنفی باشد.
.PP
\f[B]\-l\f[R] \f[B]\f[BI]loglevel\f[B]\f[R]: ثبت گزارش در خروجی استاندارد خطا (stderr) بین همه چیز (سطح گزارش ۷) و هیچ چیز (سطح گزارش ۰).
.PP
\f[B]\-s\f[R] \f[B]\f[BI]scalemode\f[B]\f[R]: حالت مقیاس‌بندی؛ یکی از موارد
\f[B]none\f[R]، \f[B]hires\f[R]، \f[B]scale\f[R]، \f[B]scalehi\f[R] یا
\f[B]stretch\f[R].
.PP
\f[B]\-b\f[R] \f[B]\f[BI]blitter\f[B]\f[R]: بلیتِر (blitter)؛ یکی از موارد
\f[B]ascii\f[R]، \f[B]half\f[R]، \f[B]quad\f[R]، \f[B]sex\f[R]،
\f[B]oct\f[R]، \f[B]braille\f[R] یا \f[B]pixel\f[R].
.PP
\f[B]\-m margins\f[R]: تعیین حاشیه‌های رندر (به بخش زیر مراجعه کنید).
.PP
\f[B]\-L\f[R]: تکرار حلقه‌ای فریم‌ها تا زمانی که کلیدی فشرده شود.
همراه با \f[B]\-k\f[R] پشتیبانی نمی‌شود.
.PP
\f[B]\-k\f[R]: استفاده از حالت مستقیم (بخش \f[B]notcurses_direct(3)\f[R] را ببینید).
این گزینه موجب باقی ماندن خروجی روی صفحه پس از خروج از برنامه شده و آن را به صورت درون‌سطحی (inline) تولید می‌کند (به‌جای پاک کردن صفحه و قرار دادن آن در بالا).
همراه با \f[B]\-L\f[R] یا \f[B]\-d\f[R] پشتیبانی نمی‌شود.
.PP
\f[B]\-q\f[R]: عدم چاپ اطلاعات فریم/زمان‌بندی در بالای صفحه، و همچنین عدم چاپ خلاصه خروجی هنگام خروج.
.PP
\f[B]\-a\f[R]: رفتار با \f[B]\f[BI]color\f[B]\f[R] به عنوان رنگ شفاف (transparent).
.PP
\f[B]\-n\f[R]: استفاده از مقیاس‌بندی بدون درون‌یابی (non\-interpolative).
نتیجه معمولاً از لحاظ بصری جذابیت کمتری دارد، اما رنگ‌های جدید تولید نمی‌کند.
.PP
\f[B]\-V\f[R]: چاپ نام و نسخه برنامه، و خروج با وضعیت موفقیت‌آمیز.
.PP
\f[B]\-h\f[R]: چاپ اطلاعات راهنما، و خروج با وضعیت موفقیت‌آمیز.
.PP
files: انتخاب اینکه کدام فایل‌ها رندر شوند و ترتیب رندر آن‌ها چگونه باشد.
.PP
حاشیه‌های پیش‌فرض همگی ۰ هستند و مقیاس‌بندی پیش‌فرض \f[B]stretch\f[R] است.
بنابراین تمام ناحیه رندر استفاده خواهد شد.
با استفاده از \f[B]\-m\f[R]، می‌توان حاشیه‌ها را مشخص کرد.
یک عدد واحد برای تنظیم هر چهار حاشیه روی همان مقدار ارائه دهید، یا
چهار مقدار جداشده با کاما را به ترتیب برای حاشیه‌های بالا، راست، پایین و چپ مشخص کنید.
هنگام استفاده از \f[B]\-k\f[R]، حاشیه‌های بالا، راست و پایین نادیده گرفته می‌شوند.
حاشیه‌های منفی مجاز نیستند.
.PP
حالت مقیاس‌بندی \f[B]stretch\f[R] اندازه شیء را دقیقاً مطابق با ناحیه رندر هدف تغییر می‌دهد.
مگر اینکه یک بلیتِر با \f[B]\-b\f[R] مشخص شده باشد، \f[B]stretch\f[R] از باکیفیت‌ترین بلیتِر در دسترس استفاده خواهد کرد.
حالت \f[B]scale\f[R] اندازه شیء را طوری تغییر می‌دهد که لبه طولانی‌تر ناحیه رندر دقیقاً منطبق شود، و لبه دیگر برای حفظ نسبت تصویر تنظیم می‌گردد.
حالت \f[B]none\f[R] از اندازه اصلی تصویر استفاده می‌کند.
هر دو حالت \f[B]scale\f[R] و \f[B]none\f[R] نسبت تصویر ۱:۱ را هدف قرار می‌دهند، و بنابراین \f[B]half\f[R] را به \f[B]quad\f[R]، \f[B]sex\f[R]، \f[B]oct\f[R] یا \f[B]braille\f[R] ترجیح خواهند داد.
حالت‌های \f[B]scalehi\f[R] و \f[B]hires\f[R] از بالاترین وضوح بلیتِر موجود استفاده می‌کنند.
.PP
بلیتِرها را می‌توان در زمان اجرا با فشردن کلیدهای «0» تا «6» انتخاب کرد.
مقدار \f[B]NCBLIT_DEFAULT\f[R] متناظر با «0» است.
بلیتِرهای مختلف در \f[B]notcurses_visual(3)\f[R] شرح داده شده‌اند.
اگر بلیتِری در محیط فعلی قابل استفاده نباشد، بلیتِر فعلی حفظ خواهد شد.
.PP
رسانه‌های چندفریمی را می‌توان با فشردن کلید فاصله (Space) متوقف (pause) کرد.
کلید فاصله (یا هر کلید کنترلی معتبر دیگر) را فشار دهید تا پخش ادامه یابد.
.SH "نکات (NOTES)"
اگر به دنبال یک نمایشگر تصویر سریع و درون‌سطحی برای پوسته (shell) هستید، اجرای \f[B]ncplayer \-k \-t0 \-q\f[R] را امتحان کنید.
.PP
نمایش بهینه نیازمند ترمینالی است که قابلیت \f[B]rgb\f[R] را در terminfo(5) ارائه دهد، یا اینکه متغیر محیطی \f[B]COLORTERM\f[R] روی \f[B]24bit\f[R] تعریف شده باشد (و ترمینال از این متغیر پشتیبانی کند)، همراه با یک فونت تک‌فاصله (fixed\-width) با پوشش مناسبی از نویسه‌های رسم بلوک یونیکد (Unicode Block Drawing Characters).
.SH "اشکالات (BUGS)"
حالت مستقیم برای رسانه‌های چندفریمی اساساً تا حدی غیربهینه است و هنوز با \f[B]\-L\f[R] یا \f[B]\-d\f[R] پشتیبانی نمی‌شود.
هنگام استفاده از حالت مستقیم، حاشیه‌های بالا، راست و پایین بدون هشدار نادیده گرفته می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
\f[B]notcurses(3)\f[R], \f[B]notcurses_direct(3)\f[R],
\f[B]notcurses_visual(3)\f[R], \f[B]terminfo(5)\f[R],
\f[B]unicode(7)\f[R]
.SH "نویسندگان (AUTHORS)"
nick black \c
.MT nickblack@linux.com
.ME \c.