XSETROOT(1) X Version 11 XSETROOT(1)

xsetroot - ابزار تنظیم پارامترهای پنجرهٔ ریشه برای سامانه پنجره X

xsetroot -help | -version
xsetroot [-display display | -d display] [-def | -default]
         [-cursor cursorfile maskfile | -cursor_name cursorfontname
          -xcf cursorfile cursorsize]
         [-bitmap filename | -mod x y | -gray | -grey | -solid color]
         [-bg color] [-fg color] [-rv] [-name string] 

برنامهٔ xsetroot به شما امکان می‌دهد ظاهر پنجرهٔ پس‌زمینه («ریشه» یا "root") را در نمایشگر ایستگاه کاری تحت سامانهٔ X سفارشی‌سازی کنید. به‌طور معمول، آن‌قدر با xsetroot آزمایش و خطا می‌کنید تا به ظاهر شخصی‌سازی‌شدهٔ دلخواه خود برسید، سپس دستور xsetroot ایجادکنندهٔ آن را در فایل راه‌اندازی X خود قرار می‌دهید. توجه داشته باشید که برخی از محیط‌های رومیزی یا مدیران پنجره، پنجرهٔ پس‌زمینهٔ تمام‌صفحهٔ مخصوص به خود را نمایش می‌دهند که پنجرهٔ ریشه را کاملاً می‌پوشاند؛ این امر ممکن است مانع از مشاهدهٔ تغییرات اعمال‌شده توسط این ابزار شود.

اگر هیچ گزینه‌ای مشخص نشود یا گزینهٔ -def تعیین گردد، پنجره به حالت پیش‌فرض خود بازنشانی می‌شود. گزینهٔ -def می‌تواند همراه با سایر گزینه‌ها نیز استفاده شود که در این صورت تنها مشخصه‌های تعیین‌نشده به حالت پیش‌فرض بازنشانی خواهند شد.

در هر بار اجرا تنها یکی از گزینه‌های تغییر رنگ/الگوی پس‌زمینه (-solid، -gray، -grey، -bitmap و -mod) می‌تواند مشخص شود.

گزینه‌های گوناگون به شرح زیر هستند:

پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
پیام نسخه را چاپ کرده و خارج می‌شود.
ویژگی‌های تعیین‌نشده را به مقادیر پیش‌فرض بازنشانی می‌کند. (پس‌زمینه را به الگوی توری خاکستریِ آشنا و مکان‌نما را به شکل x توخالی بازمی‌گرداند.)
به شما امکان می‌دهد هنگامی که مکان‌نمای اشاره‌گر خارج از هر پنجره‌ای قرار دارد، آن را به شکل دلخواه تغییر دهید. فایل‌های مکان‌نما و ماسک، تصاویر شطرنجی (بیت‌مپ‌ها یا تصاویر کوچک) هستند و می‌توان آن‌ها را با برنامهٔ bitmap(1) ایجاد کرد. احتمالاً ترجیح می‌دهید تا زمانی که با نحوهٔ کارکرد ماسک‌ها آشنا شوید، فایل ماسک کاملاً سیاه باشد.
به شما امکان می‌دهد مکان‌نمای اشاره‌گر را به یکی از مکان‌نماهای استاندارد از قلم مکان‌نما تغییر دهید. برای مشاهدهٔ نام‌ها به ضمیمهٔ B از پروتکل X مراجعه کنید (با این تفاوت که پیشوند XC_ برای این گزینه حذف می‌شود).
به شما امکان می‌دهد مکان‌نمای اشاره‌گر را به مکان‌نمای بارگذاری‌شده از یک فایل Xcursor، طبق تعریف libXcursor و در اندازهٔ مشخص‌شده تغییر دهید.
از بیت‌مپ مشخص‌شده در فایل برای تنظیم الگوی پنجره استفاده می‌کند. می‌توانید فایل‌های بیت‌مپ شخصی خود (تصاویر کوچک) را با استفاده از برنامهٔ bitmap(1) بسازید. تمام پس‌زمینه از تکرار «کاشی‌های» این بیت‌مپ تشکیل خواهد شد.
اگر می‌خواهید الگوی شبکه‌ای شطرنجی روی صفحهٔ خود داشته باشید، از این گزینه استفاده می‌شود. x و y اعدادی صحیح در محدودهٔ ۱ تا ۱۶ هستند. ترکیب‌های مختلف را امتحان کنید. صفر و اعداد منفی معادل ۱ در نظر گرفته می‌شوند.
تمام پس‌زمینه را خاکستری می‌کند (برای چشم راحت‌تر است).
از color به عنوان رنگ پس‌زمینه استفاده می‌کند.
از color به عنوان رنگ پیش‌زمینه استفاده می‌کند. رنگ‌های پیش‌زمینه و پس‌زمینه تنها در ترکیب با گزینه‌های -cursor، -bitmap یا -mod معنا دارند.
رنگ‌های پیش‌زمینه و پس‌زمینه را با یکدیگر جابه‌جا می‌کند. به‌طور معمول رنگ پیش‌زمینه سیاه و رنگ پس‌زمینه سفید است.
پس‌زمینهٔ پنجرهٔ ریشه را به رنگ مشخص‌شده تنظیم می‌کند. این گزینه تنها در سرورهای رنگی قابل استفاده است.
نام پنجرهٔ ریشه را روی string تنظیم می‌کند. مقدار پیش‌فرضی وجود ندارد.
سروری را که باید به آن متصل شد مشخص می‌کند؛ ببینید: X(7).

X(7), xset(1), xrdb(1), Xcursor(3)

Mark Lillibridge, MIT Project Athena

2025-04-12 xsetroot 1.1.4