ddcui(1)                    General Commands Manual                   ddcui(1)



نام (NAME)
       ddcui - واسط گرافیکی کاربر برای ddcutil

خلاصه دستور (SYNOPSIS)
       ddcui [options]





توضیحات (DESCRIPTION)
       برنامهٔ ddcui یک واسط گرافیکی کاربر برای کنترل‌پنل مجازی (VCP) نمایشگر
       فراهم می‌کند.  این برنامه از پروتکل DDC/CI بر روی گذرگاه I2C متصل به
       نمایشگر استفاده می‌کند.  به‌طور معمول، راه‌انداز ویدیو برای نمایشگر یک یا
       چند گذرگاه I2C را در قالب دستگاه‌هایی با نام /dev/i2c-n ارائه می‌دهد.

       ویژگی‌های کنترل‌پنل مجازی در مجموعه دستورهای کنترل نمایشگر (MCCS) تعریف
       شده‌اند.  نمایشگرها زیرمجموعه‌ای از این ویژگی‌ها را پیاده‌سازی می‌کنند.  هر
       ویژگی با یک تک‌بایت شناسایی می‌شود؛ برای نمونه، ویژگی x10 کنترل روشنایی
       (brightness) است.






گزینه‌ها (OPTIONS)
   گزینه‌هایی که تنظیمات اولیه را برای پنجرهٔ محاوره‌ای Feature Selection تغییر
       می‌دهند:
       --feature-set name
              مجموعه ویژگی اولیه برای نمایش.  مهم‌ترین آن‌ها عبارتند از: MCCS -
              تمام ویژگی‌های تعریف‌شده در MCCS، MANUFACTURER - ویژگی‌های واقع در
              محدودهٔ رزروشدهٔ سازنده xe0..xff، COLOR - ویژگی‌های مرتبط با رنگ.
              برای مشاهدهٔ فهرست کامل، از گزینهٔ --help استفاده کنید.  مگر در
              حالتی که --custom-feature-set مشخص شده باشد، پیش‌فرض MCCS است.

       --custom-feature-set (feature code..)
              مشخص کردن صریح ویژگی‌هایی که باید نمایش داده شوند.  ویژگی‌ها در
              فهرست کدهای ویژگی به صورت اعداد هگزادسیمال ۲ بایتی، با یا بدون
              «x» ابتدایی یا «h» انتهایی مشخص می‌شوند. برای تعیین بیش از یک
              ویژگی، کدهای ویژگی را با ویرگول یا فاصله از هم جدا کرده و کل
              فهرست را درون علامت نقل‌قول قرار دهید. برای مثال:
              --custom-feature-set "10 x12 14h"

       --only-capabilities
              محدود کردن ویژگی‌ها به مواردی که در رشتهٔ قابلیت‌ها (capabilities
              string) قرار دارند.  زمانی اعمال می‌شود که مجموعه ویژگی MCCS،
              COLOR یا MANUFACTURER باشد.

       --all-capabilities
              همیشه ویژگی‌های یافت‌شده در رشتهٔ قابلیت‌ها را شامل شود.  زمانی
              اعمال می‌شود که مجموعه ویژگی MCCS باشد.

       --show-unsupported
              نمایش ویژگی‌های پشتیبانی‌نشده در مجموعه ویژگی. به‌طور معمول
              ویژگی‌های پشتیبانی‌نشده نشان داده نمی‌شوند.


   گزینه‌ای که تنظیمات اولیه را برای پنجرهٔ محاوره‌ای NC Values Source تغییر
       می‌دهد:
       --nc-values-source MCCS|CAPABILITIES|BOTH
              منبع مقادیر نمایش‌یافته در منوی بازشو برای ویژگی‌های سادهٔ
              غیرپیوسته (Non-Continuous).

       --use-latest-nc-values
              همیشه از مقادیر آخرین نگارش MCCS استفاده شود


   گزینه برای انتخاب نمایشگر اولیه:
       --model model-name
              نام مدل، همان‌طور که در EDID نمایشگر مشخص شده و در نوار ابزار
              نشان داده می‌شود.


   گزینه‌های متفرقه:
       --styles
              فهرست کردن سبک‌های (styles) موجود Qt

       --style style-name
              انتخاب سبک Qt مورد استفاده

       --version, -v
              گزارش اطلاعات نگارش

       --help دریافت راهنمای خط فرمان.


   گزینه‌هایی که به کتابخانهٔ اشتراکی ddcutil ارسال می‌شوند:
       این موارد با گزینه‌های خط فرمان هم‌نام در ddcutil متناظر هستند.

       --ddc  گزارش خطاهای پروتکل DDC و داده در پایانه.

       --trace trace-group-name
              ردیابی تمام توابع درون یک گروه ردیابی (trace group).  می‌تواند
              بیش از یک‌بار مشخص شود.

       --trcfile simple-file-name
              ردیابی تمام توابع قابل ردیابی در یک فایل.  می‌تواند بیش از یک‌بار
              مشخص شود.

       --trcfunc function name
              ردیابی یک تابع تکی.  می‌تواند بیش از یک‌بار مشخص شود.

       --timestamp | --ts
              افزودن برچسب زمان (timestamp) به ابتدای پیام‌های ردیابی

       --thread-id | --tid
              افزودن شناسهٔ ریسه (thread id) به ابتدای پیام‌های ردیابی



وضعیت خروج (EXIT STATUS)
       در حالت عادی مقدار 0 را برمی‌گرداند؛ در صورت بروز شکست، مقدار 1
       بازگردانده می‌شود.

       استفاده از گزینهٔ --help موفقیت‌آمیز تلقی می‌شود.



همچنین ببینید (SEE ALSO)
       ddcutil(1)

       صفحهٔ خانگی پروژه: <http://www.ddcutil.com> مستندات عمومی ddcui:
              <http://www.ddcutil.com/ddcui_main>
       برای مستندات تفصیلی گزینه‌های خط فرمان:
              <http://www.ddcutil.com/ddcui_options>



نویسندگان (AUTHORS)
       Sanford Rockowitz (rockowitz at minsoft dot com)
       Copyright 2019-2020 Sanford Rockowitz

                                 13 June 2020                         ddcui(1)