.\" Manpage of menyoki
.TH MENYOKI "1" "March 2023" "menyoki 1.7.0" "دستورات کاربر"
.SH "نام (NAME)"
menyoki \- ابزار خط فرمانی اسکرین‌شات، فیلم‌برداری از صفحه و پردازش تصاویر
.SH "خلاصه دستور (SYNOPSIS)"
.B menyoki
[FLAGS] [OPTIONS] <SUBCOMMAND>
.SH "توضیحات (DESCRIPTION)"
.PP
\f[B]menyoki\f[R] یک ابزار ضبط و اسکرین‌شات از صفحه است که می‌تواند عملیات مختلف مرتبط با تصویر مانند ساخت یا تکه‌تکه کردن GIFها و ویرایش، تحلیل و مشاهده فایل‌های تصویری را نیز انجام دهد.
هدف آن این است که ابزاری سبک در خط فرمان باشد، چه برای کارهای روزمره و چه برای مسائل پیچیده و با جزئیات دقیق.
در ابتدا این ابزار برای ضبط و اسکرین‌شات از پنجره‌های ترمینال طراحی شده بود، اما به سادگی می‌توان با آرگومان‌های خط فرمان، متغیرهای محیطی یا فایل پیکربندی آن را برای اهداف دیگر تنظیم کرد.
.PP
.SH "نحوه استفاده (USAGE)"
.PP
آرگومان‌های خط فرمان \f[B]menyoki\f[R] تا جای ممکن شهودی طراحی شده‌اند.
در نتیجه، یک عملیات می‌تواند با زنجیره‌ای از زیردستورها همراه با فلگ‌ها و گزینه‌ها اجرا شود.
الگوی کلی استفاده از آرگومان‌های خط فرمان به صورت زیر است:
.PP
\f[C]menyoki (ACTION) (FORMAT) (OUTPUT)\f[R]
.PP
زیردستوری که \f[C]عملکرد (action)\f[R] را مشخص می‌کند الزامی است، در حالی که زیردستورهای \f[C]فرمت (format)\f[R] و \f[C]خروجی (output)\f[R] ممکن است اختیاری باشند (یا اصلاً وجود نداشته باشند).
زیردستور \f[C]format\f[R] می‌تواند یکی از فرمت‌های پشتیبانی‌شده باشد و \f[C]output\f[R] نیز اساساً متناظر با زیردستور \f[B]save\f[R] است.
.PP
اگر زیردستوری برای مشخص کردن \f[C]format\f[R] داده نشود، فرمت پیش‌فرض اولین زیردستور فهرست‌شده خواهد بود.
از سوی دیگر، زیردستور \f[B]save\f[R] از پوشه \[lq]menyoki\[rq] در \f[I]home\f[R] (یا \f[I]images\f[R] در صورت وجود) به عنوان دایرکتوری خروجی پیش‌فرض استفاده می‌کند.
.SH "آرگومان‌های عمومی (GENERAL ARGUMENTS)"
.PP
فلگ‌ها و گزینه‌هایی که به طور کلی بر اجرای \f[B]menyoki\f[R] تأثیر می‌گذارند را می‌توان پیش از مشخص کردن عملیات اصلی تنظیم کرد.
سپس زیردستور اصلی (عملیات) باید مشخص شود.
.PP
\f[C]menyoki [FLAGS] [OPTIONS] <SUBCOMMAND>\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
    -h, --help       چاپ اطلاعات راهنما
    -V, --version    چاپ اطلاعات نسخه
    -v, --verbose    افزایش جزئیات لاگ
    -q, --quiet      عدم نمایش خروجی

OPTIONS:
    -c, --config <FILE>    تنظیم فایل پیکربندی
        --color <HEX>      تنظیم رنگ اصلی [پیش‌فرض: 3AA431]

