نام (NAME)

fbgrab - تصویربرداری از صفحه‌نمایش با استفاده از دستگاه فریم‌بافر

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

fbgrab [options] filename

توضیحات (DESCRIPTION)

fbgrab داده‌های دستگاه فریم‌بافر (/dev/fb*) یا یک دامپ (dump) از آن را می‌خواند و در قالب یک تصویر PNG ذخیره می‌کند. می‌توانید از آن برای تصویربرداری از تقریباً هر برنامه‌ای، از برنامه‌های آزمایشی سنتی گرفته تا میزکار سامانه پنجره X (X-windows) و برنامه‌های مبتنی بر فریم‌بافر استفاده کنید.

گزینه‌ها (OPTIONS)

-?: نمایش اطلاعات راهنما و نحوه استفاده.
-a: نادیده گرفتن کانال آلفا در درایورهایی که به اشتباه آن را تنظیم می‌کنند ولی پشتیبانی نمی‌کنند.
-b bitdepth: تعداد بیت‌های استفاده‌شده به ازای هر پیکسل؛ هنگام خواندن مستقیم از دستگاه اختیاری است.
-c console: مشخص می‌کند که از کدام کنسول (یا پایانه مجازی - آن‌طور که دیگران این ویژگی را می‌نامند) تصویربرداری شود. گاهی این تغییر سریع‌تر از بازنشانی فریم‌بافر صورت می‌گیرد (به‌ویژه هنگام تصویربرداری از برنامه‌های فریم‌بافر). در این صورت، باید از -C console استفاده کنید ... این گزینه مدتی پیش از تصویربرداری صبر می‌کند. در این حالت نمی‌توانید از -s استفاده کنید.
-d device: مشخص می‌کند که می‌خواهید کدام دستگاه فریم‌بافر را بخوانید. اگر از این گزینه استفاده نکنید، مقدار آن از متغیر محیطی FRAMEBUFFER خوانده می‌شود. اگر متغیر محیطی FRAMEBUFFER تعیین نشده باشد یا مقدار آن NULL باشد، مقدار DEFAULT_FB (به کد منبع مراجعه شود) در نظر گرفته می‌شود که معمولاً /dev/fb0 است.
-f filename: خواندن از یک فایل به جای دستگاه فریم‌بافر؛ مستلزم آن است که گزینه‌های -w (عرض)، -h (ارتفاع) و -b (عمق بیت) مشخص شده باشند.
-h height: ارتفاع فریم‌بافر بر حسب پیکسل؛ هنگام خواندن از دستگاه اختیاری است.
-i interlacing: غیرفعال کردن هم‌پوشانی خطوط (interlacing). اگر خواهان هم‌پوشانی ADAM7 نیستید، باید از گزینه -i استفاده کنید.
-l line length, a.k.a. stride.: طول بر حسب پیکسل بین شروع هر سطر در فریم‌بافر (که ممکن است بزرگ‌تر یا مساوی با عرض باشد)؛ هنگام خواندن از دستگاه اختیاری است.
-s seconds: تعداد ثانیه‌های انتظار پیش از تصویربرداری را تعیین می‌کند. fbshot تعویض کنسول را قفل نمی‌کند، بنابراین هنگام انتظار می‌توانید کنسول را تغییر دهید؛ اگر نتوانید از -c استفاده کنید، اجرای fbgrab معمولاً به دسترسی ریشه (root) نیاز دارد.
-v verbose: حالت پرجزئیات (نمایش اطلاعات بیشتر).
-w width: عرض فریم‌بافر بر حسب پیکسل؛ هنگام خواندن از دستگاه اختیاری است.
-z compression level: تنظیم سطح فشرده‌سازی PNG از 0 (سریع‌ترین) تا 9 (بهترین فشرده‌سازی).

کارهای آینده (TODO)

* عمق‌های بیتی سطح پایین، مانند ۱، ۲، ۴ و ۸ بیت.

* برنامه همراه fbput که تصویری را در فریم‌بافر نمایش دهد.
* بهره‌برداری بهتر از کتابخانه PNG-lib؛ در حال حاضر ابتدا تمام فرمت‌ها به عمق بیت ۳۲ تبدیل می‌شوند و سپس به صورت PNG ذخیره می‌گردند - که رویکرد درستی نیست.

مثال‌ها (EXAMPLES)

fbgrab fb.png

یک تصویر از فریم‌بافر ذخیره می‌کند؛ یا اگر fbgrab روی رایانه شما موجود نیست، می‌توانید ابتدا دستور زیر را اجرا کنید:

cp /dev/fb0 framebuffer.dump

و سپس با دستور زیر:

fbgrab -w 1024 -h 768 -l 2048 -b 16 -f framebuffer.dump fb.png

آن را به یک تصویر تبدیل نمایید.

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

نوشته‌شده توسط Gunnar Monell <gunnar.monell@gmail.com>. اساساً بازنویسی fbshot توسط Stephan Beyer <fbshot@s-beyer.de> است.

حق نشر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ مجوز و چه هر نسخه جدیدتر.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد مکاتبه کنید: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.