.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICEWMBG 1" .TH ICEWMBG 1 2026-08-06 "icewm\ 4.1.0" "دستورات کاربر" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" icewmbg \- مدیریت و تنظیم پس‌زمینه دسکتاپ برای مدیر پنجره IceWM .SH "خلاصه دستور (SYNOPSIS)" \&\fBicewmbg\fR [\fIگزینه‌ها\fR] [\fIآرگومان‌ها\fR] .SH "توضیحات (DESCRIPTION)" برنامه \&\fBicewmbg\fR می‌تواند یک رنگ یا تصویر را به پس‌زمینه دسکتاپ \fIX11\fR اختصاص دهد. فرمت‌های متداول تصویر پشتیبانی می‌شوند. هر فضای کاری \fBicewm\fR\|(1) می‌تواند پس‌زمینه مخصوص به خود را داشته باشد. .PP هنگامی که تصویر پس‌زمینه تغییر می‌کند، می‌توان به \&\fBicewmbg\fR اطلاع داد تا پس‌زمینه را به‌روزرسانی کند. هنگام جابجایی بین فضاهای کاری، این برنامه زمان آخرین تغییرات فایل تصویر را بررسی می‌کند و در صورت تغییر یافتن، تصویر را مجدداً بارگذاری می‌نماید. .PP برنامه \&\fBicewmbg\fR از قابلیت نیمه‌شفافیت (semitransparency) پشتیبانی می‌کند. تصاویر و رنگ‌های پس‌زمینه نیمه‌شفاف قابل پیکربندی هستند. .PP این برنامه از RandR یا Xinerama برای پشتیبانی از پس‌زمینه در تمام نمایشگرهای متصل استفاده می‌کند. با اضافه یا حذف شدن نمایشگرها یا تغییر وضوح تصویر (رزولوشن) آن‌ها، \&\fBicewmbg\fR خود را با شرایط جدید تطبیق می‌دهد. این برنامه از گزینه‌ای برای اعمال یک تصویر پس‌زمینه بزرگ روی تمام نمایشگرها نیز پشتیبانی می‌کند. .PP این ابزار هر زمان که پس‌زمینه دسکتاپ را تغییر دهد، ویژگی \f(CW\*(C`_ICEWMBG_IMAGE\*(C'\fR پنجره ریشه (root window) را به مسیر تصویر پس‌زمینه به‌روزرسانی می‌کند. .PP برنامه \&\fBicewmbg\fR به‌صورت خودکار توسط \fBicewm\-session\fR\|(1) اجرا می‌شود. اگر فقط یک پس‌زمینه واحد برای تمام فضاهای کاری تعیین شده باشد، icewmbg ممکن است به این نتیجه برسد که می‌تواند پس از تنظیم پس‌زمینه دسکتاپ با خیال راحت خارج شود تا حافظه سیستم آزاد گردد. در صورت تغییر اندازه صفحه نمایش، icewm تلاش خواهد کرد icewmbg را مجدداً راه‌اندازی کند (ترجیحاً از طریق icewm\-session). .SH "آرگومان‌ها (ARGUMENTS)" .SS "گزینه‌های اختصاصی (SPECIFIC OPTIONS)" در مواردی که امکان تعیین چندین مقدار برای تصاویر یا رنگ‌ها وجود دارد، مقادیر با کاما (\*(Aq,\*(Aq) از یکدیگر جدا می‌شوند. هر یک از این مقادیر می‌تواند داخل گیومه دوتایی قرار گیرد. اگر \fIFILE\fR یک دایرکتوری باشد، تمام تصاویر موجود در آن دایرکتوری به ترتیب مرتب‌شده استفاده می‌شوند. اگر مقدار با علامت تعجب شروع شود، مانند \fI!FILE\fR، تصاویر دایرکتوری \fIFILE\fR به‌صورت تصادفی بر می‌خورند و استفاده می‌شوند. نام فایل‌های تصویری یا دایرکتوری‌ها می‌توانند شامل نویسه‌های عام \fBglob\fR\|(7) باشند، یا با مدک (~) یا متغیر محیطی شروع شوند. .IP "\fB\-f\fR, \fB\-\-fork\fR" 4 .IX Item "-f, --fork" انشعاب (Fork) به پس‌زمینه و جدا شدن از ترمینال. .IP "\fB\-p\fR, \fB\-\-replace\fR" 4 .IX Item "-p, --replace" جایگزینی یک نمونه فعال از \fBicewmbg\fR. اگر نمونه‌ای از \fBicewmbg\fR در حال اجرا باشد، به آن دستور خروج داده می‌شود و نمونه جدید مدیریت را بر عهده می‌گیرد. .IP "\fB\-q\fR, \fB\-\-quit\fR" 4 .IX Item "-q, --quit" دستور خروج به نمونه در حال اجرای \fBicewmbg\fR. این گزینه توسط \&\fBicewm\-session\fR\|(1) هنگام خروج از \fBicewm\fR\|(1) استفاده می‌شود. .IP "\fB\-r\fR, \fB\-\-restart\fR" 4 .IX Item "-r, --restart" دستور راه‌اندازی مجدد به نمونه در حال اجرای \fBicewmbg\fR. این مورد زمانی مفید است که تنظیمات تغییر کرده باشند. اگر هیچ نمونه‌ای فعال نباشد، یک نمونه جدید راه‌اندازی می‌شود. .IP "\fB\-u\fR, \fB\-\-shuffle\fR" 4 .IX Item "-u, --shuffle" بر زدن تصادفی فهرست تصاویر پس‌زمینه. این گزینه می‌تواند مجدداً هر زمان که نیاز باشد نمونه در حال اجرای \&\fBicewmbg\fR فهرست تصاویر پس‌زمینه خود را از نو بر بزند، ارسال شود. .IP "\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR" 4 .IX Item "-c, --config=FILE" بارگذاری تنظیمات ترجیحی از \fIFILE\fR. .IP "\fB\-t\fR, \fB\-\-theme\fR=\fITHEME\fR" 4 .IX Item "-t, --theme=THEME" استفاده از تم با نام \fITHEME\fR. .IP "\fB\-i\fR, \fB\-\-image\fR=\fIFILE\fR[,\fIFILE\fR]*" 4 .IX Item "-i, --image=FILE[,FILE]*" بارگذاری تصاویر پس‌زمینه از هر \fIFILE\fR. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopBackgroundImage\*(C'\fR را باطل می‌کند. هنگامی که بیش از یک تصویر مشخص شود، تصاویر به همان ترتیبی که وارد شده‌اند به هر فضای کاری اختصاص می‌یابند. .IP "\fB\-k\fR, \fB\-\-color\fR=\fICOLOR\fR[,\fICOLOR\fR]*" 4 .IX Item "-k, --color=COLOR[,COLOR]*" استفاده از رنگ‌های پس‌زمینه از هر \fICOLOR\fR. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopBackgroundColor\*(C'\fR را باطل می‌کند. .IP "\fB\-s\fR, \fB\-\-semis\fR=\fIFILE\fR[,\fIFILE\fR]*" 4 .IX Item "-s, --semis=FILE[,FILE]*" بارگذاری تصاویر شفافیت از هر \fIFILE\fR. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopTransparencyImage\*(C'\fR را باطل می‌کند. .IP "\fB\-x\fR, \fB\-\-trans\fR=\fINAME\fR[,\fINAME\fR]" 4 .IX Item "-x, --trans=NAME[,NAME]" استفاده از رنگ‌های شفافیت برای هر \fINAME\fR. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopTransparencyColor\*(C'\fR را باطل می‌کند. .IP "\fB\-e\fR, \fB\-\-center\fR={\fI0\fR|\fI1\fR}" 4 .IX Item "-e, --center={0|1}" غیرفعال‌سازی/فعال‌سازی وسط‌چین کردن پس‌زمینه. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopBackgroundCenter\*(C'\fR را باطل می‌کند. .IP "\fB\-a\fR, \fB\-\-scaled\fR={\fI0\fR|\fI1\fR}" 4 .IX Item "-a, --scaled={0|1}" غیرفعال‌سازی/فعال‌سازی مقیاس‌بندی (کشیدن) پس‌زمینه. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopBackgroundScaled\*(C'\fR را باطل می‌کند. .IP "\fB\-m\fR, \fB\-\-multi\fR={\fI0\fR|\fI1\fR}" 4 .IX Item "-m, --multi={0|1}" غیرفعال‌سازی یا فعال‌سازی یک پس‌زمینه یکپارچه روی تمام نمایشگرها. این گزینه مقدار ترجیحی \f(CW\*(C`DesktopBackgroundMultihead\*(C'\fR را باطل می‌کند. .IP "\fB\-y\fR, \fB\-\-cycle\fR=\fISECONDS\fR" 4 .IX Item "-y, --cycle=SECONDS" چرخش دوره‌ای در میان فهرست تصاویر پس‌زمینه هر \fISECONDS\fR ثانیه یک‌بار. این گزینه مقدار ترجیحی \f(CW\*(C`CycleBackgroundsPeriod\*(C'\fR را باطل می‌کند. .IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 .IX Item "-o, --output=FILE" هدایت مجدد تمام خروجی‌ها به \fIFILE\fR. علامت مدک (~) ابتدایی یا متغیرهای محیطی بسط داده می‌شوند. .IP \fB\-\-postpreferences\fR 4 .IX Item "--postpreferences" چاپ فهرستی از تمام مقادیر ترجیحاتی که \fBicewmbg\fR استفاده خواهد کرد. .IP \fB\-\-verbose\fR 4 .IX Item "--verbose" چاپ گزارشی از عملیات و برخی رویدادها. .SS "گزینه‌های عمومی (GENERAL OPTIONS)" .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 .IX Item "-d, --display=DISPLAY" استفاده از \fIDISPLAY\fR برای اتصال به سرور X. در غیر این صورت از متغیر محیطی DISPLAY استفاده می‌شود. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" چاپ توضیح خلاصه نحوه استفاده در \fIstdout\fR و خروج. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" چاپ نسخه برنامه در \fIstdout\fR و خروج. .IP "\fB\-C\fR, \fB\-\-copying\fR" 4 .IX Item "-C, --copying" چاپ مجوزهای رونوشت‌برداری (کپی‌رایت) برنامه در \fIstdout\fR و خروج. .IP \fB\-\-sync\fR 4 .IX Item "--sync" استفاده از حالت همگام کند برای ارتباط با سرور \fIX11\fR. .IP \fB\-\-verbose\fR 4 .IX Item "--verbose" گزارش برخی از فعالیت‌ها. .SH "فایل‌ها (FILES)" آرگومان‌های اضافی که یا یک مسیر هستند یا دارای پسوند فایل تصویری می‌باشند، به عنوان فایل‌ها یا دایرکتوری‌های تصویر پس‌زمینه در نظر گرفته می‌شوند. .SH "ترجیحات (PREFERENCES)" به‌صورت پیش‌فرض \fBicewmbg\fR تنظیمات را از فایل ترجیحات \fBicewm\fR\|(1) بارگذاری می‌کند. برای جزئیات بیشتر به \fBicewm\-preferences\fR\|(5) مراجعه کنید. تنظیمات خوانده‌شده عبارتند از: .PP .Vb 10 \& DesktopBackgroundCenter \- نمایش پس‌زمینه دسکتاپ به‌صورت وسط‌چین \& DesktopBackgroundScaled \- نمایش پس‌زمینه دسکتاپ به‌صورت مقیاس‌بندی‌شده \& DesktopBackgroundColor \- رنگ(های) پس‌زمینه دسکتاپ \& DesktopBackgroundImage \- تصویر(های) پس‌زمینه دسکتاپ \& ShuffleBackgroundImages \- بر زدن تصادفی فهرست تصاویر پس‌زمینه \& SupportSemitransparency \- پشتیبانی از ترمینال‌های نیمه‌شفاف \& DesktopTransparencyColor \- رنگ(های) پس‌زمینه نیمه‌شفافیت \& DesktopTransparencyImage \- تصویر(های) پس‌زمینه نیمه‌شفافیت \& DesktopBackgroundMultihead \- یک پس‌زمینه یکپارچه روی تمام نمایشگرها \& CycleBackgroundsPeriod \- فاصله زمانی به ثانیه بین چرخش پس‌زمینه‌ها .Ve .PP اگر این تنظیمات در فایل \fIpreferences\fR تعیین شده باشند، می‌توان آن‌ها را از طریق تم در فایل پیش‌فرض‌های تم لغو و بازنویسی کرد. برای اعمال اجباری یک تنظیم خاص، آن را در فایل \fIprefoverride\fR قرار دهید. به \fBicewm\-prefoverride\fR\|(5) مراجعه کنید. .SH "فضاهای کاری (WORKSPACES)" هر فضای کاری می‌تواند تصویر منحصر‌به‌فردی داشته باشد. چند تصویر را در \&\fBDesktopBackgroundImage\fR با کاما (\*(Aq,\*(Aq) از هم جدا کنید. یا حداقل یک دایرکتوری حاوی تصاویر مشخص نمایید. تصاویر به ترتیبی که داده شده‌اند به هر فضای کاری اختصاص داده می‌شوند. هنگامی که icewm فضای کاری را تغییر می‌دهد، نمونه در حال اجرای icewmbg پس‌زمینه دسکتاپ را با تصویر اختصاص‌یافته مطابقت می‌دهد. .PP اگر تعداد تصاویر مشخص‌شده بیشتر از تعداد فضاهای کاری باشد، گزینه \&\fBCycleBackgroundsPeriod\fR می‌تواند یک دوره زمانی تعیین کند. با سپری شدن این زمان، icewmbg به مجموعه بعدی تصاویر جابجا می‌شود. اگر تصاویر کمتری نسبت به تعداد فضاهای کاری ارائه دهید، icewmbg تصاویر قبلی را برای فضاهای کاری باقی‌مانده مجدداً استفاده می‌کند. .SH "مقیاس‌بندی تصویر (IMAGE SCALING)" اغلب پهنا یا ارتفاع یک تصویر پس‌زمینه با صفحه نمایش متفاوت است. در این صورت تصویر می‌تواند تکرار (کاشی‌کاری)، وسط‌چین یا مقیاس‌بندی شود. این رفتار توسط \f(CW\*(C`DesktopBackgroundCenter\*(C'\fR و \f(CW\*(C`DesktopBackgroundScaled\*(C'\fR کنترل می‌شود. آنچه در ترکیب مقادیر آن‌ها رخ می‌دهد در جدول زیر آورده شده است: .PP .Vb 4 \& center:0 scaled:0 = تصویر پس‌زمینه در هر دو جهت تکرار (کاشی‌کاری) می‌شود. \& center:1 scaled:0 = تصویر در مرکز قرار می‌گیرد، اما مقیاس‌بندی نمی‌شود. \& center:1 scaled:1 = یک بعد پر شده و نسبت تصویر حفظ می‌شود. \& center:0 scaled:1 = هر دو بعد پر شده و نسبت تصویر حفظ می‌شود. .Ve .SH "مثال‌ها (EXAMPLES)" .Vb 1 \& # برای چهار پس‌زمینه دسکتاپ مجزا برای چهار فضای کاری: \& \& icewmbg \-f \-p \-i image0,image1,image2,image3 \& \& # یا ساخت یک دایرکتوری با چهار تصویر و اجرای: \& \& icewmbg \-f \-p \-i /path/to/directory \& \& # تصاویر باید دارای پسوند نام فایل تصویری مناسب باشند. .Ve .SH "سیگنال‌ها (SIGNALS)" برنامه \&\fBicewmbg\fR از سیگنال‌های زیر پشتیبانی می‌کند: .IP \fBSIGHUP\fR 4 .IX Item "SIGHUP" برنامه \&\fBicewmbg\fR خود را مجدداً راه‌اندازی می‌کند. .IP "\fBSIGINT\fR, \fBSIGTERM\fR" 4 .IX Item "SIGINT, SIGTERM" برنامه \&\fBicewmbg\fR خاتمه می‌یابد. .IP \fBSIGUSR1\fR 4 .IX Item "SIGUSR1" برنامه \&\fBicewmbg\fR فهرست تصاویر پس‌زمینه را از نو بر می‌زند و پس‌زمینه‌های تمام فضاهای کاری را به‌روزرسانی می‌کند. .SH "همچنین ببینید (SEE ALSO)" \&\fBicewm\fR\|(1), \&\fBicewm\-preferences\fR\|(5), \&\fBicewm\-prefoverride\fR\|(5), \&\fBwmsetbg\fR\|(1), \&\fBxsetbg\fR\|(1), \&\fBxwallpaper\fR\|(1). .SH "گزارش باگ‌ها (BUGS)" لطفاً باگ‌ها را در گزارش دهید. .SH "نویسنده (AUTHOR)" Brian Bidulock . .PP برای مشاهده اطلاعیه کامل حق تکثیر و مجوزهای کپی‌رایت گزینه \fB\-\-copying\fR را ببینید. .SH "مجوز (LICENSE)" \&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. فایل \fICOPYING\fR را در توزیع برنامه مشاهده کنید یا از فلگ \fB\-\-copying\fR برای نمایش مجوزهای رونوشت‌برداری استفاده نمایید.