نام (NAME)

icewmbg - مدیریت و تنظیم پس‌زمینه دسکتاپ برای مدیر پنجره IceWM

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

icewmbg [گزینه‌ها] [آرگومان‌ها]

توضیحات (DESCRIPTION)

برنامه icewmbg می‌تواند یک رنگ یا تصویر را به پس‌زمینه دسکتاپ X11 اختصاص دهد. فرمت‌های متداول تصویر پشتیبانی می‌شوند. هر فضای کاری icewm(1) می‌تواند پس‌زمینه مخصوص به خود را داشته باشد.

هنگامی که تصویر پس‌زمینه تغییر می‌کند، می‌توان به icewmbg اطلاع داد تا پس‌زمینه را به‌روزرسانی کند. هنگام جابجایی بین فضاهای کاری، این برنامه زمان آخرین تغییرات فایل تصویر را بررسی می‌کند و در صورت تغییر یافتن، تصویر را مجدداً بارگذاری می‌نماید.

برنامه icewmbg از قابلیت نیمه‌شفافیت (semitransparency) پشتیبانی می‌کند. تصاویر و رنگ‌های پس‌زمینه نیمه‌شفاف قابل پیکربندی هستند.

این برنامه از RandR یا Xinerama برای پشتیبانی از پس‌زمینه در تمام نمایشگرهای متصل استفاده می‌کند. با اضافه یا حذف شدن نمایشگرها یا تغییر وضوح تصویر (رزولوشن) آن‌ها، icewmbg خود را با شرایط جدید تطبیق می‌دهد. این برنامه از گزینه‌ای برای اعمال یک تصویر پس‌زمینه بزرگ روی تمام نمایشگرها نیز پشتیبانی می‌کند.

این ابزار هر زمان که پس‌زمینه دسکتاپ را تغییر دهد، ویژگی "_ICEWMBG_IMAGE" پنجره ریشه (root window) را به مسیر تصویر پس‌زمینه به‌روزرسانی می‌کند.

برنامه icewmbg به‌صورت خودکار توسط icewm-session(1) اجرا می‌شود. اگر فقط یک پس‌زمینه واحد برای تمام فضاهای کاری تعیین شده باشد، icewmbg ممکن است به این نتیجه برسد که می‌تواند پس از تنظیم پس‌زمینه دسکتاپ با خیال راحت خارج شود تا حافظه سیستم آزاد گردد. در صورت تغییر اندازه صفحه نمایش، icewm تلاش خواهد کرد icewmbg را مجدداً راه‌اندازی کند (ترجیحاً از طریق icewm-session).

آرگومان‌ها (ARGUMENTS)

گزینه‌های اختصاصی (SPECIFIC OPTIONS)

در مواردی که امکان تعیین چندین مقدار برای تصاویر یا رنگ‌ها وجود دارد، مقادیر با کاما (',') از یکدیگر جدا می‌شوند. هر یک از این مقادیر می‌تواند داخل گیومه دوتایی قرار گیرد. اگر FILE یک دایرکتوری باشد، تمام تصاویر موجود در آن دایرکتوری به ترتیب مرتب‌شده استفاده می‌شوند. اگر مقدار با علامت تعجب شروع شود، مانند !FILE، تصاویر دایرکتوری FILE به‌صورت تصادفی بر می‌خورند و استفاده می‌شوند. نام فایل‌های تصویری یا دایرکتوری‌ها می‌توانند شامل نویسه‌های عام glob(7) باشند، یا با مدک (~) یا متغیر محیطی شروع شوند.

