'\" t
.\"     Title: fvwm-root
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "FVWM\-ROOT" "1" "2026-06-28" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
fvwm-root \- تنظیم تصویر پس‌زمینه پنجره ریشه در نمایشگر X فعلی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBfvwm\-root\fP [\fB\-\-retain\-pixmap\fP|\fB\-r\fP] [\fB\-\-no\-retain\-pixmap\fP]
[\fB\-\-dummy\fP|\fB\-d\fP] [\fB\-\-no\-dummy\fP] [\fB\-\-dither\fP] [\fB\-\-no\-dither\fP]
[\fB\-\-color\-limit\fP [\fIncolors\fP] ] [\fB\-\-no\-color\-limit\fP]
[\fB\-\-help\fP|\fB\-h\fP|\fB\-?\fP] [\fB\-\-version\fP|\fB\-V\fP] \fIimage_file\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fIfvwm\-root\fP فایل تصویری مشخص‌شده در خط فرمان را خوانده و آن را در پنجره ریشه (root window) نمایش می‌دهد. قالب‌های تصویری پشتیبانی‌شده عبارتند از \fIXBM\fP، \fIXPM\fP، \fIPNG\fP و در صورت کامپایل بودن کتابخانه‌های مربوطه، \fISVG\fP.
.sp
گزینه‌های رندر SVG (همان‌گونه که در بخش * ICONS AND IMAGES * در مستندات اصلی fvwm شرح داده شده است) قابل استفاده هستند.
.SH "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های خط فرمان زیر توسط fvwm\-root پشتیبانی می‌شوند:
.sp
\fB\-\-retain\-pixmap\fP | \fB\-r\fP
.RS 4
باعث می‌شود fvwm\-root نگاره‌پیکسلی (Pixmap) که پس‌زمینه با آن تنظیم شده است را نگه دارد و منتشر کند (از مشخصه‌های ESETROOT_PMAP_ID و _XROOTPMAP_ID استفاده می‌شود). این ویژگی برای برنامه‌هایی که می‌خواهند از Pixmap ریشه در پس‌زمینه برای شبیه‌سازی شفافیت استفاده کنند مفید است (به‌عنوان مثال، برنامه‌های Eterm و Aterm از این روش استفاده می‌کنند). این گزینه همچنین باید برای گزینه مجموعه رنگ RootTransparent استفاده شود؛ به بخش COLORSETS در
.BR fvwm (1)
مراجعه کنید. اگر از این گزینه استفاده نشود، fvwm\-root مشخصه _XSETROOT_ID را روی None تنظیم می‌کند، و برخی برنامه‌ها مانند ماژول‌های fvwm ممکن است از این برای به‌روزرسانی پس‌زمینه خود در صورت شفاف بودن پس‌زمینه (مجموعه رنگ Transparent) استفاده کنند.
.sp
توجه داشته باشید که یک برنامه استاندارد، مانند fvwm، باید به تغییرات هر دو مشخصه _XSETROOT_ID و _XROOTPMAP_ID گوش داده و خود را متناسب با آن به‌روزرسانی کند. با این حال برخی برنامه‌ها فقط به یکی از آن‌ها توجه می‌کنند، بنابراین بسته به اینکه چه بخشی توسط این برنامه‌ها پیاده‌سازی شده است باید از این گزینه استفاده کنید یا خیر. همچنین برای داشتن منوهای سریع با شفافیت ریشه در fvwm باید از این گزینه استفاده کنید.
.RE
.sp
\fB\-\-no\-retain\-pixmap\fP
.RS 4
این حالت پیش‌فرض است. برای اجبار صریح حالت پیش‌فرض، حتی اگر "\-\-retain\-pixmap" پیش‌تر مشخص شده باشد، کاربرد دارد.
.RE
.sp
\fB\-\-dummy\fP | \fB\-d\fP
.RS 4
باعث می‌شود fvwm\-root پس‌زمینه را تنظیم \fBنکند\fP، بلکه تنها حافظه مرتبط با مشخصه ESETROOT_PMAP_ID (در صورت وجود) را آزاد سازد. در هر حالت مشخصه _XSETROOT_ID روی None تنظیم می‌شود.
.RE
.sp
\fB\-\-no\-dummy\fP
.RS 4
این حالت پیش‌فرض است. برای اجبار صریح حالت پیش‌فرض، حتی اگر "\-\-dummy" پیش‌تر مشخص شده باشد، کاربرد دارد.
.RE
.sp
\fB\-\-dither\fP
.RS 4
باعث می‌شود fvwm\-root برای نمایش روان‌تر روی نمایشگرهایی با عمق رنگ ۱۶ یا کمتر، تصویر را دیتر (dither) کند. این حالت پیش‌فرض برای عمق رنگ کمتر یا مساوی ۸ است.
.RE
.sp
\fB\-\-no\-dither\fP
.RS 4
باعث می‌شود fvwm\-root تصاویر را دیتر نکند. این حالت پیش‌فرض برای عمق رنگ بیشتر از ۸ است.
.RE
.sp
\fB\-\-color\-limit \fP\fIncolors\fP
.RS 4
باعث می‌شود fvwm\-root مصرف رنگ خود را به \fIncolors\fP (در صورت تعیین) محدود کند. این گزینه تنها در عمق رنگ کمتر یا مساوی ۸ (و حالت بصری TrueColor یا GrayScale) در نظر گرفته می‌شود. حالت پیش‌فرض استفاده از همان محدودیت رنگ fvwm است، بنابراین در شرایط عادی این گزینه مفید نیست. با این حال، اگر fvwm از جدول رنگ اختصاصی استفاده کند، از آنجا که fvwm\-root همواره از جدول رنگ پیش‌فرض استفاده می‌کند، باید از این گزینه برای محدود کردن صحیح رنگ‌ها استفاده نمایید. اگر \fIncolors\fP مشخص نشود، از مقدار پیش‌فرض استفاده می‌شود.
.RE
.sp
\fB\-\-no\-color\-limit\fP
.RS 4
باعث می‌شود fvwm\-root مصرف رنگ خود را محدود نکند.
.RE
.sp
\fB\-\-help\fP
.RS 4
راهنمای کوتاه نحوه استفاده را نمایش می‌دهد.
.RE
.sp
\fB\-\-version\fP
.RS 4
شماره نسخه را نمایش می‌دهد.
.RE
.SH "اشکالات (BUGS)"
.sp
استفاده مکرر از fvwm\-root با نگاره‌های پیکسلی (pixmaps) مختلف xpm، خانه‌های جدول رنگ شما را به سرعت پر خواهد کرد.
.SH "نویسندگان (AUTHORS)"
.sp
راب نیشن (Rob Nation)
.sp
بازنویسی و بهبودیافته توسط توسعه‌دهندگان اف‌وی‌دبلیوام (fvwm\-workers).