| bsetbg(1) | v2.0 | bsetbg(1) |
نام (NAME)
bsetbg - ابزار کمکی تنظیم تصویر پسزمینه برای Blackbox و Fluxbox
خلاصه دستور (SYNOPSIS)
bsetbg [گزینهها] تصویر
توضیحات (DESCRIPTION)
برنامهٔ bsetbg برای ارائهٔ یک روش استاندارد در مدیر پنجرهٔ Blackbox جهت تغییر پسزمینهٔ پنجرهٔ ریشه (root window) در نظر گرفته شده است (اگرچه با هر مدیر پنجرهٔ دیگری نیز کار میکند). bsetbg هم به عنوان یک پوشش (wrapper) برای bsetroot و هم برای برنامههای جانبی متنوعی که جهت مدیریت فایلهای تصویری استفاده میشوند، عمل میکند.
گزینهها (OPTIONS)
- -f, -full تصویر
- تصویر کشیده میشود تا تمام میزکار را پر کند.
- -t, -tile تصویر
- تصویر به صورت کاشیکاری (تکرارشونده) روی میزکار قرار میگیرد.
- -c, -center تصویر
- تصویر در مرکز میزکار قرار میگیرد.
- -e, -exec برنامه گزینهها آرگومان-جایگزین تصویر
- این گزینه به bsetbg میگوید که با اجرای برنامه به همراه گزینهها، یک دستور مجزا را اجرا کند که در آن گزینهها آرگومانهای ارسالی به برنامه هستند.
اگر یک آرگومان-جایگزین ارائه شده باشد (گزینههای -full، -tile یا -center مطابق آنچه در بالا ذکر شد)، bsetbg فرض میکند که آخرین آرگومان نام یک فایل است. در صورتی که برنامه با وضعیتی غیر از صفر خارج شود یا در سیستم مقصد در دسترس نباشد، bsetbg تلاش خواهد کرد فایل را با استفاده از آرگومان جایگزین مدیریت کند.
برای اطلاعات بیشتر در مورد گزینهٔ -exec، بخش مثالها (EXAMPLES) را ببینید.
- -p, -post فهرست
- فهرستی از آرگومانها را جهت ارسال به $POST_COMMAND مشخص میکند.
- -d, -debug
- حالت اشکالزدایی. برنامهٔ bsetbg دستورات را بدون اجرای آنها چاپ میکند.
- -g, -generate فهرست
- فهرستی از مقادیر پیکربندی پیشفرض را خروجی میدهد که برای هدایت به فایل ~/.bsetbgrc مناسب است. هر آرگومانی که داده شود به عنوان برنامههایی در نظر گرفته میشود که باید در مسیر سیستم (PATH) جستجو شوند و پیشفرضهای داخلی bsetbg را بازنویسی (override) میکنند.
- -app برنامه_تصویر
- با استفاده از این فلگ مشخص میکنید از کدام برنامهٔ تصویر استفاده شود. این برنامه میتواند یکی از موارد موجود در فهرست از پیش تعریفشده یا هر برنامهای باشد که توانایی نمایش تصویر روی پنجرهٔ ریشه را دارد. این فلگ میتواند همراه با ارسال پارامترهای اختصاصی برنامه به کار رود که در این صورت باید داخل علامت نقلقول دوتایی (double quotes) قرار گیرند.
- -v, -version
- نمایش شماره نسخه.
- -h, -help
- نمایش پیام راهنمای مختصر.
سایر گزینهها (OTHER OPTIONS)
برنامهٔ bsetbg همچنین تمامی آرگومانهای bsetroot را میپذیرد. برای اطلاعات بیشتر به صفحهٔ راهنمای bsetroot(1) مراجعه کنید.
پیکربندی (CONFIGURATION)
در صورت وجود فایل ~/.bsetbgrc، برنامهٔ bsetbg مقادیر پیکربندی خود را از آن میخواند. در غیر این صورت، مسیر سیستم (PATH) را برای فهرستی از برنامههای از پیش تعریفشدهٔ مدیریت تصویر (که در حال حاضر شامل qiv، xli، xv، wmsetbg، Esetroot، display و xsetbg است) جستجو میکند.
فایل ~/.bsetbgrc باید شامل متغیرهای زیر باشد:
- CENTER="string"
- برنامه و آرگومانهایی که در صورت مشخص شدن آرگومان -center، برای قرار دادن تصویر در مرکز پنجرهٔ ریشه استفاده میشوند.
- FULL="string"
- برنامه و آرگومانهایی که در صورت مشخص شدن آرگومان -full، برای کشیدن تصویر و پر کردن کل پنجرهٔ ریشه استفاده میشوند.
- TILE="string"
- برنامه و آرگومانهایی که در صورت مشخص شدن آرگومان -tile، برای کاشیکاری و تکرار تصویر روی پنجرهٔ ریشه استفاده میشوند.
- DEFAULT="string"
- عملیاتی که اگر هیچیک از موارد بالا مشخص نشده باشند، به صورت پیشفرض انجام میشود.
متغیرهای زیر اختیاری هستند:
- NO_EXEC="boolean"
- اگر این متغیر مقداردهی شود، bsetbg هرگز پنجرهٔ ریشه را تغییر نخواهد داد.
- POST_COMMAND="string"
- این متغیر دستوری را تعیین میکند که bsetbg پس از هر بار تغییر موفقیتآمیز پنجرهٔ ریشه اجرا خواهد کرد.
- LOG_LAST_CMD="boolean"
- اگر این متغیر مقداردهی شود، bsetbg گزارشی از دو دستور موفق اخیر را نگه میدارد.
- LOGFILE="string"
- این متغیر میتواند فایلی را مشخص کند که در صورت تعریف شدن $LOG_LAST_CMD به عنوان فایل گزارش (logfile) استفاده میشود. پیشفرض ~/.bsetbg_last_cmd است.
همانطور که در بالا ذکر شد، bsetbg برای بیشتر کاربران بدون نیاز به فایل پیکربندی به صورت کامل کار خواهد کرد. کاربران حرفهای که کنترل بیشتری روی رفتار bsetbg میخواهند، باید bsetbg -g را اجرا کنند و از خروجی آن برای ساخت فایل ~/.bsetbgrc استفاده نمایند که سپس میتوان آن را به صورت دستی ویرایش کرد.
مثالها (EXAMPLES)
در این مثال، bsetbg تصویر را در حالت مرکزچین قرار میدهد:
bsetbg -center foo.png
نمونهای از کاربرد آرگومان -exec:
bsetbg -exec xv -root -quit -rmode 5 -rbg rgb:2/2/2 \
-center foo.png
نمونهای که در آن bsetbg با استفاده از xv و qiv یک فایل پیکربندی ایجاد میکند:
bsetbg -g xv qiv > ~/.bsetbgrc
نمونهای از نحوهٔ استفاده از آرگومان -app:
bsetbg -app qiv "-o rgb:d6/c5/a2 -x" -c foo.png
نویسندگان (AUTHORS)
میتوان با نویسندهٔ bsetbg از طریق نشانی رایانامهٔ tmk@lordzork.com ارتباط برقرار کرد.
همچنین ببینید (SEE ALSO)
blackbox(1), bsetroot(1), qiv(1), xli(1), xv(1), display(1), wmsetbg(1)
| فوریه 2002 | bsetbg |