نام (NAME)

Flameshot - نرم‌افزار قدرتمند و در عین حال ساده برای ثبت تصویر از صفحه نمایش

خلاصه دستور (SYNOPSIS)

flameshot [subcommands] [arguments]
flameshot gui [gui arguments]
flameshot screen [screen arguments]
flameshot full [fullscreen arguments]
flameshot config [config arguments]
flameshot launcher

توضیحات (DESCRIPTION)

این صفحه راهنما به طور خلاصه دستور flameshot عرضه‌شده توسط بسته flameshot را شرح می‌دهد.

ابزار flameshot برنامه‌ای برای گرفتن اسکرین‌شات است که هدف آن ارائه امکاناتی قدرتمند در کنار کاربری ساده است. از ویژگی‌های برجسته آن می‌توان به ظاهر قابل شخصی‌سازی، ویرایش درون‌برنامه‌ای تصویر گرفته‌شده، رابط کاربری D-Bus، پشتیبانی از آیکون سینی اعلان سیستم (tray)، پشتیبانی آزمایشی از وی‌لند در GNOME/KDE، یکپارچگی با Imgur و پشتیبانی از هر دو رابط کاربری گرافیکی (GUI) و خط فرمان (CLI) اشاره کرد.

افزون بر اطلاعات نحوه استفاده از flameshot در این صفحه راهنما، می‌توانید اطلاعات مشابهی را با استفاده از flameshot --help نیز مشاهده کنید. همچنین می‌توان از همان گزینه --help برای هر زیردستور استفاده کرد تا آرگومان‌های مجاز آن نمایش داده شوند. جزئیات بیشتر درباره نحوه استفاده از flameshot در فایل README.md در صفحه مخزن گیت پروژه مستند شده است: https://github.com/flameshot-org/flameshot

زیردستورها (SUBCOMMANDS)

به طور پیش‌فرض و بدون ذکر زیردستورها، flameshot در پس‌زمینه اجرا شده و یک آیکون سینی سیستم برای پیکربندی اضافه می‌کند. توجه داشته باشید که این دستور اسکرین‌شاتی نخواهد گرفت مگر اینکه یکی از حالت‌ها را از طریق زیردستورها مشخص کنید. زیردستورهای گوناگونی برای استفاده از flameshot در حالت‌های مختلف وجود دارند:

gui: اجرای Flameshot در حالت gui به کاربر امکان می‌دهد ناحیه‌ای را که باید از آن اسکرین‌شات گرفته شود انتخاب کرده و سپس روی آن یادداشت‌نویسی و ویرایش انجام دهد.
full: گرفتن اسکرین‌شات از تمام نمایشگرها به صورت همزمان.
screen: گرفتن اسکرین‌شات از نمایشگر مشخص‌شده.
launcher: هیچ آرگومانی نمی‌پذیرد؛ صرفاً پنجره راه‌انداز (launcher) را باز می‌کند.
config: اگر هیچ آرگومانی ارائه نشود، پنجره تنظیمات را باز می‌کند؛ در غیر این صورت تنظیمات را بر اساس آرگومان‌های ارائه‌شده تغییر می‌دهد.

آرگومان‌ها (ARGUMENTS)

در اینجا تمامی آرگومان‌های موجود برای همه زیردستورها فهرست شده‌اند. زیردستورهایی که هر آرگومان را می‌پذیرند در ذیل آن ذکر شده‌اند. همچنین می‌توانید از flameshot [subcommand] --help برای مشاهده فهرست آرگومان‌های معتبر برای هر زیردستور استفاده کنید.

-s, --accept-on-select

تایید و ذخیره تصویر به محض انتخاب ناحیه
معتبر برای زیردستورهای: gui

-a, --autostart <bool>

فعال‌سازی یا غیرفعال‌سازی اجرا در هنگام شروع به کار سیستم
معتبر برای زیردستورهای: config

--check

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

-c, --clipboard

ذخیره تصویر گرفته‌شده در کلیپ‌بورد
معتبر برای زیردستورهای: full, gui, screen

-k, --contrastcolor <color-code>

تعیین رنگ کنتراست رابط کاربری
معتبر برای زیردستورهای: config

-d, --delay <milliseconds>

مدت زمانی که Flameshot باید پیش از گرفتن اسکرین‌شات منتظر بماند (به میلی‌ثانیه)
معتبر برای زیردستورهای: full, gui, screen

-e, --edit

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

-f, --filename <pattern>

تنظیم الگوی نام فایل
معتبر برای زیردستورهای: config

-h, --help

نمایش یک پیام راهنمای مختصر و فهرست آرگومان‌های معتبر برای آن زیردستور
معتبر برای زیردستورهای: config, full, gui, launcher, screen

--last-region

تکرار اسکرین‌شات با ناحیه انتخابی پیشین
معتبر برای زیردستورهای: gui

-m, --maincolor <color-code>

تعیین رنگ اصلی رابط کاربری
معتبر برای زیردستورهای: config

-n, --notifications

فعال یا غیرفعال کردن اعلان‌ها
معتبر برای زیردستورهای: config

-n, --number <Screen number>

