.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH ddcui 1 "13 June 2020"
.\" Please adjust this date whenever revising the manpage.
.\"

.SH "نام (NAME)"
ddcui \- واسط گرافیکی کاربر برای ddcutil
.SH "خلاصه دستور (SYNOPSIS)"
\fBddcui\fP [\fIoptions\fP]


.\" ALT USING .SY .OP
.\" .SY
.\" .OP \-abcde
.\" .OP \-b busno
.\" .OP \-d|--display dispno
.\" command command-arguments
.\" .YS


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

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

.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.


.\" .B ddcutil
.\" .I command 
.\" .R [
.\" .I command-arguments
.\" .R ] [
.\" .I options
.\" .R ]


.SH "گزینه‌ها (OPTIONS)"
.PP
.SS گزینه‌هایی که تنظیمات اولیه را برای پنجرهٔ محاوره‌ای \fIFeature Selection\fP تغییر می‌دهند:
.PP
.TQ
.BI "--feature-set " "name" 
مجموعه ویژگی اولیه برای نمایش.
مهم‌ترین آن‌ها عبارتند از: \fIMCCS\fP \- تمام ویژگی‌های تعریف‌شده در MCCS،
\fIMANUFACTURER\fP \- ویژگی‌های واقع در محدودهٔ رزروشدهٔ سازنده xe0..xff،
\fICOLOR\fP \- ویژگی‌های مرتبط با رنگ. برای مشاهدهٔ فهرست کامل، از
گزینهٔ \fB--help\fP استفاده کنید.
مگر در حالتی که \fB--custom-feature-set\fP مشخص شده باشد، پیش‌فرض \fIMCCS\fP است.

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

.TQ
.B "--only-capabilities"
محدود کردن ویژگی‌ها به مواردی که در رشتهٔ قابلیت‌ها (capabilities string) قرار دارند.
زمانی اعمال می‌شود که مجموعه ویژگی \fIMCCS\fP، \fICOLOR\fP یا \fIMANUFACTURER\fP باشد.

.TQ
.B "--all-capabilities"
همیشه ویژگی‌های یافت‌شده در رشتهٔ قابلیت‌ها را شامل شود.
زمانی اعمال می‌شود که مجموعه ویژگی \fIMCCS\fP باشد.

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

.PP
.SS گزینه‌ای که تنظیمات اولیه را برای پنجرهٔ محاوره‌ای \fINC Values Source\fP تغییر می‌دهد:

.TQ
.BI "--nc-values-source " "MCCS|CAPABILITIES|BOTH"
منبع مقادیر نمایش‌یافته در منوی بازشو برای ویژگی‌های سادهٔ غیرپیوسته (Non-Continuous).

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

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

.SS
گزینه‌های متفرقه:

.TQ
.B "--styles"
فهرست کردن سبک‌های (styles) موجود Qt

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

.TQ
.B "--version, -v"
گزارش اطلاعات نگارش

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

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

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

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

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

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

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

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


.SH "وضعیت خروج (EXIT STATUS)"

در حالت عادی مقدار 0 را برمی‌گرداند؛ در صورت بروز شکست، مقدار 1 بازگردانده می‌شود.

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


.SH "همچنین ببینید (SEE ALSO)"
.BR ddcutil (1)
.PP
صفحهٔ خانگی پروژه: 
.UR http://www.ddcutil.com
.UE
.TQ
مستندات عمومی \fBddcui\fP:
.UR http://www.ddcutil.com/ddcui_main
.UE
.TQ
برای مستندات تفصیلی گزینه‌های خط فرمان: 
.UR http://www.ddcutil.com/ddcui_options
.UE 


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