| 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)
صفحهٔ خانگی پروژه: 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 |