.TH bsetbg 1 "فوریه 2002" "bsetbg" "v2.0"
.SH "نام (NAME)"
bsetbg \- ابزار کمکی تنظیم تصویر پس‌زمینه برای Blackbox و Fluxbox
.SH "خلاصه دستور (SYNOPSIS)"
\fBbsetbg\fR [\fIگزینه‌ها\fR] \fIتصویر\fR
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBbsetbg\fR برای ارائهٔ یک روش استاندارد در مدیر پنجرهٔ \fIBlackbox\fR جهت تغییر پس‌زمینهٔ پنجرهٔ ریشه (root window) در نظر گرفته شده است (اگرچه با هر مدیر پنجرهٔ دیگری نیز کار می‌کند). \fBbsetbg\fR هم به عنوان یک پوشش (wrapper) برای \fIbsetroot\fR و هم برای برنامه‌های جانبی متنوعی که جهت مدیریت فایل‌های تصویری استفاده می‌شوند، عمل می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-full\fR \fIتصویر\fR
\fIتصویر\fR کشیده می‌شود تا تمام میزکار را پر کند.
.TP
\fB\-t\fR, \fB\-tile\fR \fIتصویر\fR
\fIتصویر\fR به صورت کاشی‌کاری (تکرارشونده) روی میزکار قرار می‌گیرد.
.TP
\fB\-c\fR, \fB\-center\fR \fIتصویر\fR
\fIتصویر\fR در مرکز میزکار قرار می‌گیرد.
.TP
\fB\-e\fR, \fB\-exec\fR \fIبرنامه\fR \fIگزینه‌ها\fR \fIآرگومان\-جایگزین\fR \fIتصویر\fR
این گزینه به \fBbsetbg\fR می‌گوید که با اجرای \fIبرنامه\fR به همراه \fIگزینه‌ها\fR، یک دستور مجزا را اجرا کند که در آن \fIگزینه‌ها\fR آرگومان‌های ارسالی به \fIبرنامه\fR هستند.
.PP
اگر یک \fIآرگومان\-جایگزین\fR ارائه شده باشد (گزینه‌های \fB\-full\fR، \fB\-tile\fR یا \fB\-center\fR مطابق آنچه در بالا ذکر شد)، \fBbsetbg\fR فرض می‌کند که آخرین آرگومان نام یک فایل است. در صورتی که \fIبرنامه\fR با وضعیتی غیر از صفر خارج شود یا در سیستم مقصد در دسترس نباشد، \fBbsetbg\fR تلاش خواهد کرد فایل را با استفاده از آرگومان جایگزین مدیریت کند.
.PP
برای اطلاعات بیشتر در مورد گزینهٔ \fB\-exec\fR، بخش \fBمثال‌ها (EXAMPLES)\fR را ببینید.
.TP
\fB\-p\fR, \fB\-post\fR \fIفهرست\fR
فهرستی از آرگومان‌ها را جهت ارسال به $POST_COMMAND مشخص می‌کند.
.TP
\fB\-d\fR, \fB\-debug\fR
حالت اشکال‌زدایی. برنامهٔ \fBbsetbg\fR دستورات را بدون اجرای آن‌ها چاپ می‌کند.
.TP
\fB\-g\fR, \fB\-generate\fR \fIفهرست\fR
فهرستی از مقادیر پیکربندی پیش‌فرض را خروجی می‌دهد که برای هدایت به فایل \fI~/.bsetbgrc\fR مناسب است. هر آرگومانی که داده شود به عنوان برنامه‌هایی در نظر گرفته می‌شود که باید در مسیر سیستم (PATH) جستجو شوند و پیش‌فرض‌های داخلی \fBbsetbg\fR را بازنویسی (override) می‌کنند.
.TP
\fB\-app\fR \fIبرنامه_تصویر\fR
با استفاده از این فلگ مشخص می‌کنید از کدام برنامهٔ تصویر استفاده شود. این برنامه می‌تواند یکی از موارد موجود در فهرست از پیش تعریف‌شده یا هر برنامه‌ای باشد که توانایی نمایش تصویر روی پنجرهٔ ریشه را دارد. این فلگ می‌تواند همراه با ارسال پارامترهای اختصاصی برنامه به کار رود که در این صورت باید داخل علامت نقل‌قول دوتایی (double quotes) قرار گیرند.
.TP
\fB\-v\fR, \fB\-version\fR
نمایش شماره نسخه.
.TP
\fB\-h\fR, \fB\-help\fR
نمایش پیام راهنمای مختصر.

.SH "سایر گزینه‌ها (OTHER OPTIONS)"
برنامهٔ \fBbsetbg\fR همچنین تمامی آرگومان‌های \fIbsetroot\fR را می‌پذیرد. برای اطلاعات بیشتر به صفحهٔ راهنمای \fIbsetroot\fR(1) مراجعه کنید.

