.\" Copyright 1988, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.TH XSETROOT 1 2025-04-12 "xsetroot 1.1.4" "X Version 11"
.SH "نام (NAME)"
xsetroot \- ابزار تنظیم پارامترهای پنجرهٔ ریشه برای سامانه پنجره X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxsetroot\fP \fB\-help\fP | \fB\-version\fP
\fBxsetroot\fP [\fB\-display\fP \fIdisplay\fP | \fB\-d\fP \fIdisplay\fP] \
[\fB\-def\fP | \fB\-default\fP]
         [\fB\-cursor\fP \fIcursorfile maskfile\fP | \
\fB\-cursor_name\fP \fIcursorfontname\fP
          \fB\-xcf\fP \fIcursorfile\fP \fIcursorsize\fP]
         [\fB\-bitmap\fP \fIfilename\fP \
| \fB\-mod\fP \fIx y\fP \
| \fB\-gray\fP \
| \fB\-grey\fP \
| \fB\-solid\fP \fIcolor\fP]
         [\fB\-bg\fP \fIcolor\fP] \
[\fB\-fg\fP \fIcolor\fP] \
[\fB\-rv\fP] \
[\fB\-name\fP \fIstring\fP] \

.fi
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B xsetroot
به شما امکان می‌دهد ظاهر پنجرهٔ پس‌زمینه («ریشه» یا "root") را در نمایشگر ایستگاه کاری تحت سامانهٔ X سفارشی‌سازی کنید.
به‌طور معمول، آن‌قدر با
.B xsetroot
آزمایش و خطا می‌کنید تا به ظاهر شخصی‌سازی‌شدهٔ دلخواه خود برسید، سپس دستور
.B xsetroot
ایجادکنندهٔ آن را در فایل راه‌اندازی X خود قرار می‌دهید.
توجه داشته باشید که برخی از محیط‌های رومیزی یا مدیران پنجره، پنجرهٔ پس‌زمینهٔ تمام‌صفحهٔ مخصوص به خود را نمایش می‌دهند که پنجرهٔ ریشه را کاملاً می‌پوشاند؛ این امر ممکن است مانع از مشاهدهٔ تغییرات اعمال‌شده توسط این ابزار شود.
.PP
اگر هیچ گزینه‌ای مشخص نشود یا گزینهٔ
.B \-def
تعیین گردد، پنجره به حالت پیش‌فرض خود بازنشانی می‌شود. گزینهٔ
.B \-def
می‌تواند همراه با سایر گزینه‌ها نیز استفاده شود که در این صورت تنها مشخصه‌های تعیین‌نشده به حالت پیش‌فرض بازنشانی خواهند شد.
.PP
در هر بار اجرا تنها یکی از گزینه‌های تغییر رنگ/الگوی پس‌زمینه
(\fB\-solid\fP، \fB\-gray\fP، \fB\-grey\fP، \fB\-bitmap\fP و \fB\-mod\fP)
می‌تواند مشخص شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های گوناگون به شرح زیر هستند:
.IP "\fB\-help\fP"
پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
.IP "\fB\-version\fP"
پیام نسخه را چاپ کرده و خارج می‌شود.
.IP "\fB\-def, \-default\fP"
ویژگی‌های تعیین‌نشده را به مقادیر پیش‌فرض بازنشانی می‌کند.
(پس‌زمینه را به الگوی توری خاکستریِ آشنا و مکان‌نما را به شکل x توخالی بازمی‌گرداند.)
.IP "\fB\-cursor\fP \fIcursorfile\fP \fImaskfile\fP"
به شما امکان می‌دهد هنگامی که مکان‌نمای اشاره‌گر خارج از هر پنجره‌ای قرار دارد، آن را به شکل دلخواه تغییر دهید.
فایل‌های مکان‌نما و ماسک، تصاویر شطرنجی (بیت‌مپ‌ها یا تصاویر کوچک) هستند و می‌توان آن‌ها را با برنامهٔ
.BR bitmap (1)
ایجاد کرد. احتمالاً ترجیح می‌دهید تا زمانی که با نحوهٔ کارکرد ماسک‌ها آشنا شوید، فایل ماسک کاملاً سیاه باشد.
.IP "\fB\-cursor_name\fP \fIcursorfontname\fP"
به شما امکان می‌دهد مکان‌نمای اشاره‌گر را به یکی از مکان‌نماهای استاندارد از قلم مکان‌نما تغییر دهید.
برای مشاهدهٔ نام‌ها به ضمیمهٔ B از پروتکل X مراجعه کنید
(با این تفاوت که پیشوند XC_ برای این گزینه حذف می‌شود).
.IP "\fB\-xcf\fP \fIcursorfile\fP \fIcursorsize\fP"
به شما امکان می‌دهد مکان‌نمای اشاره‌گر را به مکان‌نمای بارگذاری‌شده از یک فایل Xcursor، طبق تعریف libXcursor و در اندازهٔ مشخص‌شده تغییر دهید.
.IP "\fB\-bitmap\fP \fIfilename\fP"
از بیت‌مپ مشخص‌شده در فایل برای تنظیم الگوی پنجره استفاده می‌کند.
می‌توانید فایل‌های بیت‌مپ شخصی خود (تصاویر کوچک) را با استفاده از برنامهٔ
.BR bitmap (1)
بسازید. تمام پس‌زمینه از تکرار «کاشی‌های» این بیت‌مپ تشکیل خواهد شد.
.IP "\fB\-mod\fP \fIx\fP \fIy\fP"
اگر می‌خواهید الگوی شبکه‌ای شطرنجی روی صفحهٔ خود داشته باشید، از این گزینه استفاده می‌شود.
\fIx\fP و \fIy\fP اعدادی صحیح در محدودهٔ ۱ تا ۱۶ هستند.
ترکیب‌های مختلف را امتحان کنید.
صفر و اعداد منفی معادل ۱ در نظر گرفته می‌شوند.
.IP "\fB\-gray, \-grey\fP"
تمام پس‌زمینه را خاکستری می‌کند (برای چشم راحت‌تر است).
.IP "\fB\-bg, \-background\fP \fIcolor\fP"
از \fIcolor\fP به عنوان رنگ پس‌زمینه استفاده می‌کند.
.IP "\fB\-fg, \-foreground\fP \fIcolor\fP"
از \fIcolor\fP به عنوان رنگ پیش‌زمینه استفاده می‌کند.
رنگ‌های پیش‌زمینه و پس‌زمینه تنها در ترکیب با گزینه‌های
\fB\-cursor\fP، \fB\-bitmap\fP یا \fB\-mod\fP
معنا دارند.
.IP "\fB\-rv, \-reverse\fP"
رنگ‌های پیش‌زمینه و پس‌زمینه را با یکدیگر جابه‌جا می‌کند.
به‌طور معمول رنگ پیش‌زمینه سیاه و رنگ پس‌زمینه سفید است.
.IP "\fB\-solid\fP \fIcolor\fP"
پس‌زمینهٔ پنجرهٔ ریشه را به رنگ مشخص‌شده تنظیم می‌کند.
این گزینه تنها در سرورهای رنگی قابل استفاده است.
.IP "\fB\-name\fP \fIstring\fP"
نام پنجرهٔ ریشه را روی \fIstring\fP تنظیم می‌کند. مقدار پیش‌فرضی وجود ندارد.
.IP "\fB\-d, \-display\fP \fIdisplay\fP"
سروری را که باید به آن متصل شد مشخص می‌کند؛ ببینید:
.BR X (7).
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xset (1),
.BR xrdb (1),
.BR Xcursor (3)
.SH "نویسندگان (AUTHORS)"
Mark Lillibridge, MIT Project Athena