.\" 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\-cpu" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-cpu \- ماژول پردازنده (cpu) در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBcpu\fR میزان استفاده کنونی پردازنده (CPU) را نمایش می\zwnjدهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح یا ممیز شناور (integer or float)
.br
پیش\zwnjفرض: 10
.br
بازه زمانی برای دریافت دوره\zwnjای اطلاعات (poll).\&
.br
حداقل مقدار 0.\&001 (یک میلی\zwnjثانیه) است. مقادیر کمتر از 1ms به 1ms تنظیم خواهند شد.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش\zwnjفرض: {usage}%
.br
قالب نمایش اطلاعات. داده\zwnjها در جای {} درج می\zwnjشوند.\&
.PP
\fBformat\-icons\fR:
.br
نوع: آرایه/شیء (array/object)
.br
بر اساس میزان استفاده فعلی، آیکون مربوطه انتخاب می\zwnjشود.\&
.br
ترتیب از \fBlow\fR (کم) به \fBhigh\fR (زیاد) است، یا بر اساس وضعیت در صورتی که شیء باشد.\&
.PP
\fBmax\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول کاراکتری که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداقل طول کاراکتری که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
نوع: ممیز شناور (float)
.br
تراز برچسب درون ماژول، که در آن 0 چپ\zwnjچین و 1 راست\zwnjچین است. اگر ماژول چرخانده شود، از جهت متن پیروی می\zwnjکند.\&
.PP
\fBjustify\fR:
.br
نوع: رشته (string)
.br
تراز متن درون برچسب ماژول، که گزینه\zwnjهای '\&left'\& (چپ)، '\&right'\& (راست) یا '\&center'\& (وسط) را برای تعیین موقعیت می\zwnjپذیرد.\&
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت برای چرخاندن برچسب متنی (در گام\zwnjهای ۹۰ درجه).\&
.PP
\fBstates\fR:
.br
نوع: شیء (object)
.br
تعدادی از وضعیت\zwnjهای استفاده از CPU که در سطوح خاصی از مصرف فعال می\zwnjشوند. به \fBwaybar\-states(5)\fR مراجعه کنید.\&
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک روی ماژول اجرا می\zwnjشود.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک میانی با چرخ ماوس روی ماژول اجرا می\zwnjشود.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام راست\zwnjکلیک روی ماژول اجرا می\zwnjشود.\&
.PP
\fBon\-update\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام به\zwnjروزرسانی ماژول اجرا می\zwnjشود.\&
.PP
\fBon\-scroll\-up\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به بالا روی ماژول اجرا می\zwnjشود.\&
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می\zwnjشود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: ممیز شناور با دقت مضاعف (double)
.br
آستانه مورد استفاده هنگام اسکرول.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش\zwnjفرض: true
.br
گزینه\zwnjای برای غیرفعال کردن راهنمای شناور (tooltip) در هنگام نگه داشتن ماوس.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش\zwnjفرض: false
.br
امکان مصرف پویای تمامی فضای باقی\zwnjمانده توسط این ماژول را فعال می\zwnjکند.\&
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
\fB{load}\fR: بار کنونی پردازنده (CPU load).\&
.PP
\fB{usage}\fR: درصد استفاده کلی کنونی پردازنده.\&
.PP
\fB{usage\fR{n}\fB}\fR: میزان استفاده کنونی هسته پردازنده n. هسته\zwnjها از صفر شماره\zwnjگذاری می\zwnjشوند، بنابراین هسته اول {usage0} و هسته چهارم {usage3} خواهد بود.\&
.PP
\fB{avg_frequency}\fR: فرکانس میانگین کنونی پردازنده (بر پایه تمامی هسته\zwnjها) بر حسب گیگاهرتز (GHz).\&
.PP
\fB{max_frequency}\fR: حداکثر فرکانس کنونی پردازنده (بر پایه هسته دارای بالاترین فرکانس) بر حسب گیگاهرتز (GHz).\&
.PP
\fB{min_frequency}\fR: حداقل فرکانس کنونی پردازنده (بر پایه هسته دارای کمترین فرکانس) بر حسب گیگاهرتز (GHz).\&
.PP
\fB{icon}\fR: آیکون میزان استفاده کلی پردازنده.\&
.PP
\fB{icon\fR{n}\fB}\fR: آیکون میزان استفاده هسته پردازنده n. استفاده مانند {icon0}.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
پیکربندی پایه:
.PP
.nf
.RS 4
"cpu": {
	"interval": 10,
	"format": "{}% ",
	"max\-length": 10
}
.fi
.RE
.PP
میزان استفاده پردازنده به ازای هر هسته رندر شده به\zwnjصورت آیکون:
.PP
.nf
.RS 4
"cpu": {
	"interval": 1,
	"format": "{icon0}{icon1}{icon2}{icon3} {usage:>2}% ",
	"format\-icons": ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"],
},
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#cpu\fR