.\" Emacs, -*- nroff -*- please
.TH XOSD 1 "January 2001" "X OSD cat"
.SH "نام (NAME)"
osd_cat \- نمایش‌دهنده فایل روی صفحه در X
.SH "خلاصه دستور (SYNOPSIS)"
.B osd_cat
[\fIOPTION\fP] [\fIFILE\fP]...
.br
.B osd_cat
.BR \-b\ percentage | slider
[\fIOPTION\fP]
.SH "توضیحات (DESCRIPTION)"
.PP
.\" Add any additional description here
.PP
نمایش \fIFILE\fP یا ورودی استاندارد بر روی صفحه نمایش X.
.TP
\fB\-p\fP, \fB\-\-pos\fP=\fIPOS\fP
این گزینه به \fBosd_cat\fP می‌گوید متن را در کجا نمایش دهد. \fIPOS\fP می‌تواند \fBtop\fP، \fBmiddle\fP یا \fBbottom\fP باشد. مقدار پیش‌فرض \fBtop\fP است.
.TP
\fB\-o\fP, \fB\-\-offset\fP=\fIOFFSET\fP
این گزینه میزان آفست (\fIOFFSET\fP) از بالا یا پایین صفحه نمایش را برای متن مشخص می‌کند. مقدار پیش‌فرض \fB0\fP است.
.TP
\fB\-A\fP, \fB\-\-align\fP=\fIALIGN\fP
این گزینه به \fBosd_cat\fP می‌گوید که متن را در کجا تراز کند. \fIALIGN\fP می‌تواند \fBleft\fP، \fBright\fP یا \fBcenter\fP باشد. مقدار پیش‌فرض \fBleft\fP است.
.TP
\fB\-i\fP, \fB\-\-indent\fP=\fIOFFSET\fP
این گزینه میزان تورفتگی (\fIINDENT\fP) از سمت چپ صفحه را برای نمایش متن مشخص می‌کند. مقدار پیش‌فرض \fB0\fP است.
.TP
\fB\-f\fP, \fB\-\-font\fP=\fIFONT\fP
این گزینه فونت (\fIFONT\fP) مورد استفاده برای نمایش متن را مشخص می‌کند. مقدار پیش‌فرض \fBfixed\fP است.
.TP
\fB\-c\fP, \fB\-\-color\fP=\fICOLOR\fP
این گزینه رنگ (\fICOLOR\fP) مورد استفاده برای نمایش متن را تعیین می‌کند. مقدار پیش‌فرض \fBred\fP است.
.TP
\fB\-d\fP, \fB\-\-delay\fP=\fITIME\fP
این گزینه مدت زمانی را که متن نمایش داده می‌شود بر حسب ثانیه مشخص می‌کند. مقدار پیش‌فرض \fB5\fP ثانیه است.
.TP
\fB\-l\fP, \fB\-\-lines\fP=\fILINES\fP
این گزینه تعداد خطوط (\fILINES\fP) را برای پیمایش صفحه مشخص می‌کند. مقدار پیش‌فرض \fB5\fP است.
.TP
\fB\-s\fP, \fB\-\-shadow\fP=\fIOFFSET\fP
این گزینه میزان آفست سایه متن (\fIOFFSET\fP) را مشخص می‌کند. مقدار پیش‌فرض \fB0\fP است، به این معنی که هیچ سایه‌ای ایجاد نمی‌شود.
.TP
\fB\-S\fP, \fB\-\-shadowcolour\fP=\fICOLOUR\fP
این گزینه رنگ سایه متن (\fICOLOUR\fP) را مشخص می‌کند. مقدار پیش‌فرض \fBblack\fP است.
.TP
\fB\-O\fP, \fB\-\-outline\fP=\fIWIDTH\fP
این گزینه ضخامت حاشیه بیرونی متن (\fIWIDTH\fP) را مشخص می‌کند. مقدار پیش‌فرض \fB0\fP است که به معنای نبود حاشیه است.
.TP
\fB\-u\fP, \fB\-\-outlinecolour\fP=\fICOLOUR\fP
این گزینه رنگ حاشیه بیرونی متن (\fICOLOUR\fP) را مشخص می‌کند. مقدار پیش‌فرض \fBblack\fP است.
.TP
\fB\-a\fP, \fB\-\-age\fP[=\fISCROLL_AGE\fP]
این گزینه بر بازترسیم صفحه تأثیر می‌گذارد. اگر پیش از آماده شدن یک خط جدید (برای مثال، هنگامی که از یک pipe داده می‌خوانید)، \fISCROLL_AGE\fP ثانیه سپری شود، به جای این‌که با جایگزین شدن خطوط قدیمی توسط خطوط جدید متن پیمایش شود، همه خطوط به‌یک‌باره پاک می‌شوند. مقدار پیش‌فرض \fB0\fP است.
.br
هنگامی که هیچ \fISCROLL_AGE\fP به طور صریح مشخص نشده باشد، از مقدار فعلی \fIDELAY\fP استفاده می‌شود.
.TP
\fB\-w\fP, \fB\-\-wait\fP
این گزینه نیز بر بازترسیم صفحه تأثیر می‌گذارد. هنگامی که داده‌ای آماده نمایش روی صفحه باشد، این گزینه باعث می‌شود \fBosd_cat\fP تا زمان پاک شدن صفحه نمایش صبر کند. این راهکاری جایگزین برای پیمایش است.
.TP
\fB\-b\fP, \fB\-\-barmode\fP=\fITYPE\fP
به شما امکان می‌دهد به جای فقط متن، یک نوار درصدی یا نوار لغزنده نمایش دهید.
\fITYPE\fP می‌تواند \fBpercentage\fP یا \fBslider\fP باشد.
در این حالت هیچ متنی از هیچ فایلی خوانده نمی‌شود، اما گزینه‌های زیر قابل استفاده هستند:
.TP
\fB\-P\fP, \fB\-\-percentage\fP=\fIPERCENTAGE\fP
این گزینه موقعیت نوار درصدی / لغزنده را مشخص می‌کند.
\fIPERCENTAGE\fP می‌تواند در بازه \fB0\fP تا \fB100\fP باشد، مقدار پیش‌فرض \fB50\fP است.
.TP
\fB\-T\fP, \fB\-\-text\fP=\fITEXT\fP
این گزینه یک متن اختیاری (\fITEXT\fP) را مشخص می‌کند که بالای نوار درصدی نمایش داده می‌شود.
مقدار پیش‌فرض خالی است، بنابراین هیچ متن اضافی نمایش داده نمی‌شود.
.TP
\fB\-h\fP, \fB\-\-help\fP
نمایش راهنما (که اغلب به‌روزتر است) و خروج
.PP
بدون تعیین \fIFILE\fP، یا هنگامی که \fIFILE\fP برابر با \fB\-\fP باشد، ورودی استاندارد خوانده می‌شود.
.SH "نویسندگان (AUTHORS)"
Martijn van de Streek <martijn@foodfight.org>، برخی وصله‌ها توسط
Malcolm Valentine <farkit@iprimus.com.au> و Tim Wright
<tim@ignavus.net> اعمال شده است.
.br
xosd توسط Andre Renaud <andre@ignavus.net> نوشته شده است و توسط
Tim Wright <tim@ignavus.net> نگهداری می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
اطلاعات بیشتر درباره کتابخانه X OSD و نویسنده آن را می‌توان در نشانی زیر یافت:
.UR http://www.ignavus.net/software.html
http://www.ignavus.net/software.html
.UE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
این برنامه تحت مجوز عمومی همگانی گنو (GNU General Public License) توزیع می‌شود.