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