تعیین نمایشگر جهت گرفتن اسکرین‌شات (شروع از ۰)، پیش‌فرض: نمایشگری که مکان‌نما در آن قرار دارد
معتبر برای زیردستورهای: screen

-p, --path <path>

دایرکتوری موجود یا فایل جدید برای ذخیره تصویر در آن
معتبر برای زیردستورهای: full, gui, screen

--pin

سنجاق کردن تصویر گرفته‌شده روی صفحه نمایش
معتبر برای زیردستورهای: gui, screen

-g, --print-geometry

چاپ ابعاد هندسی ناحیه انتخابی در قالب WxH+X+Y. در صورت تعیین raw اثری ندارد
معتبر برای زیردستورهای: gui

-r, --raw

ارسال فایل خام PNG به خروجی استاندارد (stdout)
معتبر برای زیردستورهای: full, gui, screen

--region <WxH+X+Y or string>

ناحیه اسکرین‌شات برای انتخاب
معتبر برای زیردستورهای: gui, screen

-s, --showhelp <bool>

نمایش پیام راهنما در حالت گرفتن تصویر
معتبر برای زیردستورهای: config

-t, --trayicon <bool>

فعال یا غیرفعال کردن آیکون سینی سیستم
معتبر برای زیردستورهای: config

مثال‌ها (EXAMPLES)

این بخش برخی از متداول‌ترین شیوه‌های استفاده از flameshot از طریق خط فرمان را فهرست می‌کند.

flameshot: اجرای flameshot در پس‌زمینه. در صورت فعال بودن، آیکونی در بخش سینی سیستم محیط میزکار فعلی نمایان خواهد شد.
flameshot gui: گرفتن تصویر با رابط کاربری گرافیکی.
flameshot gui -p /path/to/captures: گرفتن تصویر با رابط کاربری گرافیکی و ذخیره در مسیر دلخواه.
flameshot gui -d 2000: باز کردن رابط گرافیکی با ۲ ثانیه تاخیر.
flameshot launcher: باز کردن کادر محاوره‌ای راه‌انداز برای گرفتن اسکرین‌شات پیشرفته مانند تاخیر زمانی سفارشی و غیره.
flameshot full --help: نمایش راهنما برای زیردستور flameshot full.
flameshot full -p /path/to/captures -d 5000: گرفتن تصویر تمام‌صفحه با مسیر ذخیره دلخواه (بدون رابط گرافیکی) و تاخیر زمانی.
flameshot full -c -p /path/to/captures: گرفتن تصویر تمام‌صفحه با مسیر ذخیره دلخواه و رونوشت در کلیپ‌بورد.
flameshot screen --number <screen number>: تعیین نمایشگر جهت گرفتن تصویر. به طور پیش‌فرض از صفحه‌ای که مکان‌نما در آن قرار دارد تصویر می‌گیرد.
flameshot screen --help: نمایش راهنما برای زیردستور flameshot screen.

مقدار بازگشتی (RETURN VALUE)

در صورت خروج عادی مقدار 0، در صورت لغو اسکرین‌شات مقدار 2، در صورت قطع اتصال dbus مقدار 3، در صورت دریافت SIGINT مقدار 130 و در صورت دریافت SIGTERM مقدار 143 را بازمی‌گرداند.

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

همچنین می‌توانید مستندات برخط و تفصیلی بیشتری را در صفحه اصلی پروژه بالادست بیابید.

صفحه اصلی پروژه بالادست:
• https://flameshot.org
• https://github.com/flameshot-org/flameshot

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

برنامه Flameshot در ابتدا توسط lupoDharkael نوشته شد و در حال حاضر توسط Jeremy Borgman, Boyuan Yang, Haris Gušić, Ahmed Zetao Yang, Mehrad Mahmoudian, و Martin Eckleben (بر اساس تعداد مشارکت‌ها در تاریخ نگارش این صفحه راهنما) نگهداری می‌شود.
پیوند زیر فهرست کامل‌تری از مشارکت‌کنندگان را ارائه می‌دهد:

https://github.com/flameshot-org/flameshot/graphs/contributors.

مجوز (LICENSE)

• کد اصلی تحت مجوز GPLv3+ منتشر شده است
• نشان‌واره (لوگو) Flameshot تحت مجوز Free Art License v1.3 منتشر شده است
• آیکون‌های دکمه‌ها تحت مجوز Apache License 2.0 قرار دارند. ببینید: https://github.com/google/material-design-icons
• کد در capture/capturewidget.cpp بر پایه https://github.com/ckaiser/Lightscreen/blob/master/dialogs/areadialog.cpp است (GPLv2)
• کد در capture/capturewidget.h بر پایه https://github.com/ckaiser/Lightscreen/blob/master/dialogs/areadialog.h است (GPLv2)
• چند خط کد از KSnapshot در regiongrabber.cpp ویرایش 796531 مخزن SVN برگرفته شده است (LGPL)
• ابزارک‌های Qt-Color-Widgets از https://github.com/mbasaglia/Qt-Color-Widgets گرفته و تغییر داده شده‌اند (مجوز و استثنائات آن‌ها را در پروژه ببینید) (LGPL/GPL)