.SH "پیکربندی (CONFIGURATION)"
در صورت وجود فایل \fI~/.bsetbgrc\fR، برنامهٔ \fBbsetbg\fR مقادیر پیکربندی خود را از آن می‌خواند. در غیر این صورت، مسیر سیستم (PATH) را برای فهرستی از برنامه‌های از پیش تعریف‌شدهٔ مدیریت تصویر (که در حال حاضر شامل qiv، xli، xv، wmsetbg، Esetroot، display و xsetbg است) جستجو می‌کند.
.PP
فایل \fI~/.bsetbgrc\fR باید شامل متغیرهای زیر باشد:
.TP
\fB    CENTER=\fR\fI"string"\fR
برنامه و آرگومان‌هایی که در صورت مشخص شدن آرگومان \fB\-center\fR، برای قرار دادن تصویر در مرکز پنجرهٔ ریشه استفاده می‌شوند.

.TP
\fB    FULL=\fR\fI"string"\fR
برنامه و آرگومان‌هایی که در صورت مشخص شدن آرگومان \fB\-full\fR، برای کشیدن تصویر و پر کردن کل پنجرهٔ ریشه استفاده می‌شوند.

.TP
\fB    TILE=\fR\fI"string"\fR
برنامه و آرگومان‌هایی که در صورت مشخص شدن آرگومان \fB\-tile\fR، برای کاشی‌کاری و تکرار تصویر روی پنجرهٔ ریشه استفاده می‌شوند.

.TP
\fB    DEFAULT=\fR\fI"string"\fR
عملیاتی که اگر هیچ‌یک از موارد بالا مشخص نشده باشند، به صورت پیش‌فرض انجام می‌شود.

.PP
متغیرهای زیر اختیاری هستند:

.TP
\fB    NO_EXEC=\fR\fI"boolean"\fR
اگر این متغیر مقداردهی شود، bsetbg هرگز پنجرهٔ ریشه را تغییر نخواهد داد.

.TP
\fB    POST_COMMAND=\fR\fI"string"\fR
این متغیر دستوری را تعیین می‌کند که \fBbsetbg\fR پس از هر بار تغییر موفقیت‌آمیز پنجرهٔ ریشه اجرا خواهد کرد.

.TP
\fB    LOG_LAST_CMD=\fR\fI"boolean"\fR
اگر این متغیر مقداردهی شود، \fBbsetbg\fR گزارشی از دو دستور موفق اخیر را نگه می‌دارد.

.TP
\fB    LOGFILE=\fR\fI"string"\fR
این متغیر می‌تواند فایلی را مشخص کند که در صورت تعریف شدن $LOG_LAST_CMD به عنوان فایل گزارش (logfile) استفاده می‌شود. پیش‌فرض ~/.bsetbg_last_cmd است.

.PP
همان‌طور که در بالا ذکر شد، \fBbsetbg\fR برای بیشتر کاربران بدون نیاز به فایل پیکربندی به صورت کامل کار خواهد کرد. کاربران حرفه‌ای که کنترل بیشتری روی رفتار \fBbsetbg\fR می‌خواهند، باید \fBbsetbg \-g\fR را اجرا کنند و از خروجی آن برای ساخت فایل \fI~/.bsetbgrc\fR استفاده نمایند که سپس می‌توان آن را به صورت دستی ویرایش کرد.

.SH "مثال‌ها (EXAMPLES)"
در این مثال، bsetbg تصویر را در حالت مرکزچین قرار می‌دهد:
.PP
.nf
    bsetbg \-center foo.png
.fi
.PP
نمونه‌ای از کاربرد آرگومان \fB\-exec\fR:
.PP
.nf
    bsetbg \-exec xv \-root \-quit \-rmode 5 \-rbg rgb:2/2/2 \\
        \-center foo.png
.fi
.PP
نمونه‌ای که در آن bsetbg با استفاده از xv و qiv یک فایل پیکربندی ایجاد می‌کند:
.PP
.nf
    bsetbg \-g xv qiv > ~/.bsetbgrc
.fi
.PP
نمونه‌ای از نحوهٔ استفاده از آرگومان \fB\-app\fR:
.PP
.nf
    bsetbg \-app qiv "\-o rgb:d6/c5/a2 \-x" \-c foo.png
.fi

.SH "نویسندگان (AUTHORS)"
می‌توان با نویسندهٔ
.B bsetbg
از طریق نشانی رایانامهٔ \fItmk@lordzork.com\fR ارتباط برقرار کرد.

.SH "همچنین ببینید (SEE ALSO)"
\fIblackbox\fR(1), \fIbsetroot\fR(1), \fIqiv\fR(1), \fIxli\fR(1), \fIxv\fR(1), \fIdisplay\fR(1),
\fIwmsetbg\fR(1)