.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "sway-output" "5" "2026-06-23"
.PP
.SH "نام (NAME)"
.PP
sway-output \- دستورات پیکربندی خروجی برای sway
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
می‌توانید دستورات خروجی را به صورت یکجا مانند زیر با هم ترکیب کنید:
.PP
.RS 4
output HDMI-A-1 mode 1920x1080 pos 1920 0 bg \(ti/wallpaper.\&png stretch
.PP
.RE
می‌توانید با دستور \fBswaymsg -t get_outputs\fR فهرستی از نام‌های خروجی را دریافت کنید.\& همچنین می‌توانید با استفاده از نام خروجی "*" با هر خروجی مطابقت دهید.\& علاوه بر این، می‌توان از "-" برای تطبیق خروجی فوکوس‌شده بر پایه نام و از "--" برای تطبیق خروجی فوکوس‌شده بر پایه شناسه آن استفاده کرد.\&
.PP
برخی از خروجی‌ها ممکن است هنگام قطع و وصل مجدد نام‌های متفاوتی داشته باشند.\& برای شناسایی این موارد، نام می‌تواند با رشته‌ای شامل شرکت سازنده، مدل و شماره سریال که می‌توانید از \fBswaymsg -t get_outputs\fR دریافت کنید، جایگزین شود.\& هر مقدار باید با یک فاصله جدا شود.\& برای نمونه:
.PP
.RS 4
output "Some Company ABC123 0x00000000" pos 1920 0
.PP
.RE
.SH "دستورات (COMMANDS)"
.PP
\fBoutput\fR <name> mode|resolution|res [--custom] <width>x<height>[@<rate>Hz]
.RS 4
خروجی مشخص‌شده را برای استفاده از حالت داده‌شده پیکربندی می‌کند.\& حالت‌ها ترکیبی از پهنا و بلندا (به پیکسل) و یک نرخ نوسازی هستند که نمایشگر شما می‌تواند برای استفاده از آن پیکربندی شود.\& برای مشاهده فهرستی از حالت‌های دردسترس برای هر خروجی، از \fBswaymsg -t get_outputs\fR استفاده کنید.\&
.PP
برای تنظیم یک حالت سفارشی که در فهرست حالت‌های دردسترس وجود ندارد، از گزینه \fB\-\-custom\fR استفاده کنید.\& احتمالاً تنها زمانی باید از این گزینه استفاده کنید که دقیقاً بدانید چه کاری انجام می‌دهید.\&
.PP
مثال‌ها:
.PP
.RS 4
output HDMI-A-1 mode 1920x1080
.PP
output HDMI-A-1 mode 1920x1080@60Hz
.PP
.RE
.RE
\fBoutput\fR <name> modeline <clock> <hdisplay> <hsync_start> <hsync_end> <htotal> <vdisplay> <vsync_start> <vsync_end> <vtotal> <hsync> <vsync>
.RS 4
خروجی مشخص‌شده را برای استفاده از خط‌حالت (modeline) ارائه‌شده پیکربندی می‌کند.\& این مقدار را می‌توان با استفاده از دستورات \fBcvt\fR(1) و \fBgtf\fR(1) تولید کرد.\& راهنمای \fBxorg.\&conf\fR(5) را ببینید.\&
تنها روی بک‌اند DRM پشتیبانی می‌شود.\&
.PP
مثال:
.PP
.RS 4
output HDMI-A-1 modeline 173.\&00 1920 2048 2248 2576 1080 1083 1088 1120 -hsync +vsync
.PP
.PP
.RE
.RE
\fBoutput\fR <name> position|pos <X> <Y>
.RS 4
خروجی مشخص‌شده را در موقعیت معینی در فضای مختصات سراسری قرار می‌دهد.\& نشانگر مکان‌نما تنها می‌تواند بین خروجی‌های دقیقاً مجاور جابه‌جا شود.\& در صورت فعال بودن مقیاس‌بندی (scaling)، باید هنگام تعیین موقعیت در نظر گرفته شود.\& برای نمونه، اگر ضریب مقیاس‌بندی برای خروجی سمت چپ برابر با ۲ باشد، موقعیت نسبی برای خروجی سمت راست باید بر ۲ تقسیم شود.\&
نقطه مرجع، گوشه بالا سمت چپ است، بنابراین اگر می‌خواهید لبه‌های پایینی هم‌تراز باشند، این نکته نیز باید مد نظر قرار گیرد.\&
.PP
مثال:
.PP
.RS 4
output HDMI1 scale 2
.PP
output HDMI1 pos 0 1020 res 3200x1800
.PP
output eDP1 pos 1600 0 res 1920x1080
.PP
.RE
توجه داشته باشید که موقعیت افقی چپ (x-pos) نمایشگر eDP1 برابر است با 1600 = 3200/2 و موقعیت عمودی پایینی (y-pos) برابر است با
1020 + (1800 / 2) = 1920 = 0 + 1920
.PP
.RE
\fBoutput\fR <name> scale <factor>
.RS 4
خروجی مشخص‌شده را بر اساس ضریب مقیاس \fIfactor\fR داده‌شده مقیاس‌بندی می‌کند.\& استفاده از عدد صحیح توصیه می‌شود، اما مقادیر کسری نیز پشتیبانی می‌شوند.\& ممکن است تنظیم یک ضریب مقیاس صحیح و تنظیم اندازه قلم برنامه‌ها به دلخواه نتیجه بهتری به همراه داشته باشد.\& ویژگی HiDPI در کلاینت‌های Xwayland پشتیبانی نمی‌شود (پنجره‌ها تار خواهند شد).\& مقیاس کسری ممکن است برای تطابق با الزامات پروتکل اندکی تعدیل شود.\&
.PP
.RE
\fBoutput\fR <name> scale_filter linear|nearest|smart
.RS 4
نحوه مقیاس‌بندی بافرهای برنامه‌ای را مشخص می‌کند که در مقیاسی پایین‌تر از مقیاس پیکربندی‌شده خروجی رندر شده‌اند، مانند برنامه‌های با وضوح پایین (lo-dpi) در صفحه‌های با وضوح بالا (hi-dpi).\& حالت خطی (linear) نرم‌تر و تارتر است، و حالت نزدیک‌ترین (nearest، که به عنوان نزدیک‌ترین همسایه نیز شناخته می‌شود) واضح‌تر و پیکسلی‌تر است.\& تنظیم روی "smart" در حالتی که خروجی دارای ضریب مقیاس صحیح باشد مقیاس‌بندی nearest و در غیر این صورت مقیاس‌بندی linear را اعمال می‌کند.\& مقدار پیش‌فرض "smart" است.\&
.PP
.RE
\fBoutput\fR <name> subpixel rgb|bgr|vrgb|vbgr|none
.RS 4
هینتینگ زیرپیکسل (subpixel hinting) را به صورت دستی برای خروجی مشخص‌شده تنظیم می‌کند.\& این مقدار معمولاً به طور خودکار تشخیص داده می‌شود، اما برخی نمایشگرها ممکن است هندسه زیرپیکسل خود را نادرست گزارش کنند.\& استفاده از هینتینگ زیرپیکسل صحیح باعث شفاف‌تر شدن متن می‌شود.\& مقادیر نادرست باعث تار شدن متن خواهند شد.\& هنگام تغییر این مقدار از طریق \fBswaymsg\fR، ممکن است برای اعمال مقدار جدید نیاز به راه‌اندازی مجدد برخی برنامه‌ها باشد.\&
.PP
.RE
\fBoutput\fR <name> background|bg <file> <mode> [<fallback_color>]
.RS 4
تصویر پس‌زمینه را برای خروجی داده‌شده روی فایل مشخص‌شده، با استفاده از حالت مقیاس‌بندی تعیین‌شده (یکی از موارد "stretch"، "fill"، "fit"، "center"، "tile") تنظیم می‌کند.\& اگر دسترسی به فایل مشخص‌شده امکان‌پذیر نباشد یا تصویر کل خروجی را نپوشاند، می‌توان یک رنگ جایگزین (fallback color) برای پوشش باقی‌مانده خروجی تعیین کرد.\& مقدار \fIfallback_color\fR باید به صورت \fI#RRGGBB\fR مشخص شود.\& کانال آلفا پشتیبانی نمی‌شود.\&
.PP
.RE
\fBoutput\fR <name> background|bg <color> solid_color
.RS 4
پس‌زمینه خروجی داده‌شده را روی رنگ یکدست مشخص‌شده تنظیم می‌کند.\& مقدار \fIcolor\fR باید به صورت \fI#RRGGBB\fR مشخص شود.\& کانال آلفا پشتیبانی نمی‌شود.\&
.PP
.RE
\fBoutput\fR <name> transform <transform> [clockwise|anticlockwise]
.RS 4
تبدیل هندسی پس‌زمینه را روی مقدار داده‌شده تنظیم می‌کند.\& می‌تواند یکی از مقادیر "90"، "180"، "270" برای چرخش؛ یا "flipped"، "flipped-90"، "flipped-180"، "flipped-270" برای اعمال چرخش و وارون‌سازی (flip)، یا "normal" برای عدم اعمال تبدیل باشد.\& چرخش در جهت عقربه‌های ساعت انجام می‌شود.\& اگر یک خروجی واحد انتخاب شده و جهت چرخش مشخص شده باشد (\fIclockwise\fR یا \fIanticlockwise\fR)، مقدار تبدیل به تبدیل فعلی افزوده یا از آن کاسته می‌شود (این حالت را نمی‌توان مستقیماً در فایل پیکربندی استفاده کرد).\&
.PP
.RE
\fBoutput\fR <name> disable|enable
.RS 4
خروجی مشخص‌شده را فعال یا غیرفعال می‌کند (همه خروجی‌ها به طور پیش‌فرض فعال هستند).\&
.PP
بر خلاف دستور \fIpower\fR، خروجی فضای کاری و پنجره‌های فعلی خود را از دست خواهد داد.\&
.PP
.RE
\fBoutput\fR <name> toggle
.RS 4
وضعیت خروجی مشخص‌شده را تغییر می‌دهد (تغییر وضعیت بین فعال و غیرفعال).\&
.PP
.RE
\fBoutput\fR <name> power on|off|toggle
.RS 4
برق خروجی مشخص‌شده را روشن یا خاموش می‌کند.\&
.PP
بر خلاف دستورات \fIenable\fR و \fIdisable\fR، خروجی فضاهای کاری و پنجره‌های فعلی خود را حفظ می‌کند.\&
.PP
.RE
\fBoutput\fR <name> dpms on|off|toggle
.RS 4
منسوخ‌شده.\& نام مستعار برای \fIpower\fR.\&
.PP
.RE
\fBoutput\fR <name> max_render_time off|<msec>
.RS 4
زمان ترکیب‌بندی خروجی توسط sway را بر حسب تعداد میلی‌ثانیه مثبت قبل از نوسازی بعدی نمایشگر کنترل می‌کند.\& عدد کوچک‌تر منجر به فریم‌های ترکیب‌شده تازه‌تر و تاخیر ورودی ادراک‌شده کمتر می‌شود، اما اگر خیلی کم تنظیم شود، ممکن است sway نتواند ترکیب‌بندی را به موقع برای نوسازی نمایشگر به پایان برساند که منجر به تاخیر فریم‌ها می‌شود.\&
.PP
هنگامی که روی off تنظیم شود، sway بلافاصله پس از نوسازی نمایشگر ترکیب‌بندی را انجام می‌دهد که زمان در دسترس برای ترکیب‌بندی را به حداکثر می‌رساند.\&
.PP
برای تنظیم زمانی که برنامه‌ها دستور رندر دریافت می‌کنند، گزینه \fBmax_render_time\fR را در \fBsway\fR(5) ببینید.\&
.PP
برای تنظیم این مورد جهت دستیابی به تاخیر بهینه:
.PD 0
.IP 1. 4
یک برنامه تمام‌صفحه (\fIfull-screen\fR) را که به طور مداوم رندر می‌شود، مانند \fBglxgears\fR اجرا کنید.\&
.IP 2. 4
با \fBmax_render_time 1\fR شروع کنید.\& در صورت مشاهده افت فریم، آن را \fB1\fR واحد افزایش دهید.\&
.PD
.PP
این تنظیم تنها روی بک‌آندهای Wayland و DRM اثر دارد، زیرا نیازمند پشتیبانی از برچسب‌های زمانی ارائه و نرخ نوسازی پیش‌بینی‌شده خروجی است.\&
.PP
.RE
\fBoutput\fR <name> adaptive_sync on|off|toggle
.RS 4
همگام‌سازی تطبیقی (که معمولاً به عنوان نرخ نوسازی متغیر یا Variable Refresh Rate و با نام‌های تجاری FreeSync/G-Sync شناخته می‌شود) را فعال یا غیرفعال می‌کند.\&
.PP
همگام‌سازی تطبیقی به کلاینت‌ها اجازه می‌دهد فریم‌ها را با اندکی تاخیر ارسال کنند، بدون اینکه نیاز باشد برای نمایش آن روی صفحه یک دوره نوسازی کامل منتظر بمانند.\& فعال‌سازی همگام‌سازی تطبیقی می‌تواند تاخیر را بهبود بخشد، اما ممکن است در برخی سخت‌افزارها باعث پرش تصویر شود.\&
.PP
.RE
\fBoutput\fR <name> render_bit_depth 6|8|10
.RS 4
حداکثر عمق بیتی کانال رنگ را که فریم‌ها در آن رندر می‌شوند کنترل می‌کند؛ مقدار پیش‌فرض در حال حاضر ۸ بیت در هر کانال است.\&
.PP
اگر سخت‌افزار و نرم‌افزار از چنین عمق بیت‌هایی پشتیبانی نکنند، تنظیم مقادیر بالاتر هیچ تاثیری نخواهد داشت.\& افزایش موفقیت‌آمیز عمق بیت رندر لزوماً عمق بیت فریم‌های ارسالی به نمایشگر را افزایش نمی‌دهد.\& افزایش عمق بیت رندر ممکن است رندر یکدست‌تری از گرادیان‌ها و تصویربرداری‌هایی از صفحه فراهم کند که رنگ برنامه‌های نمایش‌دهنده رنگ‌های با عمق بیت بالا را دقیق‌تر ذخیره می‌کنند.\&
.PP
هشدار: این کار می‌تواند برنامه‌های عکس‌برداری/فیلم‌برداری از صفحه را که برای کار با عمق‌های بیت متفاوت به‌روزرسانی نشده‌اند با اختلال مواجه کند.\& این دستور آزمایشی است و ممکن است در آینده حذف شده یا تغییر کند.\&
.PP
.RE
\fBoutput\fR <name> color_profile [--device-primaries] gamma22|srgb
.RS 4
پروفایل رنگ را برای یک خروجی تنظیم می‌کند.\& مقدار پیش‌فرض \fIgamma22\fR است.\&
.PP
گزینه \fI\-\-device-primaries\fR در صورت دردسترس بودن، از رنگ‌های پایه خودگزارش‌شده خروجی استفاده می‌کند (برای نمونه از EDID نمایشگر).\&
.PP
همه رندرسازها از این ویژگی پشتیبانی نمی‌کنند؛ در حال حاضر تنها با رندرساز Vulkan کار می‌کند.\& این ویژگی با قابلیت‌های پشتیبانی از HDR سازگار نیست.\&
.PP
.RE
\fBoutput\fR <name> color_profile icc <file>
.RS 4
پروفایل رنگ را برای یک خروجی تنظیم می‌کند.\&
.PP
پارامتر <file> باید مسیری به یک پروفایل ICC نمایشگر باشد.\&
.PP
همه رندرسازها از این ویژگی پشتیبانی نمی‌کنند؛ در حال حاضر تنها با رندرساز Vulkan کار می‌کند.\& حتی در صورت پشتیبانی نیز، اعمال پروفایل رنگ ممکن است دقیق نباشد.\&
.PP
این دستور آزمایشی است و ممکن است در آینده حذف شده یا تغییر کند.\& همچنین ممکن است هنگام استفاده همزمان با قابلیت‌های آتی پشتیبانی از HDR هیچ اثری نداشته باشد یا خروجی غیرمنتظره‌ای تولید کند.\&
.PP
.RE
\fBoutput\fR <name> allow_tearing yes|no
.RS 4
شکست تصویر (screen tearing) را در نتیجه تعویض فوری صفحه (immediate page flips) و حالت ارائه فوری از سوی کلاینت مجاز یا غیرمجاز می‌کند.\& مقدار پیش‌فرض این است که هیچ شکست تصویری مجاز نیست.\&
.PP
با تعویض فوری صفحه، فریم‌های ارسالی از کلاینت به جای همگام‌سازی با بازه خالی عمودی مانیتور (VSync)، در سریع‌ترین زمان ممکن نمایش داده می‌شوند.\&
.PP
توصیه می‌شود مقدار \fBmax_render_time\fR روی \fBoff\fR تنظیم شود.\& در این صورت، به محض به‌روزرسانی کلاینت، تعویض صفحه رخ می‌دهد.\& در غیر این صورت، شکست تصویر تنها در صورتی رخ می‌دهد که زمان رندر بیش از میلی‌ثانیه‌های پیکربندی‌شده قبل از نوسازی بعدی نمایشگر طول بکشد.\&
.PP
برای تنظیم مجاز بودن شکست تصویر برای برنامه‌های خاص، گزینه \fBallow_tearing\fR را در \fBsway\fR(5) ببینید.\& توجه داشته باشید که شکست تصویر تنها زمانی فعال می‌شود که هم برای خروجی و هم برای برنامه مجاز شده باشد.\&
.PP
این تنظیم تنها زمانی اثر دارد که یک پنجره روی خروجی به صورت تمام‌صفحه باشد.\&
.PP
.RE
\fBoutput\fR <name> hdr on|off|toggle
.RS 4
قابلیت HDR (دامنه دینامیکی بالا یا High Dynamic Range) را فعال یا غیرفعال می‌کند.\& قابلیت HDR طیف رنگی گسترده‌تر و محدوده روشنایی بیشتری را امکان‌پذیر می‌سازد.\& استاندارد HDR از رنگ‌های پایه‌ای BT2020 و تابع انتقال PQ استفاده می‌کند.\&
.PP
هنگامی که HDR فعال باشد، مقدار \fIrender_bit_depth\fR به طور ضمنی روی ۱۰ تنظیم می‌شود مگر اینکه به طور صریح پیکربندی شده باشد.\& استفاده از عمق بیت رندر پایین‌تر ممکن است منجر به مصنوعات نواری‌شدن رنگ (color banding artifacts) شود.\&
.PP
برای فعال‌سازی، HDR باید توسط خروجی و رندرساز پشتیبانی شود.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsway\fR(5) \fBsway-input\fR(5)