.\" -*- 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 "ICEWM-MENU-XRANDR 1"
.TH ICEWM-MENU-XRANDR 1 2026-08-06 "icewm\ 4.1.0" "User Commands"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SS "نام (NAME)"
.IX Subsection "NAME"
.Vb 1
\& icewm\-menu\-xrandr \- ارائه‌دهنده منوی IceWM برای میان‌برهای برپایی چندنمایشگره
.Ve
.SS "خلاصه دستور (SYNOPSIS)"
.IX Subsection "SYNOPSIS"
\&\fBicewm\-menu\-xrandr\fR
.SS "توضیحات (DESCRIPTION)"
.IX Subsection "DESCRIPTION"
دستور \fBicewm\-menu\-xrandr\fR ابزاری کمکی برای مدیریت پیکربندی‌های چندنمایشگره
به روشی نیمه‌خودکار است. این ابزار یک تولیدکنندهٔ معمولی منوی icewm است که
صفحه‌نمایش‌های موجود در xrandr (یعنی مانیتورهای متصل) را شناسایی کرده و
ورودی‌های منویی ایجاد می‌کند که برای راه‌اندازی این پیکربندی دستور xrandr را فراخوانی می‌نمایند.
.PP
به‌صورت اختیاری، محتویات پیکربندی‌های تولیدشده می‌تواند در لحظه از طریق یک منوی سبک
«تغییرسریع» (quick\-switch) در دسترس قرار گیرد؛ منویی که با فشردن کلید میان‌بر Super\-P
(یا کلیدی که به‌صورت دستی پیکربندی شده باشد؛ برای پیکربندی دستورالعمل \fBswitchkey\fR به
\&\fBicewm\-keys\fR\|(5) مراجعه کنید) باز می‌شود.
.PP
این ابزار تفکیک‌پذیری‌های دقیق مانیتور، نرخ‌های نوسازی یا جهت‌گیری صفحه را بررسی
نمی‌کند. برای این موارد، به‌طور پیش‌فرض از حالت انتخاب خودکار استفاده می‌کند. با این حال،
می‌توان انتخاب گزینهٔ سفارشی را برای هر خروجی با استفاده از گزینه‌های \fIxrandr\fR در یک
فایل پیکربندی سفارشی جایگزین کرد (بخش \fICONFIGURATION\fR را در زیر ببینید). همچنین تنظیم
گزینه‌های خاص مانند \-\-brightness و \-\-gamma در آنجا امکان‌پذیر است.
.PP
نام نمایش‌داده‌شده برای مانیتورها با استفاده از نام خروجی و اطلاعات مانیتور برگرفته از
داده‌های EDID آن ساخته می‌شود؛ چه از فیلد «Display Name» آن و چه از فیلدهای
«Unspecified ASCII text» (به‌صورت الحاق‌شده).
.SS "گزینه‌ها (OPTIONS)"
.IX Subsection "OPTIONS"
.IP \fB\-\-max\fR 4
.IX Item "--max"
گزینه‌ای منسوخ و بی‌اثر. پیش‌تر برای انتخاب حالت \fIxrandr\fR با بالاترین نرخ نوسازیِ
شناسایی‌شده استفاده می‌شد. با این حال، بیشینه نرخ ممکن است مشکلاتی ایجاد کند، بنابراین
اکنون باید از پیکربندی صریح در \fIINI file\fR استفاده شود، بخش \fICONFIGURATION\fR را ببینید.
.IP "\fB\-\-auto\-number [ init value ]\fR" 4
.IX Item "--auto-number [ init value ]"
افزودن یک پیشوند عددی با افزایش خودکار به نام هر نمایشگر، که به‌صورت اختیاری از مقدار
مشخص‌شده شروع می‌شود. این گزینه بیشتر برای ایجاد منو مفید است.
.IP "\fB\-\-xrandr command\fR" 4
.IX Item "--xrandr command"
جایگزینی برای دستور \fIxrandr\fR که باید داده‌های معادل را ارائه داده و همان گزینه‌های
\&\fIxrandr\fR را بپذیرد.
.IP "\fB\-\-activate combo\-name\fR" 4
.IX Item "--activate combo-name"
میان‌بری برای اجرای دستور فعال‌سازی ترکیب مشخص‌شده، درست مانند حالتی که \fIIceWM\fR دستور
را هنگام انتخاب از منو یا کادر گفتگوی تغییرسریع اجرا می‌کند. پارامتر \fIcombo\-name\fR
باید دقیقاً با نام نمایش‌داده‌شده مطابقت داشته باشد.
.SS "پیکربندی (CONFIGURATION)"
.IX Subsection "CONFIGURATION"
به‌صورت اختیاری، یک پیکربندی محلی می‌تواند گزینه‌های خط فرمان را برای فراخوانی‌های
\&\fIxrandr\fR و دستورهای دیگری را برای اجرا پس از تغییر حالت مشخص کند.
.PP
برای نحو و قواعد این فایل، به نمونه‌های پیکربندی (\fIxrandr_menu\fR) در مستندات
\&\fIicewm\fR یا پوشه contrib آن مراجعه کنید. این فایل می‌تواند در مسیر \fR\f(CI$HOME\fR\fI/.config/icewm\fR یا در
\&\fI\fR\f(CI$HOME\fR\fI/.icewm\fR یا هر مسیری که \fI\fR\f(CI$XDG_CONFIG_HOME\fR\fI/.config/icewm\fR به آن اشاره کند،
قرار گیرد.
.SS "همچنین ببینید (SEE ALSO)"
.IX Subsection "SEE ALSO"
\&\fBicewm\fR\|(1)،
\&\fBxrandr\fR\|(1).
.SS "گزارش باگ‌ها (BUGS)"
.IX Subsection "BUGS"
لطفاً باگ‌ها را در <https://github.com/ice\-wm/icewm/issues> گزارش دهید.
.SS "نویسندگان (AUTHORS)"
.IX Subsection "AUTHOR"
Eduard Bloch <mailto:edi@gmx.de>.
.SS "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Subsection "LICENSE"
\&\fBicewm\-menu\-xrandr\fR تحت مجوز Simplified BSD License منتشر شده است.
\&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است.
فایل \fICOPYING\fR را در توزیع مشاهده کنید.