نام (NAME)

xbiff - نشانگر صندوق پستی برای X

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

xbiff [ -toolkitoption ... ] [ -option ... ]

توضیحات (DESCRIPTION)

برنامهٔ xbiff تصویر کوچکی از یک صندوق پستی را نمایش می‌دهد. هنگامی که نامه‌ای وجود ندارد، پرچم روی صندوق پستی پایین است. وقتی نامه‌ای می‌رسد، پرچم بالا می‌رود و صندوق پستی بوق می‌زند. به‌طور پیش‌فرض، فشردن هر کلید موشوار در تصویر، xbiff را وادار می‌کند تا اندازهٔ فعلی فایل نامه را به‌عنوان اندازهٔ «خالی» در نظر گرفته و پرچم را پایین بیاورد.

گزینه‌ها (OPTIONS)

xbiff تمام گزینه‌های خط فرمان استاندارد X Toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:

-help: این گزینه مشخص می‌کند که خلاصه‌ای کوتاه از گزینه‌های مجاز باید در خطای استاندارد چاپ شود.
-update seconds: این گزینه بسامد به‌روزرسانی نمایشگر را برحسب ثانیه برای xbiff مشخص می‌کند. اگر صندوق پستی پوشانده شده و سپس نمایان شود، بلافاصله به‌روز خواهد شد. پیش‌فرض 30 ثانیه است.
-file filename: این گزینه نام فایلی را که باید پایش شود مشخص می‌کند. به‌طور پیش‌فرض، صندوق ورودی شما را در مکان پیش‌فرض سیستمتان پایش می‌کند (چند نمونه عبارتند از /var/mail/username، /usr/spool/mail/username، /var/spool/mail/username که در آن username نام کاربری شما برای ورود است). اگر متغیر محیطی MAIL تنظیم شده باشد، فایل مشخص‌شده توسط آن پایش خواهد شد.
-volume percentage: این گزینه بلندی صدای زنگ را هنگام رسیدن نامهٔ جدید مشخص می‌کند. این درصد نسبت به حجم صدای فعلی تنظیم‌شده در xset(1) سنجیده می‌شود. بنابراین 0 صدای معمولی است، درصدهای منفی به سمت حداقل صدا (-100 بی‌صدا) و درصدهای مثبت به سمت حداکثر صدا (100 بلندترین) هستند.
-shape: این گزینه مشخص می‌کند که پنجرهٔ صندوق پستی در صورت مشخص بودن ماسک‌ها برای تصاویر خالی یا پر، باید شکل‌دهی (shaped) شود.
-version: این گزینه مشخص می‌کند که xbiff باید نسخهٔ خود را چاپ کرده و خارج شود.

آرگومان‌های خط فرمان استاندارد X Toolkit زیر معمولاً با xbiff به کار می‌روند:

-display display: این گزینه سرور X را برای برقراری ارتباط مشخص می‌کند.
-geometry geometry: این گزینه اندازه و موقعیت ترجیحی پنجرهٔ صندوق پستی را تعیین می‌کند. صندوق پستی ۴۸ پیکسل عرض و ۴۸ پیکسل ارتفاع دارد و در پنجره وسط‌چین خواهد شد.
-bg color: این گزینه رنگ مورد استفاده برای پس‌زمینهٔ پنجره را مشخص می‌کند.
-bd color: این گزینه رنگ مورد استفاده برای حاشیهٔ پنجره را مشخص می‌کند.
-bw number: این گزینه عرض حاشیهٔ دور پنجره را برحسب پیکسل مشخص می‌کند.
-fg color: این گزینه رنگ مورد استفاده برای پیش‌زمینهٔ پنجره را مشخص می‌کند.
-rv: این گزینه مشخص می‌کند که ویدیوی معکوس (reverse video) باید با جابه‌جایی رنگ‌های پیش‌زمینه و پس‌زمینه شبیه‌سازی شود.
-xrm resourcestring: این گزینه رشتهٔ منبع مورد استفاده را مشخص می‌کند. این گزینه به‌ویژه برای تنظیم منابعی که گزینهٔ خط فرمان جداگانه‌ای ندارند سودمند است.

پیش‌فرض‌های X (X DEFAULTS)

نام کلاس برنامه XBiff است. این برنامه از ویجت Mailbox استفاده می‌کند. این ویجت تمام نام‌ها و کلاس‌های منابع اصلی و همچنین موارد زیر را تشخیص می‌دهد:

