.TH FBI 1 "(c) 1998-2012 Gerd Hoffmann" "FBI 2.09" "Linux framebuffer imageviewer"
\#
\#
.SH "نام (NAME)"
fbi \- نمایش‌دهنده تصاویر در فریم‌بافر لینوکس
\#
\#
.SH "خلاصه دستور (SYNOPSIS)"
\fBfbi\fP [\fIگزینه‌ها\fP] \fIفایل ...\fP
\#
\#
.SH "توضیحات (DESCRIPTION)"
دستور
.BR fbi
فایل(های) مشخص‌شده را روی کنسول لینوکس با استفاده از دستگاه فریم‌بافر نمایش می‌دهد. قالب‌های
\fIPhotoCD\fP، \fIjpeg\fP، \fIppm\fP، \fIgif\fP، \fItiff\fP، \fIxpm\fP، \fIxwd\fP، \fIbmp\fP، \fIpng\fP
و
\fIwebp\fP
به‌طور محلی پشتیبانی می‌شوند. برای سایر قالب‌ها،
.BR fbi
تلاش می‌کند از دستور
.BR convert (1)
متعلق به
.BR ImageMagick (1)
استفاده کند.
\#
\#
.SH "گزینه‌ها (OPTIONS)"
.TP
.B -h, --help
چاپ اطلاعات نحوه استفاده.
.TP
.B -V, --version
چاپ شماره نسخه
.BR fbi .
.TP
.B --store
نوشتن آرگومان‌های خط فرمان در فایل پیکربندی
\fI~/.fbirc\fP.
.TP
.BI "-l" "\ file" ", --list" "\ file"
خواندن فهرست فایل‌های تصویر از
\fIfile\fP.
.TP
.B -P, --text
فعال‌سازی حالت خواندن متن. در این حالت
.BR fbi
تصاویر بزرگ را بدون جابه‌جایی عمودی نمایش می‌دهد (حالت پیش‌فرض قرار دادن تصاویر در مرکز صفحه است). دستور
\fBSPACE\fP
ابتدا تلاش می‌کند به سمت پایین پیمایش کند و تنها در صورتی به تصویر بعدی می‌رود که در حال حاضر در انتهای صفحه باشد. این گزینه زمانی که تصاویر مشاهده‌شده صفحات متنی هستند بسیار مفید است؛ تنها کاری که برای دیدن بخش بعدی متن باید انجام دهید فشار دادن کلید space است...
.TP
.B -a, --autozoom
فعال‌سازی بزرگ‌نمایی خودکار.
.BR fbi
هنگام بارگذاری تصویر جدید، به‌طور خودکار ضریب بزرگ‌نمایی مناسبی را انتخاب می‌کند.
.TP
.B --(no)autoup
مانند autozoom، اما فقط مقیاس‌بندی به سمت بزرگ‌تر انجام می‌شود.
.TP
.B --(no)autodown
مانند autozoom، اما فقط مقیاس‌بندی به سمت کوچک‌تر انجام می‌شود.
.TP
.B --(no)fitwidth
استفاده تنها از عرض تصویر برای مقیاس‌بندی خودکار.
.TP
.B -v, --(no)verbose
پرگویی: فعال‌سازی خط وضعیت در پایین صفحه (به‌طور پیش‌فرض فعال است).
.TP
.B -u, --(no)random
تصادفی‌سازی ترتیب نام فایل‌ها.
.TP
.B --(no)comments
نمایش برچسب‌های توضیحات (در صورت وجود) به‌جای نام فایل. احتمالاً فقط در صورتی کاربرد دارد که خودتان توضیحات مناسبی اضافه کرده باشید (مثلاً با استفاده از
.BR wrjpgcom (1))،
در غیر این صورت احتمالاً فقط متونی را می‌بینید که به نرم‌افزار سازنده تصویر اشاره دارند.
.TP
.B -e, --(no)edit
فعال‌سازی دستورات ویرایش.
.TP
.B --(no)backup
ایجاد فایل‌های پشتیبان (هنگام ویرایش تصاویر).
.TP
.B -p, --(no)preserve
حفظ برچسب‌های زمانی (هنگام ویرایش تصاویر).
.TP
.B --(no)readahead
پیش‌خوانی تصاویر در حافظه نهان.
.TP
.BI "--cachemem" "\ size"
اندازه حافظه نهان تصویر به مگابایت (پیش‌فرض ۲۵۶ است).
.TP
.BI "--blend" "\ time"
زمان محو/ترکیب تصویر بر حسب میلی‌ثانیه.
.TP
.BI "-T" "\ n" ", --vt" "\ n"
شروع در کنسول مجازی شماره
\fIn\fP.
.TP
.BI "-s" "\ steps" ", --scroll" "\ steps"
تنظیم گام‌های پیمایش بر حسب پیکسل (پیش‌فرض ۵۰ است).
.TP
.BI "-t" "\ sec" ", --timeout" "\ sec"
شروع یک اسلایدشوی پیوسته که در آن هر تصویر بدون نیاز به فشردن کلیدی در فواصل زمانی
\fIsec\fP
ثانیه بارگذاری می‌شود.
.TP
.B -1, --(no)once
عدم تکرار حلقه اسلایدشو (فقط همراه با
.B \-t
استفاده شود).
.TP
.BI "-r" "\ n" ", --resolution" "\ n"
انتخاب وضوح تصویر،
\fIn = 1..5\fP
(پیش‌فرض ۳ است، فقط برای
\fIPhotoCD\fP).
.TP
.BI "-g" "\ n" ", --gamma" "\ n"
تصحیح گاما. نیازمند نمایش بصری
\fIPseudocolor\fP
یا
\fIDirectcolor\fP
است و روی
\fITruecolor\fP
کار نمی‌کند (پیش‌فرض ۱ است).
.TP
.BI "-f" "\ <arg>" ", --font" "\ <arg>"
تنظیم قلم. این
\fI<arg>\fP
می‌تواند هر مقداری باشد که fontconfig می‌پذیرد (نگاه کنید به
.BR fonts\-conf (5)).
برای مشاهده فهرستی از قلم‌های شناخته‌شده روی سیستم خود، دستور
.BR fc\-list (1)
را امتحان کنید. فایل پیکربندی fontconfig نیز ارزیابی می‌شود، بنابراین هر نام عمومی تعریف‌شده در آن (مانند mono یا sans) نیز کار خواهد کرد. توصیه می‌شود از قلم‌های تک‌فاصله (monospaced) استفاده کنید تا کادرهای متنی (متن راهنما، اطلاعات exif) ظاهر بهتری داشته باشند.
.TP
.BI "-d" "\ /dev/fbN" ", --device" "\ /dev/fbN"
استفاده از دستگاه فریم‌بافر
\fI/dev/fbN\fP.
پیش‌فرض همان دستگاهی است که کنسول مجازی شما به آن نگاشت شده است.
.TP
.BI "-m" "\ videomode" ", --mode" "\ videomode"
نام حالت ویدیویی مورد استفاده (حالت ویدیویی باید در
\fI/etc/fb.modes\fP
فهرست شده باشد). پیش‌فرض این است که حالت ویدیویی تغییر داده نشود.
.TP
.B --(no)interactive
اجازه کنترل تعاملی برنامه از طریق صفحه‌کلید. این گزینه نیازمند آن است که
\fIstdin\fP
یک TTY باشد. پیش‌فرض اجازه کنترل تعاملی است.
\#
\#
.SH "محیط (ENVIRONMENT)"
دستور
.BR fbi
از متغیرهای محیطی زیر استفاده می‌کند:
.TP
.BR FBGAMMA
این متغیر می‌تواند برای مشخص کردن تصحیح گامای پیش‌فرض استفاده شود.
\#
\#
.SH "دستورات کاربردی (COMMAND USAGE)"
دستورات بلافاصله اعمال می‌شوند؛ نیازی به فشردن کلید اینتر نیست.
.PP
در دستورات زیر،
\fIi\fP
یک آرگومان عددی است.
.SS "پیمایش (Scrolling)"
.TP
\fBLEFT_ARROW\fP, \fBRIGHT_ARROW\fP, \fBUP_ARROW\fP, \fBDOWN_ARROW\fP
پیمایش تصاویر بزرگ.
.TP
\fBPREV_SCREEN\fP, \fBk\fP
تصویر قبلی.
.TP
\fBNEXT_SCREEN\fP, \fBSPACE\fP, \fBj\fP
تصویر بعدی.
.TP
\fIi\fP\fBg\fP
پرش به تصویر شماره
\fIi\fP.
.TP
\fBRETURN\fP
نوشتن نام فایل تصویر جاری در
.BR stdout (3)،
سپس رفتن به تصویر بعدی.
.P
تفاوت کلیدهای
\fBRETURN\fP
در برابر
\fBSPACE\fP
می‌تواند برای ایجاد یک فهرست از فایل‌ها هنگام مرور تصاویر و استفاده از آن فهرست برای پردازش‌های دسته‌ای بعدی به کار رود:
.P
.in +4n
\fIfbi\ file1.gif\ file2.jpg\ file3.jpg >\ fileimagelist.lst\fP
.in
.P
.in +4n
چند بار فشردن \fBRETURN\fP و \fBSPACE\fP...
.in
.P
.in +4n
\fIfbi\ -l\ fileimagelist.lst\fP
.in
.SS "بزرگ‌نمایی (Zoom)"
.TP
\fBa\fP
بزرگ‌نمایی خودکار.
.TP
\fB+\fP
بزرگ‌نمایی (بزرگ‌تر).
.TP
\fB-\fP
کوچک‌نمایی.
.TP
\fIi\fP\fBs\fP
تنظیم بزرگ‌نمایی روی
\fIi\fP%.
.SS "سایر موارد (Other)"
.TP
\fBESQ\fP, \fBq\fP
خروج.
.TP
\fBv\fP
تغییر وضعیت نمایش خط وضعیت.
.TP
\fBh\fP
نمایش کادر متنی با راهنمای مختصر.
.TP
\fBi\fP
نمایش کادر متنی با برخی اطلاعات
\fIEXIF\fP.
.TP
\fBp\fP
مکث در اسلایدشو (در صورت شروع با
\fB-t\fP،
تغییر وضعیت مکث/پخش).
.SS "حالت ویرایش (Edit mode)"
دستور
.BR fbi
همچنین برخی امکانات بسیار پایه‌ای ویرایش تصویر را فراهم می‌کند. برای استفاده از آن‌ها باید
.BR fbi
را با گزینه
\fI-e\fP
اجرا کنید.
.TP
\fBD\fP, \fBShift+d\fP
حذف تصویر.
.TP
\fBr\fP
چرخش ۹۰ درجه در جهت عقربه‌های ساعت.
.TP
\fBl\fP
چرخش ۹۰ درجه در خلاف جهت عقربه‌های ساعت.
.TP
\fBx\fP
قرینه‌سازی عمودی تصویر (بالا / پایین).
.TP
\fBy\fP
قرینه‌سازی افقی تصویر (چپ به راست).
.P
تابع حذف در واقع به حرف بزرگ
\fBD\fP
نیاز دارد، بنابراین باید
\fBShift+d\fP
را فشار دهید. این کار برای جلوگیری از حذف تصادفی تصاویر انجام شده است زیرا هیچ هشدار ایمنی وجود ندارد: اگر از
.BR fbi
بخواهید تصویری را حذف کند، بدون هیچ پرسشی حذف خواهد شد.
.P
تابع چرخش در واقع فقط برای تصاویر
\fIJPEG\fP
کار می‌کند. این تابع تبدیل بدون افت کیفیتی روی تصویر انجام می‌دهد.
\#
\#
.SH "اشکالات (BUGS)"
دستور
.BR fbi
به دسترسی خواندن و نوشتن (rw) روی دستگاه‌های فریم‌بافر
(\fI/dev/fbN\fP)
نیاز دارد، یعنی شما (یا مدیر سیستم) باید مطمئن شوید
.BR fbi
می‌تواند دستگاه‌ها را در حالت rw باز کند. مناسب‌ترین روش استفاده از
.BR PAM (7)
برای تغییر مالکیت دستگاه‌ها به کاربری است که روی کنسول وارد شده است. روش دیگر ایجاد یک گروه، تغییر مالکیت فایل‌های ویژه به آن گروه و افزودن کاربرانی است که مجاز به استفاده از دستگاه فریم‌بافر هستند به آن گروه. همچنین می‌توانید فایل‌های ویژه را برای همگان قابل نوشتن کنید، اما به پیامدهای امنیتی این کار توجه داشته باشید. هرچند روی یک رایانه شخصی ممکن است مدیریت به این شیوه مشکلی نداشته باشد.
.P
دستور
.BR fbi
همچنین برای مدیریت درست تعویض کنسول به دسترسی به کنسول لینوکس
(\fI/dev/ttyN\fP)
نیاز دارد. این موضوع برای ورود مستقیم به کنسول مشکلی ایجاد نمی‌کند، اما هیچ نوعی از شبه‌TTY (مانند xterm، ssh، screen و...) کار
\fBنخواهد کرد\fP.
\#
\#
.SH "همچنین ببینید (SEE ALSO)"
.BR convert (1),
.BR fbset (1),
.BR fc-list (1),
.BR imagemagick (1),
.BR wrjpgcom (1),
.BR fonts-conf (5),
.BR PAM (7)
\#
\#
.SH "نویسنده (AUTHOR)"
Gerd Hoffmann
.BR <gerd@kraxel.org>
\#
\#
.SH "حق نشر (COPYRIGHT)"
Copyright (c) 1999-2012 Gerd Hoffmann <gerd@kraxel.org>
.P
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» که توسط «بنیاد نرم‌افزارهای آزاد» منتشر شده است، چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخه پس از آن، بازتوزیع کرده یا تغییر دهید.
.P
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.
.P
شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA بنویسید.