SUBCOMMANDS:
    record     ضبط یک پویانمایی (انیمیشن)
    split      تکه‌تکه کردن یک پویانمایی به فریم‌ها
    make       ساخت یک پویانمایی از فریم‌ها
    capture    عکس‌برداری و اسکرین‌شات از یک تصویر
    edit       ویرایش یک تصویر
    analyze    تحلیل یک تصویر
    view       مشاهده یک تصویر
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(24.4n) lw(45.6n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki -V\f[R]
T}@T{
چاپ اطلاعات نسخه
T}
T{
\f[C]menyoki -vv --color FF00FF <action>\f[R]
T}@T{
تنظیم سطح لاگ روی 2 (trace) و استفاده از \[lq]FF00FF\[rq] به عنوان رنگ اصلی
T}
T{
\f[C]menyoki -q -c menyoki.conf <action>\f[R]
T}@T{
اجرا در حالت بی‌صدا و خواندن پیکربندی از \[lq]menyoki.conf\[rq]
T}
.TE
.SH "زیردستور RECORD (RECORD SUBCOMMAND)"
.PP
\f[B]menyoki\f[R] می‌تواند از ناحیه‌ای از یک پنجره یا کل صفحه ضبط کند و آن را به یک فرمت پشتیبانی‌شده انکود نماید.
انتخاب ناحیه و تغییر اندازه با کلیدهای میانبر انجام می‌شود.
.PP
چند سناریو که عملیات \f[B]record\f[R] در آنها مفید است:
.IP \[bu] 2
ضبط ناحیه مشخصی از یک پنجره
.IP \[bu] 2
ضبط برای یک مدت زمان معین
.IP \[bu] 2
ضبط خروجی یک دستور (به‌ویژه برای برنامه‌های رابط متنی TUI)
.PP
گزینه‌های انکود را می‌توان با استفاده از آرگومان‌های فرمت ارائه‌شده تغییر داد.
(خروجی \f[C]menyoki record gif --help\f[R] را ببینید)
.PP
\f[C]menyoki record [FLAGS] [OPTIONS] [COMMAND] [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
    -r, --root          ضبط پنجره ریشه (تمام صفحه)
    -f, --focus         ضبط پنجره فوکوس‌شده
        --select        انتخاب پنجره برای ضبط
        --parent        ضبط پنجره والد پنجره انتخابی
        --with-alpha    ضبط همراه با کانال آلفا (شفافیت)
        --no-keys       غیرفعال کردن کلیدهای کنترلی هنگام ضبط
    -m, --mouse         انتخاب پنجره با کلیک ماوس
    -h, --help          چاپ اطلاعات راهنما

OPTIONS:
        --action-keys <KEYS>    تنظیم کلیدهای کنترلی [پیش‌فرض: LAlt-S,LAlt-Enter]
        --cancel-keys <KEYS>    تنظیم کلیدهای لغو [پیش‌فرض: LControl-D,Escape]
    -b, --border <BORDER>       تنظیم ضخامت کادر [پیش‌فرض: 1]
    -p, --padding <T:R:B:L>     تنظیم فاصله درونی (padding) ناحیه ضبط
    -s, --size <WxH>            تنظیم ابعاد ناحیه ضبط
    -d, --duration <S>          تنظیم مدت زمان ضبط [پیش‌فرض: ∞]
    -c, --countdown <S>         تنظیم شمارش معکوس قبل از ضبط [پیش‌فرض: 3]
    -t, --timeout <S>           تنظیم مهلت زمانی برای انتخاب پنجره [پیش‌فرض: 300]
    -i, --interval <MS>         تنظیم فاصله نوسازی برای انتخاب پنجره [پیش‌فرض: 10]
        --font <FONT>           تنظیم قلم مورد استفاده برای انتخاب پنجره
        --monitor <NUM>         تنظیم مانیتور برای ضبط به عنوان پنجره ریشه

ARGS:
    <COMMAND>    تنظیم دستور برای اجرا

SUBCOMMANDS:
    gif     استفاده از انکودر GIF
    apng    استفاده از انکودر APNG
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(31.3n) lw(38.7n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki record\f[R]
T}@T{
انتخاب یک پنجره و شروع ضبط با تنظیمات پیش‌فرض
T}
T{
\f[C]menyoki record --root --countdown 5\f[R]
T}@T{
ضبط پنجره ریشه پس از ۵ ثانیه شمارش معکوس
T}
T{
\f[C]menyoki record --focus --with-alpha\f[R]
T}@T{
ضبط پنجره فوکوس‌شده همراه با کانال آلفا (برای شفافیت)
T}
T{
\f[C]menyoki record --size 200x300 --duration 10\f[R]
T}@T{
ضبط ناحیه‌ای با ابعاد 200x300 به مدت ۱۰ ثانیه
T}
T{
\f[C]menyoki record --padding 20:10:0:10 --timeout 120\f[R]
T}@T{
ضبط ناحیه‌ای با پدینگ مشخص‌شده و تنظیم مهلت انتخاب پنجره روی ۱۲۰ ثانیه
T}
T{
\f[C]menyoki record --parent\f[R]
T}@T{
ضبط پنجره والد پنجره انتخاب‌شده
T}
T{
\f[C]menyoki record --root --select --monitor 1\f[R]
T}@T{
ضبط مانیتور اول به عنوان پنجره ریشه
T}
T{
\f[C]menyoki record --border 5\f[R]
T}@T{
ضبط ناحیه انتخاب‌شده با ضخامت حاشیه ۵
T}
T{
\f[C]menyoki record --action-keys LControl-Q,LAlt-W\f[R]
T}@T{
ضبط با تنظیمات پیش‌فرض با استفاده از کلیدهای میانبر سفارشی
T}
T{
\f[C]menyoki record --cancel-keys LControl-X,E\f[R]
T}@T{
ضبط با تنظیمات پیش‌فرض با استفاده از کلیدهای میانبر سفارشی لغو
T}
T{
\f[C]menyoki record gif --fps 15 --quality 90\f[R]
T}@T{
ضبط ۱۵ فریم بر ثانیه با کیفیت ۹۰ درصد
T}
T{
\f[C]menyoki record gif --gifski\f[R]
T}@T{
ضبط و انکود با استفاده از انکودر gifski
T}
T{
\f[C]menyoki record gif save \[dq]test.gif\[dq] --timestamp\f[R]
T}@T{
ضبط و ذخیره به عنوان \[lq]test.gif\[rq] همراه با برچسب زمان در نام فایل
T}
T{
\f[C]menyoki record apng --fps 30\f[R]
T}@T{
ضبط ۳۰ فریم بر ثانیه و انکود به فرمت APNG
T}
T{
\f[C]menyoki -q record save \[dq]-\[dq] > test.gif\f[R]
T}@T{
ضبط و هدایت خروجی به \[lq]test.gif\[rq]
T}
T{
\f[C]menyoki -q record \[dq]kmon -t 2000\[dq]\f[R]
T}@T{
اجرای دستور و ضبط خروجی آن در حالت بی‌صدا
T}
T{
\f[C]menyoki record --font \[dq]-*-dejavu sans-*-*-*-*-17-*-*-*-*-*-*-*\[dq]\f[R]
T}@T{
استفاده از قلم سفارشی برای نمایش ابعاد ناحیه (دستور \f[C]xfontsel\f[R] را ببینید)
T}
.TE
.SH "زیردستور SPLIT (SPLIT SUBCOMMAND)"
.PP
\f[B]menyoki\f[R] می‌تواند با استفاده از زیردستور \f[B]split\f[R] یک پویانمایی را به فریم‌ها (استخراج تصاویر) تقسیم کند و فریم‌ها را با استفاده از زیردستور انتهایی \f[I]format\f[R] در یکی از فرمت‌های پشتیبانی‌شده ذخیره نماید.
.PP
\f[C]menyoki split [OPTIONS] <FILE> [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
    -h, --help    چاپ اطلاعات راهنما

OPTIONS:
    -d, --dir <DIRECTORY>    تنظیم دایرکتوری خروجی

ARGS:
    <FILE>    تنظیم فایل پویانمایی

SUBCOMMANDS:
    png     استفاده از انکودر PNG
    jpg     استفاده از انکودر JPG
    webp    استفاده از انکودر WebP
    bmp     استفاده از انکودر BMP
    ico     استفاده از انکودر ICO
    tiff    استفاده از انکودر TIFF
    tga     استفاده از انکودر TGA
    pnm     استفاده از انکودر PNM
    ff      استفاده از انکودر farbfeld
    exr     استفاده از انکودر OpenEXR
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(30.1n) lw(39.9n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki split rec.gif\f[R]
T}@T{
استخراج فریم‌ها از فایل \[lq]rec.gif\[rq]
T}
T{
\f[C]menyoki split rec.gif jpg --quality 100\f[R]
T}@T{
استخراج فریم‌ها به فرمت JPEG با حداکثر کیفیت
T}
T{
\f[C]menyoki split rec.gif --dir frames/\f[R]
T}@T{
استخراج فریم‌ها و ذخیره آن‌ها در دایرکتوری مشخص‌شده
T}
.TE
.SH "زیردستور MAKE (MAKE SUBCOMMAND)"
.PP
زیردستور \f[B]make\f[R] با هدف ایجاد یک پویانمایی از مجموعه‌ای از تصاویر به کار می‌رود.
به عنوان مثال، می‌توان از آن برای ساخت GIF از تصاویر داده‌شده، چه از طریق خط فرمان و چه از طریق دایرکتوری مشخص‌شده، استفاده کرد.
.PP
\f[C]menyoki make [FLAGS] [OPTIONS] <FRAMES>... [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
        --gifski     استفاده از انکودر gifski
        --fast       انکود ۳ برابر سریع‌تر (gifski)
    -n, --no-sort    استفاده از فریم‌ها به همان ترتیب ارائه‌شده
    -h, --help       چاپ اطلاعات راهنما

OPTIONS:
    -f, --fps <FPS>            تنظیم نرخ فریم بر ثانیه (FPS) [پیش‌فرض: 20]
    -q, --quality <QUALITY>    تنظیم کیفیت فریم (1-100) [پیش‌فرض: 75]
    -r, --repeat <REPEAT>      تنظیم تعداد دفعات تکرار [پیش‌فرض: \[if]]
    -d, --dir <DIRECTORY>      تنظیم دایرکتوری برای خواندن فریم‌ها
        --format <FORMAT>      تنظیم فرمت پویانمایی [پیش‌فرض: gif] [مقادیر ممکن: gif, apng]

ARGS:
    <FRAMES>...    تنظیم فریم‌های پویانمایی

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(30.2n) lw(39.8n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki make 1.png 2.png\f[R]
T}@T{
ساخت یک GIF متشکل از دو فریم \[lq]1.png\[rq] و \[lq]2.png\[rq]
T}
T{
\f[C]menyoki make 1.png 2.png --fps 5 --quality 100\f[R]
T}@T{
ساخت یک GIF با مشخصات تعیین‌شده از فریم‌های داده‌شده
T}
T{
\f[C]menyoki make 1.png 2.png save 3.gif --date\f[R]
T}@T{
ساخت GIF و ذخیره فایل (\[lq]3.gif\[rq]) همراه با اطلاعات تاریخ
T}
T{
\f[C]menyoki make 1.png 2.png --format apng\f[R]
T}@T{
ساخت یک APNG از فریم‌های داده‌شده
T}
T{
\f[C]menyoki make --dir frames/\f[R]
T}@T{
ساخت یک GIF از فریم‌های موجود در دایرکتوری مشخص‌شده
T}
.TE
.SH "زیردستور CAPTURE (CAPTURE SUBCOMMAND)"
.PP
\f[B]menyoki\f[R] می‌تواند از ناحیه‌ای از یک پنجره یا کل صفحه تصویربرداری (اسکرین‌شات) کند و آن را در یکی از فرمت‌های پشتیبانی‌شده انکود نماید.
فرمت‌هایی مانند \f[B]png\f[R]، \f[B]jpg\f[R] و \f[B]pnm\f[R] فلگ‌ها و گزینه‌های خاص خود را دارند که می‌توان برای تغییر تنظیمات انکود پیش‌فرض استفاده کرد.
مشابه زیردستور \f[B]record\f[R]، انتخاب ناحیه و تغییر اندازه با کلیدهای میانبر انجام می‌شود.
همان فلگ‌ها و گزینه‌ها می‌توانند برای هر دو زیردستور \f[B]record\f[R] و \f[B]capture\f[R] اعمال شوند زیرا این دو عملیات به صورت انتزاعی مشابه یکدیگر هستند.
.PP
\f[C]menyoki capture [FLAGS] [OPTIONS] [COMMAND] [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
    -r, --root          عکس‌برداری از پنجره ریشه (تمام صفحه)
    -f, --focus         عکس‌برداری از پنجره فوکوس‌شده
        --select        انتخاب پنجره برای عکس‌برداری
        --parent        عکس‌برداری از پنجره والد پنجره انتخابی
        --with-alpha    عکس‌برداری همراه با کانال آلفا (شفافیت)
    -m, --mouse         انتخاب پنجره با کلیک ماوس
    -h, --help          چاپ اطلاعات راهنما

OPTIONS:
        --action-keys <KEYS>    تنظیم کلیدهای کنترلی [پیش‌فرض: LAlt-S,LAlt-Enter]
        --cancel-keys <KEYS>    تنظیم کلیدهای لغو [پیش‌فرض: LControl-D,Escape]
    -b, --border <BORDER>       تنظیم ضخامت کادر [پیش‌فرض: 1]
    -p, --padding <T:R:B:L>     تنظیم فاصله درونی (padding) ناحیه عکس‌برداری
    -s, --size <WxH>            تنظیم ابعاد ناحیه عکس‌برداری
    -c, --countdown <S>         تنظیم شمارش معکوس قبل از عکس‌برداری [پیش‌فرض: 0]
    -t, --timeout <S>           تنظیم مهلت زمانی برای انتخاب پنجره [پیش‌فرض: 300]
    -i, --interval <MS>         تنظیم فاصله نوسازی برای انتخاب پنجره [پیش‌فرض: 10]
        --font <FONT>           تنظیم قلم مورد استفاده برای انتخاب پنجره
        --monitor <NUM>         تنظیم مانیتور برای عکس‌برداری به عنوان پنجره ریشه

ARGS:
    <COMMAND>    تنظیم دستور برای اجرا

SUBCOMMANDS:
    png     استفاده از انکودر PNG
    jpg     استفاده از انکودر JPG
    webp    استفاده از انکودر WebP
    bmp     استفاده از انکودر BMP
    ico     استفاده از انکودر ICO
    tiff    استفاده از انکودر TIFF
    tga     استفاده از انکودر TGA
    pnm     استفاده از انکودر PNM
    ff      استفاده از انکودر farbfeld
    exr     استفاده از انکودر OpenEXR
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(26.1n) lw(43.9n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki capture\f[R]
T}@T{
انتخاب یک پنجره و عکس‌برداری با تنظیمات پیش‌فرض
T}
T{
\f[C]menyoki capture --root --countdown 5\f[R]
T}@T{
عکس‌برداری از پنجره ریشه پس از ۵ ثانیه شمارش معکوس
T}
T{
\f[C]menyoki capture --focus --with-alpha\f[R]
T}@T{
عکس‌برداری از پنجره فوکوس‌شده همراه با کانال آلفا (برای شفافیت)
T}
T{
\f[C]menyoki capture --size 200x300 --duration 10\f[R]
T}@T{
عکس‌برداری از ناحیه‌ای با ابعاد 200x300 به مدت ۱۰ ثانیه
T}
T{
\f[C]menyoki capture --padding 20:10:0:10 --timeout 120\f[R]
T}@T{
عکس‌برداری از ناحیه‌ای با پدینگ مشخص و تنظیم مهلت انتخاب پنجره روی ۱۲۰ ثانیه
T}
T{
\f[C]menyoki capture png --filter avg --compression fast\f[R]
T}@T{
عکس‌برداری و انکود با گزینه‌های مشخص‌شده PNG
T}
T{
\f[C]menyoki capture jpg --quality 100\f[R]
T}@T{
عکس‌برداری و انکود با گزینه‌های مشخص‌شده JPEG
T}
T{
\f[C]menyoki capture webp --lossless\f[R]
T}@T{
عکس‌برداری و انکود با گزینه‌های مشخص‌شده WEBP
T}
T{
\f[C]menyoki capture pnm --format pixmap --encoding ascii\f[R]
T}@T{
عکس‌برداری و انکود با گزینه‌های مشخص‌شده PNM
T}
T{
\f[C]menyoki capture ff save \[dq]test.ff\[dq] --timestamp\f[R]
T}@T{
عکس‌برداری و ذخیره به عنوان \[lq]test.ff\[rq] در فرمت farbfeld با برچسب زمان در نام فایل
T}
T{
\f[C]menyoki -q capture png save \[dq]-\[dq] > test.png\f[R]
T}@T{
عکس‌برداری و هدایت خروجی به \[lq]test.png\[rq]
T}
T{
\f[C]menyoki -q capture \[dq]kmon -t 2000\[dq]\f[R]
T}@T{
اجرای دستور و عکس‌برداری از خروجی آن در حالت بی‌صدا (به طور ضمنی شمارش معکوس را روی ۳ تنظیم می‌کند)
T}
.TE
.SH "زیردستور EDIT (EDIT SUBCOMMAND)"
.PP
زیردستور \f[B]edit\f[R] می‌تواند برای
ویرایش (https://github.com/image-rs/image#image-processing-functions)
(دستکاری، فیلتر و تبدیل) فایل‌ها در یکی از فرمت‌های پشتیبانی‌شده استفاده شود.
به غیر از فلگ‌ها و گزینه‌هایی که \f[B]edit\f[R] ارائه می‌دهد، سایر گزینه‌های انکود را می‌توان از طریق زیردستور \f[I]format\f[R] مشخص کرد.
.PP
\f[C]menyoki edit [FLAGS] [OPTIONS] <FILE> [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
        --convert      تبدیل تصویر با استفاده از انکودر ارائه‌شده
        --grayscale    تبدیل تصویر به مقیاس خاکستری
        --invert       معکوس کردن رنگ‌های تصویر
    -h, --help         چاپ اطلاعات راهنما

OPTIONS:
        --crop <T:R:B:L>             اعمال فاصله درونی برای برش تصویر
        --resize <WxH>               تغییر اندازه تصویر بدون حفظ نسبت ابعاد
        --ratio <RATIO>              تغییر اندازه متناسب تصویر بر اساس نسبت ابعاد [پیش‌فرض: 1.0]
        --rotate <ROTATE>            چرخش تصویر (در جهت عقربه‌های ساعت) [مقادیر ممکن: 90, 180, 270]
        --flip <FLIP>                وارونه کردن تصویر [مقادیر ممکن: horizontal, vertical]
        --blur <SIGMA>               تار کردن تصویر [پیش‌فرض: 0.0]
        --hue <HUE>                  تنظیم فام رنگی (hue) تصویر [پیش‌فرض: \[t+-]0]
        --contrast <CONTRAST>        تنظیم کنتراست تصویر [پیش‌فرض: \[t+-]0.0]
        --brightness <BRIGHTNESS>    تنظیم روشنایی تصویر [پیش‌فرض: \[t+-]0]
        --filter <FILTER>            تنظیم فیلتر نمونه‌برداری برای تغییر مقیاس [پیش‌فرض: lanczos3] [مقادیر ممکن: nearest, triangle, catmull-rom, gaussian, lanczos3]

ARGS:
    <FILE>    تنظیم فایل ورودی

SUBCOMMANDS:
    gif     استفاده از انکودر GIF
    apng    استفاده از انکودر APNG
    png     استفاده از انکودر PNG
    jpg     استفاده از انکودر JPG
    webp    استفاده از انکودر WebP
    bmp     استفاده از انکودر BMP
    ico     استفاده از انکودر ICO
    tiff    استفاده از انکودر TIFF
    tga     استفاده از انکودر TGA
    pnm     استفاده از انکودر PNM
    ff      استفاده از انکودر farbfeld
    exr     استفاده از انکودر OpenEXR
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(45.1n) lw(24.9n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki edit test.png\f[R]
T}@T{
انکود مجدد فایل \[lq]test.png\[rq] بدون ویرایش
T}
T{
\f[C]menyoki edit test.png --grayscale\f[R]
T}@T{
تبدیل تصویر به مقیاس خاکستری
T}
T{
\f[C]menyoki edit test.png --invert\f[R]
T}@T{
معکوس کردن رنگ‌های تصویر
T}
T{
\f[C]menyoki edit test.png --crop 20:20:20:20\f[R]
T}@T{
اعمال پدینگ ارائه‌شده به تصویر برای برش دادن
T}
T{
\f[C]menyoki edit test.png --resize 300x300\f[R]
T}@T{
تغییر ابعاد تصویر به 300x300 (بدون حفظ نسبت ابعاد)
T}
T{
\f[C]menyoki edit test.png --ratio 0.5\f[R]
T}@T{
تغییر اندازه تصویر به نصف (با استفاده از نسبت ابعاد)
T}
T{
\f[C]menyoki edit test.png --ratio 2.0 --filter gaussian\f[R]
T}@T{
تغییر اندازه تصویر با استفاده از فیلتر نمونه‌برداری مشخص‌شده
T}
T{
\f[C]menyoki edit test.png --rotate 90\f[R]
T}@T{
چرخش تصویر به میزان ۹۰ درجه (در جهت عقربه‌های ساعت)
T}
T{
\f[C]menyoki edit test.png --flip horizontal\f[R]
T}@T{
وارونه کردن تصویر به صورت افقی
T}
T{
\f[C]menyoki edit test.png --blur 2.0\f[R]
T}@T{
تار کردن تصویر
T}
T{
\f[C]menyoki edit test.png --hue 100\f[R]
T}@T{
تنظیم فام رنگی تصویر
T}
T{
\f[C]menyoki edit test.png --contrast -10.5\f[R]
T}@T{
تنظیم کنتراست تصویر
T}
T{
\f[C]menyoki edit test.png --brightness 50\f[R]
T}@T{
تنظیم روشنایی تصویر
T}
T{
\f[C]menyoki edit test.png --convert tga\f[R]
T}@T{
تبدیل تصویر به فرمت TGA
T}
T{
\f[C]menyoki edit test.png --convert jpg --quality 80\f[R]
T}@T{
تبدیل تصویر به فرمت JPEG با کیفیت ۸۰ درصد
T}
T{
\f[C]menyoki edit test.gif --ratio 0.25 gif --quality 80\f[R]
T}@T{
تغییر اندازه و انکود مجدد \[lq]test.gif\[rq]
T}
T{
\f[C]menyoki edit test.gif gif --speed 0.5\f[R]
T}@T{
کاهش سرعت GIF (نصف سرعت)
T}
T{
\f[C]menyoki edit test.gif gif --cut-beginning 1.0 --cut-end 0.5\f[R]
T}@T{
برش مدت زمان GIF بر حسب ثانیه
T}
T{
\f[C]menyoki edit test.apng --convert gif\f[R]
T}@T{
تبدیل APNG به GIF
T}
T{
\f[C]menyoki edit test.ff --grayscale --convert pnm --format arbitrary save \[dq]output\[dq] --with-extension --date \[dq]%H%M%S\[dq]\f[R]
T}@T{
test.ff (farbfeld) -> grayscale -> output_020035.pam (PNM)
T}
.TE
.SH "زیردستور ANALYZE (ANALYZE SUBCOMMAND)"
.PP
زیردستور \f[B]analyze\f[R] برای بررسی یک فایل تصویری در یکی از فرمت‌های پشتیبانی‌شده و ایجاد یک گزارش بر اساس جزئیات تصویر به کار می‌رود.
گزارش شامل ۲ الی ۳ بخش است که شامل اطلاعات فایل، تصویر و اطلاعات EXIF می‌باشد.
.PP
\f[C]menyoki analyze [FLAGS] [OPTIONS] <FILE> [SUBCOMMAND]\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
        --timestamp    استفاده از برچسب زمان یونیکس برای تاریخ‌های گزارش
    -h, --help         چاپ اطلاعات راهنما

OPTIONS:
    -t, --time-zone <TIMEZONE>    تنظیم منطقه زمانی گزارش [پیش‌فرض: utc] [مقادیر ممکن: utc, local]

ARGS:
    <FILE>    تنظیم فایل تصویر

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(33.2n) lw(36.8n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki analyze test.jpg\f[R]
T}@T{
بررسی \[lq]test.jpg\[rq] و چاپ گزارش
T}
T{
\f[C]menyoki analyze test.jpg save test_report.txt\f[R]
T}@T{
بررسی \[lq]test.jpg\[rq] و ذخیره گزارش به عنوان \[lq]test_report.txt\[rq]
T}
T{
\f[C]menyoki analyze test.jpg --timestamp\f[R]
T}@T{
بررسی فایل و ایجاد گزارش بر اساس برچسب‌های زمانی
T}
T{
\f[C]menyoki analyze test.jpg --time-zone local\f[R]
T}@T{
بررسی فایل و ایجاد گزارش بر اساس منطقه زمانی محلی
T}
T{
\f[C]menyoki analyze test.jpg --timestamp save --timestamp\f[R]
T}@T{
استفاده از برچسب زمان هم برای گزارش تحلیل و هم برای نام فایل
T}
.TE
.SH "زیردستور VIEW (VIEW SUBCOMMAND)"
.PP
زیردستور \f[B]view\f[R] را می‌توان به سادگی برای مشاهده یک تصویر از داخل ترمینال استفاده کرد.
این بخش از کتابخانه اصلی viu (https://github.com/atanunq/viu) استفاده می‌کند.
.PP
\f[C]menyoki view [FLAGS] <FILE>\f[R]
.SS "آرگومان‌ها (Arguments)"
.IP
.nf
\f[C]
FLAGS:
    -t, --transparent    نمایش تصویر دارای شفافیت با پس‌زمینه شفاف
    -h, --help           چاپ اطلاعات راهنما

ARGS:
    <FILE>    تنظیم فایل ورودی
\f[R]
.fi
.SS "مثال‌ها (EXAMPLES)"
.PP
.TS
tab(@);
lw(27.3n) lw(42.7n).
T{
دستور
T}@T{
عملیات
T}
_
T{
\f[C]menyoki view test.jpg\f[R]
T}@T{
مشاهده \[lq]test.jpg\[rq] از درون ترمینال
T}
T{
\f[C]menyoki view test.png --transparent\f[R]
T}@T{
مشاهده \[lq]test.png\[rq] از درون ترمینال با فعال بودن شفافیت
T}
.TE
.SH "سایر زیردستورها (OTHER SUBCOMMANDS)"
.PP
امکان تغییر گزینه‌های انکود GIF، APNG، PNG، JPG و PNM با مشخص کردن فلگ‌ها یا گزینه‌ها برای زیردستورهای مربوطه وجود دارد.
همچنین از زیردستور \f[B]save\f[R] می‌توان برای تغییر تنظیمات پیش‌فرض خروجی استفاده کرد.
.SS "زیردستور GIF/APNG"
.IP
.nf
\f[C]
FLAGS:
        --gifski    استفاده از انکودر gifski         <فقط در GIF>
        --fast      انکود ۳ برابر سریع‌تر (gifski)   <فقط در GIF>
    -h, --help      چاپ اطلاعات راهنما

OPTIONS:
    -f, --fps <FPS>            تنظیم FPS [پیش‌فرض: 20]
    -q, --quality <QUALITY>    تنظیم کیفیت فریم (1-100) [پیش‌فرض: 75] <فقط در GIF>
    -r, --repeat <REPEAT>      تنظیم تعداد دفعات تکرار [پیش‌فرض: \[if]]
    -s, --speed <SPEED>        تنظیم سرعت GIF [پیش‌فرض: 1.0]
        --cut-beginning <S>    برش از ابتدای GIF [پیش‌فرض: 0.0]
        --cut-end <S>          برش از انتهای GIF [پیش‌فرض: 0.0]

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.PP
(برخی گزینه‌ها ممکن است فقط با یک عملیات خاص قابل استفاده باشند)
.SS "زیردستور PNG"
.IP
.nf
\f[C]
FLAGS:
    -h, --help    چاپ اطلاعات راهنما

OPTIONS:
    -c, --compression <COMPRESSION>    تنظیم سطح فشرده‌سازی [پیش‌فرض: fast] [مقادیر ممکن: default, fast, best]
    -f, --filter <FILTER>              تنظیم الگوریتم فیلتر [پیش‌فرض: sub] [مقادیر ممکن: none, sub, up, avg, paeth]

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "زیردستور JPG"
.IP
.nf
\f[C]
FLAGS:
    -h, --help    چاپ اطلاعات راهنما

OPTIONS:
    -q, --quality <QUALITY>    تنظیم کیفیت تصویر (1-100) [پیش‌فرض: 90]

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "زیردستور WEBP"
.IP
.nf
\f[C]
FLAGS:
    -l, --lossless    استفاده از انکود بدون افت کیفیت (lossless)
    -h, --help        چاپ اطلاعات راهنما

OPTIONS:
    -q, --quality <QUALITY>    تنظیم کیفیت انکود با افت کیفیت (1-100) [پیش‌فرض: 80]

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "زیردستور PNM"
.IP
.nf
\f[C]
FLAGS:
    -h, --help    چاپ اطلاعات راهنما

OPTIONS:
    -f, --format <FORMAT>        تنظیم فرمت PNM [پیش‌فرض: pixmap] [مقادیر ممکن: bitmap, graymap, pixmap, arbitrary]
    -e, --encoding <ENCODING>    تنظیم انکودینگ برای ذخیره نمونه‌ها [پیش‌فرض: binary] [مقادیر ممکن: binary, ascii]

SUBCOMMANDS:
    save    ذخیره فایل(های) خروجی
\f[R]
.fi
.SS "زیردستور Save"
.IP
.nf
\f[C]
FLAGS:
    -e, --with-extension    همیشه فایل را با پسوند ذخیره کند
    -t, --timestamp         افزودن برچسب زمان یونیکس به نام فایل
    -h, --help              چاپ اطلاعات راهنما

OPTIONS:
    -d, --date <FORMAT>    افزودن تاریخ/زمان فرمت‌بندی‌شده به نام فایل [پیش‌فرض: %Y%m%dT%H%M%S]

ARGS:
    <FILE>    تنظیم فایل خروجی
\f[R]
.fi
.SH "کلیدهای میانبر (KEY BINDINGS)"
.PP
کلیدهای میانبر فقط در هنگام اجرای عملیات \f[B]capture\f[R] یا \f[B]record\f[R] فعال و موجود هستند.
اساساً کلیدهای میانبر برای انتخاب نواحی عکس‌برداری/ضبط و تغییر اندازه آنها بدون نیاز به ماوس هستند.
.PP
از نظر نوع عملیات انجام‌شده، ۳ نوع کلید میانبر وجود دارد:
.IP \[bu] 2
کلیدهای کنترلی اصلی (کلیدهای عملیات اصلی مانند \f[C]LAlt-S\f[R] که می‌توان از طریق گزینه‌های \f[C]--action-keys\f[R] و \f[C]--cancel-keys\f[R] آن‌ها را
سفارشی‌سازی کرد (https://docs.rs/device_query/latest/device_query/keymap/enum.Keycode.html))
.IP \[bu] 2
کلیدهای لغو (کلیدهایی که عملیات را لغو می‌کنند، مانند \f[C]LControl-D\f[R])
.IP \[bu] 2
کلیدهای متفرقه (کلیدهایی که می‌توان برای تغییر اندازه ناحیه انتخابی استفاده کرد مانند \f[C]LAlt-[up]\f[R])
.PP
.TS
tab(@);
lw(25.5n) lw(44.5n).
T{
کلید
T}@T{
عملیات
T}
_
T{
\f[C]LAlt-[S/Enter]\f[R]
T}@T{
شروع/توقف ضبط یا اسکرین‌شات از ناحیه انتخابی
T}
T{
\f[C]LControl-D, Escape\f[R]
T}@T{
لغو عملیات جاری
T}
T{
\f[C]LControl-C\f[R]
T}@T{
لغو عملیات جاری یا توقف ضبط
T}
T{
\f[C]LAlt-[arrow keys/hjkl]\f[R]
T}@T{
افزایش پدینگ ناحیه (کاهش اندازه ناحیه)
T}
T{
\f[C]LControl-LAlt-[arrow keys/hjkl]\f[R]
T}@T{
کاهش پدینگ ناحیه (افزایش اندازه ناحیه)
T}
T{
\f[C]LShift-LAlt-[arrow keys/hjkl]\f[R]
T}@T{
تغییر موقعیت ناحیه انتخابی (جابجایی)
T}
T{
\f[C]LAlt-[1-9]\f[R]
T}@T{
تنظیم ضریب سرعت تغییر اندازه ناحیه (پیش‌فرض: ۳)
T}
T{
\f[C]LAlt-R\f[R]
T}@T{
بازنشانی پدینگ ناحیه به مقدار پیش‌فرض
T}
.TE
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Orhun Parmaksız <orhunparmaksiz@gmail.com>
.SH "گزارش باگ‌ها (REPORTING BUGS)"
تماس با نویسنده از طریق ایمیل یا استفاده از بخش مشکلات در گیت‌هاب: <https://github.com/orhun/menyoki/issues>
.SH "حق نشر (COPYRIGHT)"
حق نشر © 2020-2024 Orhun Parmaksız
.RS 0
تحت مجوز GPLv3: <https://gnu.org/licenses/gpl.html>
.SH "همچنین ببینید (SEE ALSO)"
.BR menyoki.conf (5)

برای مستندات کامل، صفحه اصلی پروژه را در <https://github.com/orhun/menyoki> مشاهده کنید.