.TH KWIN_WAYLAND 1 "2026-10-08" "KDE Plasma" "راهنمای پارچ لینوکس" .SH "نام (NAME)" kwin_wayland \- مدیر پنجره و کامپوزیتور Wayland برای محیط KDE Plasma .SH "خلاصه دستور (SYNOPSIS)" .B kwin_wayland [\fIگزینه‌ها\fR] [\fIبرنامه‌ها\fR...] .SH "توضیحات (DESCRIPTION)" .B kwin_wayland مدیر پنجره رسمی و سرور نمایش مبتنی بر پروتکل .B Wayland برای محیط رومیزی .B KDE Plasma است. در معماری وی‌لند، برخلاف سیستم سنتی پنجره X11، کامپوزیتور مستقیماً به عنوان سرور نمایش، مدیر پنجره و ترکیب‌کننده تصویر عمل می‌کند. .PP برنامه .B kwin_wayland مسئولیت مدیریت پنجره‌ها، چینش و موقعیت‌یابی آن‌ها، مدیریت ورودی‌ها (صفحه‌کلید، ماوس، تاچ‌پد)، جلوه‌های گرافیکی و بصری رومیزی، چندسکویی خروجی‌ها و پشتیبانی از مانیتورهای متعدد را بر عهده دارد. همچنین از طریق سازوکار .BR Xwayland ، امکان اجرای شفاف و روان برنامه‌های سنتی X11 را در بستر وی‌لند فراهم می‌سازد. .PP علاوه بر اجرای مستقیم روی سخت‌افزار از طریق درایورهای .BR DRM / KMS ، این برنامه قابلیت اجرا به‌صورت تودرتو (Nested) درون نشست‌های دیگر X11 یا Wayland را جهت اهداف توسعه، آزمایش و عیب‌یابی دارد. .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های اصلی و راه‌اندازی سرور" .TP .B \-\-xwayland راه‌اندازی سرور .B Xwayland به‌صورت بدون ریشه (Rootless) برای پشتیبانی از برنامه‌های مبتنی بر X11. .TP .BI \-s ", " \-\-socket " نام_سوکت" تعیین نام سوکت وی‌لند برای گوش فرا دادن به ارتباطات کلاینت‌ها. در صورت مشخص نشدن، نام پیش‌فرض .B wayland\-0 استفاده می‌شود. .TP .BI \-\-wayland\-fd " توصیف‌گر" استفاده از یک توصیف‌گر فایل (File Descriptor) از پیش باز شده برای سوکت وی‌لند به جای ایجاد سوکت جدید. .TP .BI \-\-xwayland\-fd " توصیف‌گر" تعیین توصیف‌گر فایل باز برای اتصال به سرور .BR Xwayland . .TP .BI \-\-xwayland\-display " نمایشگر" تعیین شناسه نمایشگر X11 که سرور .B Xwayland روی آن اجرا می‌شود (مانند .BR :1 ). .TP .BI \-\-xwayland\-xauthority " مسیر_فایل" تعیین مسیر فایل .B Xauthority برای اعتبارسنجی و احراز هویت در سرور .BR Xwayland . .TP .B \-\-replace جایگزینی مدیر پنجره فعال فعلی با این نسخه. .TP .B \-\-no\-lockscreen غیرفعال‌سازی قفل صفحه داخلی و عدم اجرای سرویس محافظ صفحه. .TP .B \-\-lockscreen اجرای نشست از ابتدا در حالت قفل بودن صفحه. .TP .B \-\-no\-kactivities غیرفعال‌سازی یکپارچگی با سرویس فعالیت‌های کی‌دی‌ای .BR (KActivities) . .TP .B \-\-no\-global\-shortcuts غیرفعال‌سازی تمامی میان‌برهای عمومی صفحه‌کلید در سطح سیستم. .TP .BI \-\-exit\-with\-session " برنامه" بسته شدن و خروج خودکار .B kwin_wayland به محض پایان یافتن اجرای برنامه نشست مشخص‌شده. .TP .BI \-\-inputmethod " برنامه" تعیین برنامه سرور روش ورودی .B (Input Method) جهت راه‌اندازی همزمان با کامپوزیتور. .SS "گزینه‌های بک‌اند و رندرینگ" .TP .B \-\-drm استفاده از بک‌اند مدیریت مستقیم رندرینگ .B (Direct Rendering Manager / KMS) برای اجرای مستقیم روی سخت‌افزار گرافیکی لینوکس. .TP .B \-\-windowed اجرای کامپوزیتور در حالت تودرتو و به‌صورت یک پنجره در نشست میزبان موجود. .TP .BI \-\-x11\-display " نمایشگر" تعیین نام نمایشگر X11 در زمان اجرای تودرتو در بستر پلتفرم X11 (مانند .BR :0 ). .TP .BI \-\-wayland\-display " سوکت" تعیین سوکت نمایشگر وی‌لند در زمان اجرای تودرتو در بستر سرور وی‌لند میزبان. .TP .BI \-\-width " عرض" تعیین عرض پنجره در حالت تودرتو بر حسب پیکسل (مقدار پیش‌فرض: 1024). .TP .BI \-\-height " ارتفاع" تعیین ارتفاع پنجره در حالت تودرتو بر حسب پیکسل (مقدار پیش‌فرض: 768). .TP .BI \-\-output\-scale " ضریب" تعیین ضریب مقیاس‌بندی خروجی تصویر .BR (HiDPI) . .TP .BI \-\-output\-count " تعداد" تعیین تعداد خروجی‌های مجازی شبیه‌سازی‌شده. .TP .B \-\-framebuffer استفاده از بک‌اند فریم‌بافر لینوکس برای رندر تصویر. .TP .BI \-\-fb\-device " دستگاه" تعیین مسیر فایل دستگاه فریم‌بافر (مقدار پیش‌فرض: .BR /dev/fb0 ). .TP .B \-\-virtual استفاده از بک‌اند فریم‌بافر مجازی در حافظه بدون نیاز به نمایشگر فیزیکی. .TP .B \-\-libinput فعال‌سازی صریح کتابخانه .B libinput جهت پردازش رویدادهای ورودی ماوس، کیبورد و لمس. .SS "گزینه‌های عمومی" .TP .BI \-\-crashes " تعداد" تعیین حداکثر تعداد مجاز کرش و بازنشانی مجدد قبل از خروج کامل برنامه. .TP .BR \-h ", " \-\-help نمایش راهنمای گزینه‌های خط فرمان و خروج. .TP .BR \-v ", " \-\-version نمایش اطلاعات نسخه و خروج. .TP .B \-\-author نمایش اطلاعات توسعه‌دهندگان و نویسندگان برنامه. .TP .B \-\-license نمایش اطلاعات مجوز انتشار نرم‌افزار. .SH "متغیرهای محیطی (ENVIRONMENT)" .TP .B WAYLAND_DISPLAY نام سوکت سرور وی‌لند جاری (معمولاً .BR wayland\-0 ). .TP .B DISPLAY شناسه نمایشگر سرور X11 یا Xwayland برای اتصال برنامه‌های قدیمی‌تر. .TP .B XAUTHORITY مسیر فایل کلیدهای دسترسی امنیتی X11. .TP .B QT_QPA_PLATFORM پلتفرم لایه انتزاعی گرافیک کیوت. مقدار .B wayland برنامه‌های کیوت را وادار به اتصال مستقیم به وی‌لند و مقدار .B xcb آن‌ها را به سمت سرور X11/Xwayland هدایت می‌کند. .TP .B KWIN_RESTART_COUNT شمارنده داخلی تعداد دفعات راه‌اندازی مجدد خودکار پس از بروز خطا. .TP .B WAYLAND_DEBUG در صورت تنظیم بر روی مقدار .BR 1 , تمامی پیام‌ها و پروتکل‌های مبادله‌شده وی‌لند در خروجی استاندارد ثبت می‌شوند. .SH "مثال‌ها (EXAMPLES)" .PP راه‌اندازی کامپوزیتور وی‌لند با پشتیبانی از برنامه‌های X11: .PP .nf kwin_wayland --xwayland .fi .PP اجرای نشست تودرتو درون یک پنجره با اندازه مشخص برای آزمایش: .PP .nf kwin_wayland --windowed --width 1280 --height 720 .fi .PP اجرای تودرتو در وی‌لند با تعیین نام سوکت اختصاصی و راه‌اندازی خودکار ترمینال: .PP .nf kwin_wayland --socket wayland-1 --exit-with-session konsole .fi .SH "همچنین ببینید (SEE ALSO)" .BR kwin_x11 (1), .BR startplasma-wayland (1), .BR plasma-session (1), .BR Xwayland (1), .BR wayland-info (1) .PP مستندات برخط پروژه کی‌دی‌ای: .BR و .BR .SH "نویسندگان (AUTHORS)" تیم توسعه‌دهندگان KWin و جامعه KDE Plasma. .PP ترجمه شده برای پروژه صفحات راهنمای پارچ لینوکس.