gdctl(1) User Commands gdctl(1)

gdctl - کنترل‌کننده صفحه‌نمایش گنوم (GNOME Display Controller)

gdctl [-h] COMMAND ...

دستور gdctl امکاناتی را برای نمایش پیکربندی فعال مانیتور و همچنین تنظیم پیکربندی جدید برای مانیتورها با استفاده از آرگومان‌های خط فرمان فراهم می‌کند.

این ابزار نیازمند یک کامپوزیتور است که از رابط برنامه‌نویسی D-Bus با شناسهٔ org.gnome.Mutter.DisplayConfig پشتیبانی کند، مانند گنوم شل (GNOME Shell).

show

نمایش پیکربندی فعلی صفحه‌نمایش

set

تنظیم یک پیکربندی جدید برای صفحه‌نمایش

pref

تنظیم ترجیحات مربوط به صفحه‌نمایش.

--help, -h

نمایش پیام راهنما و خروج.

--modes, -m

فهرست کردن حالت‌های موجود برای مانیتور.

--properties, -p

فهرست کردن ویژگی‌ها.

--verbose, -v

نمایش تمام اطلاعات موجود (معادل --modes --properties).

--help, -h

نمایش پیام راهنما و خروج.

--persistent, -P

ذخیره پیکربندی اعمال‌شده در حافظه پایدار و بازیابی آن در صورت امکان.

--verbose, -v

چاپ پیکربندی در خروجی استاندارد قبل از اعمال آن.

--verify, -V

صرفاً اعتبارسنجی پیکربندی، بدون اعمال آن.

--layout-mode LAYOUT-MODE, -l

مشخص کردن حالت چیدمانی که پیکربندی باید استفاده کند؛ logical (منطقی) یا physical (فیزیکی).

--logical-monitor, -L

افزودن و پیکربندی یک مانیتور منطقی. به بخش «گزینه‌های مانیتور منطقی» مراجعه کنید.

--for-lease-monitor CONNECTOR, -e CONNECTOR

تنظیم یک مانیتور که بخشی از هیچ مانیتور منطقی نیست، به‌عنوان مانیتور در دسترس برای اجاره (lease).

--monitor CONNECTOR, -M CONNECTOR

افزودن یک مانیتور به مانیتور منطقی که در حال حاضر پیکربندی می‌شود. همه مانیتورهای درون یک مانیتور منطقی یکسان باید رزولوشن مانیتور برابری داشته باشند.

--primary, -p

علامت‌گذاری مانیتور منطقی جاری به‌عنوان مانیتور اصلی (primary).

--scale SCALE, -s SCALE

مقیاس‌بندی مانیتورهای درون مانیتور منطقی پیکربندی‌شده فعلی با مقدار SCALE. این مقیاس باید توسط تمام مانیتورها و حالت‌های پیکربندی‌شده آن‌ها پشتیبانی شود.

--transform TRANSFORM, -t TRANSFORM

تبدیل هندسی مانیتورهای درون مانیتور منطقی پیکربندی‌شده فعلی با استفاده از TRANSFORM. تبدیل‌های مجاز عبارتند از: normal، 90، 180، 270، flipped، flipped-90، flipped-270 و flipped-180.

--x X, -x X

تنظیم موقعیت X برای مانیتور منطقی فعلی.

--y Y, -y Y موقعیت Y

تنظیم موقعیت Y برای مانیتور منطقی فعلی.

--right-of CONNECTOR

قرار دادن مانیتور منطقی در سمت راست مانیتور منطقی‌ای که CONNECTOR به آن تعلق دارد.

--left-of CONNECTOR قرار دادن در سمت چپ مانیتور دیگر

قرار دادن مانیتور منطقی در سمت چپ مانیتور منطقی‌ای که CONNECTOR به آن تعلق دارد.

--above CONNECTOR

قرار دادن مانیتور منطقی در بالای مانیتور منطقی‌ای که CONNECTOR به آن تعلق دارد.

--below CONNECTOR

قرار دادن مانیتور منطقی در پایین مانیتور منطقی‌ای که CONNECTOR به آن تعلق دارد.

--mode MODE, -m MODE

تنظیم حالت مانیتور.

--color-mode COLOR-MODE, -c COLOR-MODE

تنظیم حالت رنگ مانیتور. حالت‌های رنگی موجود شامل default، sdr-native و bt2100 هستند.

--rgb-range RGB-RANGE, -r RGB-RANGE

تنظیم محدوده کوانتیزاسیون RGB مانیتور. محدوده‌های موجود عبارتند از auto، full و limited (۱۶:۲۳۵).

--monitor CONNECTOR, -M CONNECTOR

تغییر ترجیحات مانیتور. به بخش «گزینه‌های ترجیحات مانیتور» مراجعه کنید.

--luminance LUMINANCE, -l LUMINANCE

تنظیم روشنایی (درخشندگی) مانیتور برای حالت رنگ فعلی.

--reset-luminance

بازنشانی روشنایی مانیتور برای حالت رنگ فعلی به مقدار پیش‌فرض آن.

آینه‌کردن (Mirror) خروجی‌های DP-1 و eDP-1، و قرار دادن DP-2 با چرخش ۲۷۰ درجه در سمت راست دو مانیتور آینه‌شده.

gdctl set --logical-monitor
          --primary
          --monitor DP-1
          --monitor eDP-1
          --logical-monitor
          --monitor DP-2
          --right-of DP-1
          --transform 270

تنظیم eDP-1 و DP-2 به‌عنوان مانیتورهای در دسترس برای اجاره (lease).

gdctl set --logical-monitor
          --primary
          --monitor DP-1
          --for-lease-monitor eDP-1
          --for-lease-monitor DP-2

سامانهٔ پیگیری اشکالات با مراجعه به این وبگاه در دسترس است: https://gitlab.gnome.org/GNOME/mutter/-/issues. پیش از ارسال گزارش اشکال، لطفاً اطمینان حاصل کنید که از آخرین نسخهٔ gnome-shell استفاده می‌کنید. بسیاری از اشکالات (عمده و جزئی) در هر انتشار برطرف می‌شوند و اگر نسخهٔ شما قدیمی باشد، احتمال دارد مشکل از پیش حل شده باشد.

برای کسب اطلاعات بیشتر، از این وبگاه بازدید کنید: https://gitlab.gnome.org/GNOME/mutter/-/blob/main/README.md.