gdctl(1)                         User Commands                        gdctl(1)

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

خلاصه دستور (SYNOPSIS)
       gdctl [-h] COMMAND ...

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

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

دستورها (COMMANDS)
       show
          نمایش پیکربندی فعلی صفحه‌نمایش

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

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

گزینه‌های نمایش (SHOW OPTIONS)
       --help, -h
          نمایش پیام راهنما و خروج.

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

       --properties, -p
          فهرست کردن ویژگی‌ها.

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

گزینه‌های تنظیم (SET OPTIONS)
       --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).

گزینه‌های مانیتور منطقی (LOGICAL MONITOR OPTIONS)
       --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 به آن
          تعلق دارد.

گزینه‌های مانیتور (MONITOR OPTIONS)
       --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 (۱۶:۲۳۵).

گزینه‌های ترجیحات (PREFS OPTIONS)
       --monitor CONNECTOR, -M CONNECTOR
          تغییر ترجیحات مانیتور. به بخش «گزینه‌های ترجیحات مانیتور» مراجعه
          کنید.

گزینه‌های ترجیحات مانیتور (MONITOR PREFS OPTIONS)
       --luminance LUMINANCE, -l LUMINANCE
          تنظیم روشنایی (درخشندگی) مانیتور برای حالت رنگ فعلی.

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

مثال‌ها (EXAMPLES)
       آینه‌کردن (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

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

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

                                                                      gdctl(1)