.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "feedback-themes" "" "" ""
.SH "نام (NAME)"
feedback-themes \- قالب پوسته‌ها و بازخوردهای حسی/صوتی feedbackd
.SH "توضیحات (DESCRIPTION)"
.sp
بازخورد ارائه‌شده به کاربر برای هر رویداد، توسط پوستهٔ بازخورد فعال تعیین می‌شود.
.sp
هر پوسته از حداکثر سه بخش نمایه به نام‌های \fIfull\fP،
\fIquiet\fP و \fIsilent\fP تشکیل شده است که حاوی نام رویدادها و بازخوردهای مرتبط با آن‌ها است. آن‌ها می‌توانند از طریق عنصر \fIparent\-name\fP
به پوستهٔ دیگری ارجاع دهند تا از تکرار جلوگیری شود. اگر رویدادی که توسط دیمن دریافت می‌شود در پوستهٔ فعال یا پوستهٔ والد آن موجود نباشد،
نادیده گرفته خواهد شد.
.sp
هر رویداد در هر نمایه به حداکثر یک بازخورد نگاشت می‌شود. نام‌گذاری رویدادها در پوسته طبق
سند مشخصات نام‌گذاری رویدادها (Event Naming Specification) انجام می‌شود:
\%<https://\:gitlab\:.freedesktop\:.org/\:agx/\:feedbackd/\:-/\:blob/\:main/\:doc/\:Event-naming-spec-0\:.0\:.0\:.md>\&.
.sp
دو نوع پوسته وجود دارد: پوسته‌های سفارشی (\fIcustom\fP) و پوسته‌های دستگاه (\fIdevice\fP).
هر دو از قالبی یکسان استفاده می‌کنند اما اهداف متفاوتی دارند. پوسته‌های سفارشی برای تنظیم خروجی feedbackd متناسب با نیازهای کاربر در نظر گرفته شده‌اند، در حالی که پوسته‌های دستگاه برای تطبیق با تفاوت‌های سخت‌افزاری به کار می‌روند. پوسته‌های بازخورد از قالبی بر پایهٔ JSON استفاده می‌کنند که می‌توان آن را با
\fBfbd\-theme\-validate(1)\fP اعتبارسنجی کرد.
.sp
برای جزئیات بیشتر در مورد نحوه ایجاد یا ویرایش پوسته‌های بازخورد، مستندات feedbackd را در نشانی زیر ببینید:
\%<https://\:gitlab\:.freedesktop\:.org/\:agx/\:feedbackd#\:feedback-theme>\&.
.SH "انواع بازخورد (Feedback types)"
.sp
برای ساخت یک پوسته می‌توانید از چندین نوع بازخورد مختلف استفاده کنید:
.INDENT 0.0
.IP \(bu 2
\fISound\fP: پخش صدایی از پوستهٔ صوتی نصب‌شده
.IP \(bu 2
\fIVibraRumble\fP: یک لرزش منفرد با استفاده از موتور بازخورد لمسی (haptic)
.IP \(bu 2
\fIVibraPeriodic\fP: یک لرزش دوره‌ای با استفاده از موتور بازخورد لمسی
.IP \(bu 2
\fIVibraPattern\fP: الگویی مشخص‌کننده برای نحوه لرزش موتور بازخورد لمسی
.IP \(bu 2
\fILed\fP: چشمک‌زدن نشانگر LED با یک الگوی دوره‌ای
.UNINDENT
.SS "بازخورد صوتی (Sound feedback)"
.sp
بازخوردهای صوتی نام یک رویداد را از پوستهٔ صوتی XDG مشخص می‌کنند. پوسته‌های صوتی در \fBمشخصات پوسته صوتی\fP در نشانی زیر شرح داده شده‌اند:
\%<https://\:freedesktop\:.org/\:wiki/\:Specifications/\:sound-theme-spec>
.INDENT 0.0
.IP \(bu 2
\fIevent\-name\fP: نام رویداد صوتی مورد استفاده.
.IP \(bu 2
\fImedia\-role\fP: نقش رسانه‌ای برای جریان صوتی پخش‌شده. پیش‌فرض \fIevent\fP است.
.UNINDENT
.sp
بازخورد \fISound\fP معمولاً فقط در بخش نمایهٔ \fIfull\fP در پوسته استفاده می‌شود.
.SS "بازخورد لرزش منفرد (VibraRumble feedback)"
.sp
بازخورد \fIVibraRumble\fP از این ویژگی‌ها استفاده می‌کند:
.INDENT 0.0
.IP \(bu 2
\fIcount\fP: تعداد دفعات لرزش.
.IP \(bu 2
\fIpause\fP: مکث بین هر لرزش بر حسب میلی‌ثانیه.
.IP \(bu 2
\fIduration\fP: مدت‌زمان لرزش بر حسب میلی‌ثانیه.
.IP \(bu 2
\fImangitude\fP: شدت و بزرگی نسبی لرزش (\fB[0, 1]\fP).
.UNINDENT
.sp
بازخورد \fIVibraRumble\fP معمولاً فقط در بخش نمایهٔ \fIquiet\fP در پوسته استفاده می‌شود.
.SS "بازخورد الگوی لرزش (VibraPattern feedback)"
.sp
بازخورد \fIVibraPattern\fP دارای این ویژگی‌ها است:
.INDENT 0.0
.IP \(bu 2
\fImagnitudes\fP: شدت و بزرگی نسبی هر لرزش \fB[0, 1]\fP به صورت آرایه‌ای از اعداد اعشاری (doubles).
.IP \(bu 2
\fIdurations\fP: مدت‌زمان هر لرزش بر حسب میلی‌ثانیه به صورت آرایه‌ای از اعداد صحیح بدون علامت (unsigned integers).
.UNINDENT
.sp
هر دو آرایه باید دارای طول یکسانی باشند. بازخورد \fIVibraPattern\fP معمولاً فقط در بخش نمایهٔ \fIquiet\fP در پوسته استفاده می‌شود.
.SS "بازخورد ال‌ای‌دی (Led feedback)"
.sp
نوع بازخورد \fILed\fP از دو ویژگی برای تعیین نحوه چشمک‌زدن LED استفاده می‌کند:
.INDENT 0.0
.IP \(bu 2
\fIcolor\fP: رنگی را مشخص می‌کند که LED باید با آن چشمک بزند. این ویژگی از نام‌های رنگ ثابت \fIred\fP،
\fIgreen\fP، \fIblue\fP و \fIwhite\fP و همچنین مقادیر در قالب RGB HEX (\fI#RRGGBB\fP) پشتیبانی می‌کند که در آن
\fIRR\fP، \fIGG\fP و \fIBB\fP مقادیر شانزده‌شانزدهی دو رقمی بین \fI00\fP و \fIFF\fP هستند و مقدار
هر مؤلفه را تعیین می‌کنند؛ به عنوان مثال \fI#00FFFF\fP معادل رنگ فیروزه‌ای است.
.IP \(bu 2
\fIfrequency\fP: فرکانس چشمک‌زدن LED بر حسب میلی‌هرتز (mHz).
.UNINDENT
.sp
بازخورد \fILed\fP معمولاً فقط در بخش نمایهٔ \fIsilent\fP در پوسته استفاده می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBfeedbackd(8)\fP \fBfbcli(1)\fP \fBfbd\-theme\-validate(1)\fP
.\" End of generated man page.