-f, --fork: انشعاب (Fork) به پس‌زمینه و جدا شدن از ترمینال.
-p, --replace: جایگزینی یک نمونه فعال از icewmbg. اگر نمونه‌ای از icewmbg در حال اجرا باشد، به آن دستور خروج داده می‌شود و نمونه جدید مدیریت را بر عهده می‌گیرد.
-q, --quit: دستور خروج به نمونه در حال اجرای icewmbg. این گزینه توسط icewm-session(1) هنگام خروج از icewm(1) استفاده می‌شود.
-r, --restart: دستور راه‌اندازی مجدد به نمونه در حال اجرای icewmbg. این مورد زمانی مفید است که تنظیمات تغییر کرده باشند. اگر هیچ نمونه‌ای فعال نباشد، یک نمونه جدید راه‌اندازی می‌شود.
-u, --shuffle: بر زدن تصادفی فهرست تصاویر پس‌زمینه. این گزینه می‌تواند مجدداً هر زمان که نیاز باشد نمونه در حال اجرای icewmbg فهرست تصاویر پس‌زمینه خود را از نو بر بزند، ارسال شود.
-c, --config=FILE: بارگذاری تنظیمات ترجیحی از FILE.
-t, --theme=THEME: استفاده از تم با نام THEME.
-i, --image=FILE[,FILE]*: بارگذاری تصاویر پس‌زمینه از هر FILE. این گزینه مقدار ترجیحی "DesktopBackgroundImage" را باطل می‌کند. هنگامی که بیش از یک تصویر مشخص شود، تصاویر به همان ترتیبی که وارد شده‌اند به هر فضای کاری اختصاص می‌یابند.
-k, --color=COLOR[,COLOR]*: استفاده از رنگ‌های پس‌زمینه از هر COLOR. این گزینه مقدار ترجیحی "DesktopBackgroundColor" را باطل می‌کند.
-s, --semis=FILE[,FILE]*: بارگذاری تصاویر شفافیت از هر FILE. این گزینه مقدار ترجیحی "DesktopTransparencyImage" را باطل می‌کند.
-x, --trans=NAME[,NAME]: استفاده از رنگ‌های شفافیت برای هر NAME. این گزینه مقدار ترجیحی "DesktopTransparencyColor" را باطل می‌کند.
-e, --center={0|1}: غیرفعال‌سازی/فعال‌سازی وسط‌چین کردن پس‌زمینه. این گزینه مقدار ترجیحی "DesktopBackgroundCenter" را باطل می‌کند.
-a, --scaled={0|1}: غیرفعال‌سازی/فعال‌سازی مقیاس‌بندی (کشیدن) پس‌زمینه. این گزینه مقدار ترجیحی "DesktopBackgroundScaled" را باطل می‌کند.
-m, --multi={0|1}: غیرفعال‌سازی یا فعال‌سازی یک پس‌زمینه یکپارچه روی تمام نمایشگرها. این گزینه مقدار ترجیحی "DesktopBackgroundMultihead" را باطل می‌کند.
-y, --cycle=SECONDS: چرخش دوره‌ای در میان فهرست تصاویر پس‌زمینه هر SECONDS ثانیه یک‌بار. این گزینه مقدار ترجیحی "CycleBackgroundsPeriod" را باطل می‌کند.
-o, --output=FILE: هدایت مجدد تمام خروجی‌ها به FILE. علامت مدک (~) ابتدایی یا متغیرهای محیطی بسط داده می‌شوند.
--postpreferences: چاپ فهرستی از تمام مقادیر ترجیحاتی که icewmbg استفاده خواهد کرد.
--verbose: چاپ گزارشی از عملیات و برخی رویدادها.

گزینه‌های عمومی (GENERAL OPTIONS)

-d, --display=DISPLAY: استفاده از DISPLAY برای اتصال به سرور X. در غیر این صورت از متغیر محیطی DISPLAY استفاده می‌شود.
-h, --help: چاپ توضیح خلاصه نحوه استفاده در stdout و خروج.
-V, --version: چاپ نسخه برنامه در stdout و خروج.
-C, --copying: چاپ مجوزهای رونوشت‌برداری (کپی‌رایت) برنامه در stdout و خروج.
--sync: استفاده از حالت همگام کند برای ارتباط با سرور X11.
--verbose: گزارش برخی از فعالیت‌ها.

فایل‌ها (FILES)

آرگومان‌های اضافی که یا یک مسیر هستند یا دارای پسوند فایل تصویری می‌باشند، به عنوان فایل‌ها یا دایرکتوری‌های تصویر پس‌زمینه در نظر گرفته می‌شوند.

ترجیحات (PREFERENCES)

به‌صورت پیش‌فرض icewmbg تنظیمات را از فایل ترجیحات icewm(1) بارگذاری می‌کند. برای جزئیات بیشتر به icewm-preferences(5) مراجعه کنید. تنظیمات خوانده‌شده عبارتند از:

DesktopBackgroundCenter    - نمایش پس‌زمینه دسکتاپ به‌صورت وسط‌چین
DesktopBackgroundScaled    - نمایش پس‌زمینه دسکتاپ به‌صورت مقیاس‌بندی‌شده
DesktopBackgroundColor     - رنگ(های) پس‌زمینه دسکتاپ
DesktopBackgroundImage     - تصویر(های) پس‌زمینه دسکتاپ
ShuffleBackgroundImages    - بر زدن تصادفی فهرست تصاویر پس‌زمینه
SupportSemitransparency    - پشتیبانی از ترمینال‌های نیمه‌شفاف
DesktopTransparencyColor   - رنگ(های) پس‌زمینه نیمه‌شفافیت
DesktopTransparencyImage   - تصویر(های) پس‌زمینه نیمه‌شفافیت
DesktopBackgroundMultihead - یک پس‌زمینه یکپارچه روی تمام نمایشگرها
CycleBackgroundsPeriod     - فاصله زمانی به ثانیه بین چرخش پس‌زمینه‌ها

