FLAMESHOT(1) General Commands Manual FLAMESHOT(1) نام (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 فعال‌سازی یا غیرفعال‌سازی اجرا در هنگام شروع به کار سیستم معتبر برای زیردستورهای: config --check بررسی فایل پیکربندی برای یافتن خطاها. این گزینه زمانی سودمند است که فایل پیکربندی را به صورت دستی ویرایش کرده‌اید و می‌خواهید مطمئن شوید که فاقد خطا است. معتبر برای زیردستورهای: config -c, --clipboard ذخیره تصویر گرفته‌شده در کلیپ‌بورد معتبر برای زیردستورهای: full, gui, screen -k, --contrastcolor تعیین رنگ کنتراست رابط کاربری معتبر برای زیردستورهای: config -d, --delay مدت زمانی که Flameshot باید پیش از گرفتن اسکرین‌شات منتظر بماند (به میلی‌ثانیه) معتبر برای زیردستورهای: full, gui, screen -e, --edit انتخاب و ویرایش تعاملی ناحیه اسکرین‌شات معتبر برای زیردستورهای: screen -f, --filename تنظیم الگوی نام فایل معتبر برای زیردستورهای: config -h, --help نمایش یک پیام راهنمای مختصر و فهرست آرگومان‌های معتبر برای آن زیردستور معتبر برای زیردستورهای: config, full, gui, launcher, screen --last-region تکرار اسکرین‌شات با ناحیه انتخابی پیشین معتبر برای زیردستورهای: gui -m, --maincolor تعیین رنگ اصلی رابط کاربری معتبر برای زیردستورهای: config -n, --notifications فعال یا غیرفعال کردن اعلان‌ها معتبر برای زیردستورهای: config -n, --number تعیین نمایشگر جهت گرفتن اسکرین‌شات (شروع از ۰)، پیش‌فرض: نمایشگری که مکان‌نما در آن قرار دارد معتبر برای زیردستورهای: screen -p, --path دایرکتوری موجود یا فایل جدید برای ذخیره تصویر در آن معتبر برای زیردستورهای: full, gui, screen --pin سنجاق کردن تصویر گرفته‌شده روی صفحه نمایش معتبر برای زیردستورهای: gui, screen -g, --print-geometry چاپ ابعاد هندسی ناحیه انتخابی در قالب WxH+X+Y. در صورت تعیین raw اثری ندارد معتبر برای زیردستورهای: gui -r, --raw ارسال فایل خام PNG به خروجی استاندارد (stdout) معتبر برای زیردستورهای: full, gui, screen --region ناحیه اسکرین‌شات برای انتخاب معتبر برای زیردستورهای: gui, screen -s, --showhelp نمایش پیام راهنما در حالت گرفتن تصویر معتبر برای زیردستورهای: config -t, --trayicon فعال یا غیرفعال کردن آیکون سینی سیستم معتبر برای زیردستورهای: 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 تعیین نمایشگر جهت گرفتن تصویر. به طور پیش‌فرض از صفحه‌ای که مکان‌نما در آن قرار دارد تصویر می‌گیرد. 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) 2021-11-11 FLAMESHOT(1)