.\" 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 XSET 1 2025-04-12 "xset 1.2.6" "X Version 11" .SH "نام (NAME)" xset \- ابزار سفارشی‌سازی تنظیمات کاربر برای X .SH "خلاصه دستور (SYNOPSIS)" .nf \fBxset\fP [\fB\-display\fP \fIdisplay\fP] [\fB\-b\fP] [\fBb\fP {\fBon\fP|\fBoff\fP}] [\fBb\fP [\fIvolume\fP [\fIpitch\fP [\fIduration\fP]]]] [\fB\-bc\fP] [\fBbc\fP] [\fB\-c\fP] [\fBc\fP {\fBon\fP|\fBoff\fP}] [\fBc\fP [\fIvolume\fP]] [\fB+dpms\fP] [\fB\-dpms\fP] [\fBdpms\fP \fIstandby\fP [\fI suspend\fP [\fI off\fP]]] [\fBdpms force\fP {\fBstandby\fP|\fBsuspend\fP|\fBoff\fP|\fBon\fP}] [\fBfp=\fP\fIpathlist\fP] [\fB\-fp=\fP\fIpathlist\fP] [\fB+fp=\fP\fIpathlist\fP] [\fBfp\-\fP\fIpathlist\fP] [\fBfp+\fP\fIpathlist\fP] [\fBfp default\fP] [\fBfp rehash\fP] [\fB\-led\fP [\fIinteger\fP|\fBnamed\fP \fIindicator\fP]] [\fBled\fP [\fIinteger\fP|\fBnamed\fP \fIindicator\fP]] [\fBled\fP {\fBon\fP|\fBoff\fP}] [\fBmouse\fP [\fIaccel_mult\fP[/\fIaccel_div\fP] [\fIthreshold\fP]]] [\fBmouse default\fP] [\fBp\fP \fIpixel\fP \fIcolor\fP] [\fB\-r\fP [\fIkeycode\fP]] [\fBr\fP [\fIkeycode\fP]] [\fBr\fP {\fBon\fP|\fBoff\fP}] [\fBr rate\fP \fIdelay\fP [\fIrate\fP]] [\fBs\fP [\fIlength\fP [\fIperiod\fP]]] [\fBs\fP {\fBblank\fP|\fBnoblank\fP}] [\fBs\fP {\fBexpose\fP|\fBnoexpose\fP}] [\fBs\fP {\fBon\fP|\fBoff\fP}] [\fBs default\fP] [\fBs activate\fP] [\fBs reset\fP] [\fBq\fP] [\fB\-version\fP] .fi .SH "توضیحات (DESCRIPTION)" این برنامه برای پیکربندی یا پرس‌وجوی گزینه‌های گوناگون تنظیمات برگزیده کاربر در نمایشگر به کار می‌رود. .SH "گزینه‌ها (OPTIONS)" .TP 8 .B \-display \fIdisplay\fP این گزینه سرور مورد استفاده را مشخص می‌کند؛ نگاه کنید به .BR X (7). .TP 8 .B b گزینه .B b بلندی صدا، زیروبمی (Pitch) و مدت زمان بوق سیستم (Bell) را کنترل می‌کند. این گزینه حداکثر سه پارامتر عددی، یک خط تیره پیشین (\-)، یا پرچم‌های .B on\fR/\fPoff را می‌پذیرد. اگر هیچ پارامتری داده نشود یا از پرچم .B on استفاده شود، مقادیر پیش‌فرض سیستم به کار گرفته خواهند شد. اگر خط تیره یا .B off داده شود، بوق سیستم خاموش خواهد شد. در صورت ارائه تنها یک پارامتر عددی، بلندی صدای بوق سیستم بر حسب درصدی از حداکثر مقدار آن تنظیم می‌شود. به همین ترتیب، پارامتر عددی دوم زیروبمی بوق را بر حسب هرتز و پارامتر عددی سوم مدت زمان آن را بر حسب میلی‌ثانیه تعیین می‌کند. توجه داشته باشید که همه سخت‌افزارها قادر به تغییر مشخصه‌های بوق سیستم نیستند. کارگزار X تا جای ممکن ویژگی‌های بوق را نزدیک به مشخصات درخواستی کاربر تنظیم خواهد کرد. .TP 8 .B bc گزینه .B bc حالت .I سازگاری با باگ‌ها (bug compatibility) را در صورت امکان در کارگزار کنترل می‌کند؛ یک خط تیره پیشین (\-) این حالت را غیرفعال کرده و در غیر این صورت فعال می‌شود. برخی از کلاینت‌های قدیمی پیش از R4، مقادیر نامعتبری را در پاره‌ای از درخواست‌های پروتکل ارسال می‌کردند و سرورهای پیش از R4 در این موارد به درستی خطا ایجاد نمی‌کردند. چنین برنامه‌هایی هنگام اجرا در برابر سرور R4 به طور غیرعادی متوقف شده یا دچار اختلال می‌شوند. حالت سازگاری با باگ‌ها به طور صریح برخی باگ‌ها را دوباره به کارگزار X بازمی‌گرداند تا بسیاری از این کلاینت‌ها همچنان قابل اجرا باشند. از این حالت باید با احتیاط استفاده شود؛ توسعه برنامه‌های جدید باید با غیرفعال بودن این حالت صورت گیرد. برای کارکرد این گزینه، سرور باید از افزونه پروتکل MIT\-SUNDRY\-NONSTANDARD پشتیبانی کند. کارگزار X.Org نسخه 1.2 و جدیدتر از فعال‌سازی این حالت پشتیبانی نمی‌کنند. .TP 8 .B c گزینه .B c صدای کلیک کلیدها (Key Click) را کنترل می‌کند. این گزینه می‌تواند یک مقدار اختیاری، یک خط تیره پیشین (\-)، یا پرچم‌های .B on\fR/\fPoff را بپذیرد. اگر هیچ پارامتری یا پرچم .B on داده نشود، مقادیر پیش‌فرض سیستم استفاده خواهند شد. اگر خط تیره یا پرچم .B off استفاده شود، صدای کلیک کلیدها غیرفعال می‌گردد. در صورت ارائه مقداری بین 0 تا 100، این عدد به عنوان بلندی صدا بر حسب درصدی از حداکثر در نظر گرفته می‌شود. کارگزار X بلندی صدا را روی نزدیک‌ترین مقداری که سخت‌افزار قادر به پشتیبانی از آن است تنظیم خواهد کرد. .TP 8 .B \-dpms گزینه .B \-dpms ویژگی‌های سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را غیرفعال می‌کند. .TP 8 .B +dpms گزینه .B +dpms ویژگی‌های سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را فعال می‌کند. .TP 8 .B dpms \fIflags...\fP گزینه .B dpms امکان تنظیم پارامترهای سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را فراهم می‌آورد. این گزینه می‌تواند تا سه مقدار عددی یا پرچم .B force به همراه یک وضعیت DPMS را دریافت کند. پرچم .B force کارگزار را وادار می‌کند تا فوراً به وضعیت DPMS مشخص‌شده تغییر حالت دهد. وضعیت DPMS می‌تواند یکی از مقادیر \fBstandby\fP، \fBsuspend\fP، \fBoff\fP یا \fBon\fP باشد. هنگامی که مقادیر عددی داده شوند، دوره عدم فعالیت (بر حسب ثانیه) را پیش از فعال شدن این سه حالت تعیین می‌کنند. نخستین مقدار برای حالت \fBstandby\fP، دومین مقدار برای حالت \fBsuspend\fP و سومین مقدار برای حالت \fBoff\fP است. تنظیم این مقادیر، قابلیت‌های DPMS را به صورت ضمنی فعال می‌کند. مقدار صفر یک حالت خاص را غیرفعال می‌سازد. .TP 8 .B fp= \fIpath,...\fP گزینه .B fp= مسیر فونت‌ها را به موارد ارائه‌شده در آرگومان مسیر تنظیم می‌کند. این ورودی‌ها توسط سرور تفسیر می‌شوند، نه کلاینت. این ورودی‌ها معمولاً نام دایرکتوری‌ها یا نام سرورهای فونت هستند، اما تفسیر آن‌ها وابسته به سرور است. .TP 8 .B fp \fBdefault\fP آرگومان .B default باعث بازنشانی مسیر فونت به مقدار پیش‌فرض سرور می‌شود. .TP 8 .B fp \fBrehash\fP آرگومان .B rehash مسیر فونت را به مقدار فعلی آن بازنشانی می‌کند، که سبب می‌شود سرور پایگاه‌های داده قلم را در مسیر فونت فعلی مجدداً بخواند. این حالت معمولاً تنها هنگام افزودن قلم‌های جدید به یک دایرکتوری فونت (پس از اجرای \fImkfontdir\fP برای بازسازی پایگاه داده فونت) استفاده می‌شود. .TP 8 .B "\-fp \fRor\fP fp\-" گزینه‌های .B \-fp و .B fp\- عناصر را از مسیر فونت فعلی حذف می‌کنند. این گزینه‌ها باید با فهرستی از ورودی‌ها که با کاما از هم جدا شده‌اند همراه باشند. .TP 8 .B "+fp \fRor\fP fp+" گزینه‌های .B +fp و .B fp+ به ترتیب عناصر را به ابتدای و انتهای مسیر فونت فعلی اضافه می‌کنند. این گزینه‌ها باید با فهرستی از ورودی‌ها که با کاما از هم جدا شده‌اند همراه باشند. .TP 8 .B led گزینه .B led چراغ‌های نشانگر (LED) صفحه‌کلید را کنترل می‌کند. این گزینه روشن یا خاموش کردن یک یا همه چراغ‌ها را مدیریت می‌کند. این گزینه یک عدد صحیح اختیاری، یک خط تیره پیشین (\-) یا پرچم‌های .B on\fR/\fPoff را می‌پذیرد. اگر هیچ پارامتری یا پرچم .B on داده نشود، تمام LEDها روشن می‌شوند. اگر خط تیره پیشین یا پرچم .B off داده شود، تمام LEDها خاموش می‌شوند. اگر مقداری بین 1 تا 32 داده شود، آن چراغ LED خاص بسته به وجود خط تیره پیشین روشن یا خاموش می‌شود. دستور «xset led 3» چراغ شماره ۳ را روشن می‌کند و «xset \-led 3» آن را خاموش می‌سازد. مقادیر مشخص LED ممکن است در سخت‌افزارهای مختلف به چراغ‌های متفاوتی اشاره داشته باشند. اگر کارگزار X از افزونه XKEYBOARD (XKB) پشتیبانی کند، می‌توان با تعیین کلیدواژه .B named و نام نشانگر، به LEDها با نام نشانگر XKB اشاره کرد. برای نمونه، جهت روشن کردن چراغ Scroll Lock: .IP xset led named "Scroll Lock" .TP 8 .B mouse گزینه .B mouse پارامترهای موشواره (ماوس) را کنترل می‌کند؛ می‌توان آن را به .B m خلاصه کرد. البته این تنظیم برای بیشتر دستگاه‌های اشاره‌گر اعمال می‌شود، نه فقط موشواره‌ها. پارامترهای دستگاه اشاره‌گر عبارتند از .I acceleration (شتاب) و .I threshold (آستانه). .I acceleration می‌تواند به عنوان یک عدد صحیح یا یک کسر ساده مشخص شود. .I threshold تنها یک عدد صحیح است. این تنظیم بر روی تمام دستگاه‌های اشاره‌گر متصل اعمال می‌شود. اگر به تنظیمات اختصاصی برای هر دستگاه نیاز دارید، باید از .BR xinput (1) استفاده شود. .PP به طور پیش‌فرض، هنگامی که دستگاه اشاره‌گر بیش از .I threshold میکی (یعنی پیکسل‌های فرضی) را در مدت ۱۰ میلی‌ثانیه بپیماید، نشانگر (نمایش روی صفحه دستگاه اشاره‌گر) با سرعتی معادل .I acceleration برابر سریع‌تر حرکت خواهد کرد، که شامل یک محدوده انتقال کوچک نیز می‌شود. به این ترتیب، می‌توان از دستگاه اشاره‌گر برای تراز دقیق در حرکت‌های آهسته استفاده کرد، در حالی که در صورت تمایل می‌توان آن را طوری تنظیم نمود که با یک چرخش سریع مچ دست در سراسر صفحه حرکت کند. یک یا هر دو پارامتر گزینه .B mouse را می‌توان حذف کرد، اما اگر تنها یک پارامتر ارائه شود، به عنوان .I acceleration تفسیر خواهد شد. اگر پارامتری ارائه نشود یا از پرچم .B default استفاده شود، مقادیر پیش‌فرض سیستم به کار خواهند رفت. .PP اگر پارامتر .I threshold ارائه شده و برابر 0 باشد، پارامتر .I acceleration در توان یک فرمول طبیعی‌تر و پیوسته استفاده خواهد شد، که کنترل دقیق در حرکات آهسته و پیمایش بزرگ در حرکات سریع را ممکن می‌سازد و گذاری تدریجی را میان این دو حالت فراهم می‌آورد. مقدار توصیه شده برای .I acceleration در این حالت 3/2 تا 3 است، اما به این محدوده محدود نمی‌شود. .PP در کارگزار X.Org نسخه 1.6 و بالاتر، رفتار شرح داده شده تا به اینجا به نمایه پیش‌فرض پیوند خورده است. نمایه‌های دیگری نیز وجود دارند (یعنی توابعی که شتاب نشانگر را از سرعت دستگاه محاسبه می‌کنند) و تنظیمات اضافی دیگری نیز در دسترس هستند، بنابراین توضیحات فوق ممکن است در موارد غیر پیش‌فرض اعمال نشوند. در سرور X.Org نسخه 1.7، این موارد به عنوان ویژگی‌های دستگاه ورودی در دسترس هستند (نگاه کنید به .BR xinput (1)). .TP 8 .B p گزینه .B p مقادیر رنگ پیکسل را کنترل می‌کند. پارامترها عبارتند از شماره ورودی جدول رنگ (Colormap) در مبنای ۱۰، و مشخصه رنگ. رنگ‌های پس‌زمینه ریشه (Root background) را می‌توان در برخی سرورها با تغییر ورودی‌های BlackPixel و WhitePixel تغییر داد. اگرچه این مقادیر غالباً 0 و 1 هستند، اما الزامی بر آن نیست. همچنین، سرور ممکن است تصمیم بگیرد این رنگ‌ها را به صورت اختصاصی تخصیص دهد، که در این حالت خطا رخ خواهد داد. ورودی جدول رنگ نباید یک رنگ فقط‌خواندنی باشد، در غیر این صورت با خطا مواجه خواهد شد. .TP 8 .B r گزینه .B r تکرار خودکار کلیدها (Autorepeat) را کنترل می‌کند. اجرا با «\fB\-r\fP» یا «\fBr\ off\fP» تکرار خودکار را غیرفعال کرده، در حالی که «\fBr\fP» یا «\fBr\ on\fP» آن را فعال می‌کند. درج یک کد کلید (keycode) عددی صحیح بین 0 تا 255 پس از گزینه «\fB\-r\fP» یا «\fBr\fP» به ترتیب تکرار خودکار آن کلید را غیرفعال یا فعال می‌کند، اما فقط در صورتی که این عمل برای آن کد کلید معنادار باشد. کدهای کلید کمتر از 8 معمولاً برای این دستور معتبر نیستند. مثال: «\fBxset\ \-r\ 10\fP» تکرار خودکار را برای کلید «1» در ردیف بالای صفحه‌کلیدهای سازگار با IBM PC غیرفعال می‌کند. .IP اگر سرور از افزونه XFree86-Misc یا افزونه XKB پشتیبانی کند، پارامتر .B rate پذیرفته می‌شود و باید صفر، یک یا دو مقدار عددی به دنبال آن بیاید. مقدار نخست، .I delay (تاخیر) پیش از شروع تکرار خودکار را مشخص کرده و مقدار دوم، نرخ تکرار .RI ( rate ) را تعیین می‌کند. در صورتی که سرور از افزونه XKB پشتیبانی کند، .I delay تعداد میلی‌ثانیه‌ها پیش از آغاز تکرار خودکار است و .I rate تعداد تکرار در هر ثانیه می‌باشد. اگر .I rate یا .I delay داده نشوند، به مقدار پیش‌فرض تنظیم خواهند شد. .TP 8 .B s گزینه .B s به شما امکان می‌دهد پارامترهای محافظ صفحه نمایش (Screen Saver) را تنظیم کنید. این گزینه حداکثر دو پارامتر عددی، پرچم‌های \fBblank\fP/\fBnoblank\fP، پرچم‌های \fBexpose\fP/\fBnoexpose\fP، پرچم‌های \fBon\fP/\fBoff\fP، پرچم‌های \fBactivate\fP/\fBreset\fP یا پرچم .B default را می‌پذیرد. اگر هیچ پارامتری داده نشود یا از پرچم .B default استفاده شود، سیستم روی مشخصات پیش‌فرض محافظ صفحه نمایش تنظیم خواهد شد. پرچم‌های .B on/off به سادگی عملکرد محافظ صفحه نمایش را روشن یا خاموش می‌کنند. پرچم .B activate فعال‌سازی محافظ صفحه نمایش را تحمیل می‌کند، حتی اگر خاموش شده باشد. پرچم .B reset در صورت فعال بودن محافظ صفحه، آن را غیرفعال می‌سازد. پرچم .B blank اولویت را بر سیاه کردن تصویر (در صورت توانایی سخت‌افزار) به جای نمایش الگوی پس‌زمینه قرار می‌دهد، در حالی که .B noblank اولویت را بر نمایش یک الگو به جای سیاه کردن صفحه قرار می‌دهد. پرچم .B expose تنظیم را بر اجازه دادن به نمایان شدن پنجره‌ها (Window exposures - که سرور آزاد است محتویات پنجره را دور بریزد) می‌گذارد، در حالی که .B noexpose تنظیم را بر غیرفعال کردن محافظ صفحه قرار می‌دهد مگر اینکه سرور بتواند صفحات را بدون ایجاد رویدادهای exposure بازسازی کند. پارامترهای .I length و .I period برای عملکرد محافظ صفحه نمایش، تعیین می‌کنند که سرور چه مدت باید غیرفعال باشد تا محافظ صفحه فعال شود، و دوره زمانی تغییر الگوی پس‌زمینه برای جلوگیری از سوختگی فسفر تصویر (Burn-in) چقدر باشد. این آرگومان‌ها بر حسب ثانیه مشخص می‌شوند. اگر تنها یک پارامتر عددی داده شود، برای .I length استفاده خواهد شد. .TP 8 .B q گزینه .B q اطلاعات مربوط به تنظیمات فعلی را به شما ارائه می‌دهد. .TP 8 .B \-version گزینه .B \-version نسخه برنامه را چاپ کرده و بدون انجام هر کار دیگری خارج می‌شود. .PP هنگامی که از نشست کاربری خود خارج شوید (Log out)، این تنظیمات به مقادیر پیش‌فرض بازنشانی خواهند شد. .PP توجه داشته باشید که رعایت تمامی این گزینه‌ها در تمام پیاده‌سازی‌های X تضمین نشده است. .SH "همچنین ببینید (SEE ALSO)" .BR X (7), .BR Xserver (1), .BR xinput (1), .BR xmodmap (1), .BR xrdb (1), .BR xsetroot (1) .SH "نویسندگان (AUTHORS)" Bob Scheifler, MIT Laboratory for Computer Science .br David Krikorian, MIT Project Athena (X11 version) .br XFree86-Misc support added by David Dawes and Joe Moss .br Manpage updates added by Mike A.\& Harris