اگر این تنظیمات در فایل preferences تعیین شده باشند، می‌توان آن‌ها را از طریق تم در فایل پیش‌فرض‌های تم لغو و بازنویسی کرد. برای اعمال اجباری یک تنظیم خاص، آن را در فایل prefoverride قرار دهید. به icewm-prefoverride(5) مراجعه کنید.

فضاهای کاری (WORKSPACES)

هر فضای کاری می‌تواند تصویر منحصر‌به‌فردی داشته باشد. چند تصویر را در DesktopBackgroundImage با کاما (',') از هم جدا کنید. یا حداقل یک دایرکتوری حاوی تصاویر مشخص نمایید. تصاویر به ترتیبی که داده شده‌اند به هر فضای کاری اختصاص داده می‌شوند. هنگامی که icewm فضای کاری را تغییر می‌دهد، نمونه در حال اجرای icewmbg پس‌زمینه دسکتاپ را با تصویر اختصاص‌یافته مطابقت می‌دهد.

اگر تعداد تصاویر مشخص‌شده بیشتر از تعداد فضاهای کاری باشد، گزینه CycleBackgroundsPeriod می‌تواند یک دوره زمانی تعیین کند. با سپری شدن این زمان، icewmbg به مجموعه بعدی تصاویر جابجا می‌شود. اگر تصاویر کمتری نسبت به تعداد فضاهای کاری ارائه دهید، icewmbg تصاویر قبلی را برای فضاهای کاری باقی‌مانده مجدداً استفاده می‌کند.

مقیاس‌بندی تصویر (IMAGE SCALING)

اغلب پهنا یا ارتفاع یک تصویر پس‌زمینه با صفحه نمایش متفاوت است. در این صورت تصویر می‌تواند تکرار (کاشی‌کاری)، وسط‌چین یا مقیاس‌بندی شود. این رفتار توسط "DesktopBackgroundCenter" و "DesktopBackgroundScaled" کنترل می‌شود. آنچه در ترکیب مقادیر آن‌ها رخ می‌دهد در جدول زیر آورده شده است:

center:0 scaled:0 = تصویر پس‌زمینه در هر دو جهت تکرار (کاشی‌کاری) می‌شود.
center:1 scaled:0 = تصویر در مرکز قرار می‌گیرد، اما مقیاس‌بندی نمی‌شود.
center:1 scaled:1 = یک بعد پر شده و نسبت تصویر حفظ می‌شود.
center:0 scaled:1 = هر دو بعد پر شده و نسبت تصویر حفظ می‌شود.

مثال‌ها (EXAMPLES)

# برای چهار پس‌زمینه دسکتاپ مجزا برای چهار فضای کاری:
icewmbg -f -p -i image0,image1,image2,image3
# یا ساخت یک دایرکتوری با چهار تصویر و اجرای:
icewmbg -f -p -i /path/to/directory
# تصاویر باید دارای پسوند نام فایل تصویری مناسب باشند.

سیگنال‌ها (SIGNALS)

برنامه icewmbg از سیگنال‌های زیر پشتیبانی می‌کند:

SIGHUP: برنامه icewmbg خود را مجدداً راه‌اندازی می‌کند.
SIGINT, SIGTERM: برنامه icewmbg خاتمه می‌یابد.
SIGUSR1: برنامه icewmbg فهرست تصاویر پس‌زمینه را از نو بر می‌زند و پس‌زمینه‌های تمام فضاهای کاری را به‌روزرسانی می‌کند.

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

icewm(1), icewm-preferences(5), icewm-prefoverride(5), wmsetbg(1), xsetbg(1), xwallpaper(1).

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

لطفاً باگ‌ها را در https://github.com/ice-wm/icewm/issues گزارش دهید.

نویسنده (AUTHOR)

Brian Bidulock <mailto:bidulock@openss7.org>.

برای مشاهده اطلاعیه کامل حق تکثیر و مجوزهای کپی‌رایت گزینه --copying را ببینید.

مجوز (LICENSE)

IceWM تحت مجوز GNU Library General Public License منتشر شده است. فایل COPYING را در توزیع برنامه مشاهده کنید یا از فلگ --copying برای نمایش مجوزهای رونوشت‌برداری استفاده نمایید.