.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "waybar\-backlight" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-backlight \- ماژول روشنایی صفحه (backlight) در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBbacklight\fR میزان روشنایی فعلی نور پس‌زمینه را نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 2
.br
بازه زمانی که اطلاعات در آن بازخوانی (poll) می‌شود.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {percent}%
.br
قالب نحوه نمایش اطلاعات.\& داده‌ها به جای {} درج می‌شوند.\&
.PP
\fBmax\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول به کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداقل طول به کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
نوع: ممیز شناور (float)
.br
تراز برچسب در داخل ماژول، که در آن 0 تراز چپ و 1 تراز راست است.\& اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.\&
.PP
\fBjustify\fR:
.br
نوع: رشته (string)
.br
تراز متن درون برچسب ماژول، با گزینه‌های '\&left'\&، '\&right'\& یا '\&center'\& برای تعیین موقعیت.\&
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBstates\fR:
.br
نوع: شیء (object)
.br
تعدادی از وضعیت‌های نور پس‌زمینه که در سطوح روشنایی مشخصی فعال می‌شوند.\& \fBwaybar\-states(5)\fR را ببینید.\&
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک میانی با چرخ ماوس روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام راست‌کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-update\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-up\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به بالا روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل روشنایی خواهد شد.\&
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.RS 4
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می‌شود.\& این دستور جایگزین رفتار پیش‌فرض کنترل روشنایی خواهد شد.\&
.PP
.RE
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: ممیز شناور دوگانه (double)
.RS 4
آستانه‌ای که هنگام اسکرول کردن استفاده می‌شود.\&
.PP
.RE
\fBreverse\-scrolling\fR:
.br
نوع: بولی (bool)
.br
گزینه‌ای برای معکوس کردن جهت اسکرول.\&
.PP
\fBscroll\-step\fR:
.br
نوع: ممیز شناور (float)
.br
پیش‌فرض: 1.\&0
.br
سرعت تغییر روشنایی هنگام اسکرول کردن.\&
.PP
\fBmin\-brightness\fR:
.br
نوع: ممیز شناور دوگانه (double)
.br
پیش‌فرض: 0.\&0
.br
حداقل میزان روشنایی نور پس‌زمینه.\&
.PP
\fBmenu\fR:
.br
نوع: رشته (string)
.br
عملی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR:
.br
نوع: رشته (string)
.br
مسیر پرونده توصیف‌گر منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR در آن وجود داشته باشد.
.PP
.RE
\fBmenu\-actions\fR:
.br
نوع: آرایه (array)
.br
عملیات متناظر با دکمه‌های منو.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.\&
.PP
.SH "مثال (EXAMPLE)"
.PP
.nf
.RS 4
"backlight": {
	"device": "intel_backlight",
	"format": "{percent}% {icon}",
	"format\-icons": ["", ""]
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#backlight\fR