checkCommand (class CheckCommand): دستور پوسته‌ای را برای اجرا جهت بررسی نامهٔ جدید به جای بررسی اندازهٔ file تعیین می‌کند. مقدار رشته‌ای تعیین‌شده به‌عنوان آرگومان فراخوانی system(3) استفاده می‌شود و بنابراین ممکن است شامل تغییر مسیر ورودی/خروجی (i/o redirection) باشد. وضعیت خروج 0 نشان‌دهندهٔ در انتظار بودن نامهٔ جدید است، 1 نشان‌دهندهٔ عدم تغییر اندازه است و 2 نشان‌دهندهٔ پاک شدن نامه‌هاست. به‌طور پیش‌فرض، هیچ دستور پوسته‌ای ارائه نشده است.
file (class File): نام فایل برای پایش را مشخص می‌کند. پیش‌فرض همان‌طور است که در بالا برای گزینهٔ خط فرمان -file شرح داده شد.
onceOnly (class Boolean): مشخص می‌کند که زنگ فقط بار اولی که نامهٔ جدید یافت شد به صدا درآید و تا زمانی که حداقل یک بازه بدون نامهٔ در انتظار سپری نشود، دوباره به صدا درنیاید. پنجره همچنان وجود نامهٔ جدید را تا زمانی که دریافت شود نشان خواهد داد. پیش‌فرض false است.
width (class Width): عرض صندوق پستی را تعیین می‌کند.
height (class Height): ارتفاع صندوق پستی را تعیین می‌کند.
update (class Interval): بسامد بررسی نامه‌ها را برحسب ثانیه تعیین می‌کند. پیش‌فرض 30 است.
volume (class Volume): بلندی صدای زنگ را تعیین می‌کند. پیش‌فرض 33 درصد است. توجه داشته باشید که این درصدی از حجم صدای فعلی در xset(1) است. برای کاهش صدا، درصدی منفی تعیین کنید.
foreground (class Foreground): رنگ پیش‌زمینه را تعیین می‌کند.
reverseVideo (class ReverseVideo): مشخص می‌کند که رنگ پیش‌زمینه و پس‌زمینه معکوس شوند.
flip (class Flip): مشخص می‌کند که آیا تصویری که هنگام رسیدن نامه نمایش داده می‌شود باید معکوس شود یا خیر. پیش‌فرض «true» است.
fullPixmap (class Pixmap): یک بیت‌مپ را برای نمایش هنگام رسیدن نامهٔ جدید تعیین می‌کند. پیش‌فرض flagup است.
emptyPixmap (class Pixmap): یک بیت‌مپ را برای نمایش در هنگام نبود نامهٔ جدید تعیین می‌کند. پیش‌فرض flagdown است.
shapeWindow (class ShapeWindow): مشخص می‌کند که آیا پنجرهٔ صندوق پستی باید مطابق با fullPixmapMask و emptyPixmapMask ارائه‌شده شکل‌دهی شود یا خیر. پیش‌فرض false است.
fullPixmapMask (class PixmapMask): ماسک را برای بیت‌مپی که هنگام رسیدن نامهٔ جدید نمایش داده می‌شود تعیین می‌کند. پیش‌فرض none است.
emptyPixmapMask (class PixmapMask): ماسک را برای بیت‌مپی که در زمان نبود نامهٔ جدید نمایش داده می‌شود تعیین می‌کند. پیش‌فرض none است.

کنش‌ها (ACTIONS)

ویجت Mailbox کنش‌های زیر را برای استفاده در ترجمه‌های رویداد (event translations) فراهم می‌کند:

check(): این کنش باعث می‌شود ویجت نامهٔ جدید را بررسی کرده و پرچم را به‌درستی نمایش دهد.
unset(): این کنش باعث می‌شود ویجت پرچم را تا زمان رسیدن نامهٔ جدید پایین بیاورد.
set(): این کنش باعث می‌شود ویجت پرچم را تا زمانی که کاربر آن را بازنشانی کند بالا ببرد.

ترجمهٔ رویداد پیش‌فرض عبارت است از:

<ButtonPress>:  unset()

محیط (ENVIRONMENT)

DISPLAY: برای دریافت میزبان پیش‌فرض و شمارهٔ نمایشگر.
XENVIRONMENT: برای دریافت نام یک فایل منبع که منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER را بازنویسی می‌کند.

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

X(7), xrdb(1), stat(2)

گزارش باگ‌ها (BUGS)

بیت‌مپ‌های صندوق پستی زشت هستند.

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

Jim Fulton, MIT X Consortium
تغییرات تکمیلی توسط Ralph Swick، DEC/MIT Project Athena