ICEWMBG(1)                       دستورات کاربر                      ICEWMBG(1)


نام (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 برای نمایش
       مجوزهای رونوشت‌برداری استفاده نمایید.

icewm 4.1.0                       2026-08-06                        ICEWMBG(1)