.\" 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\-image" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول تصویر (image module)
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول
\fBimage\fR
یک تصویر را از یک مسیر مشخص نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
\fBpath\fR:
.br
نوع: رشته (string)
.br
مسیر فایل تصویر.\&
.PP
\fBexec\fR:
.br
نوع: رشته (string)
.br
مسیر اسکریپتی که باید مسیر فایل تصویر را برگرداند.\&
.br
فقط در صورتی اجرا می‌شود که path مقداردهی نشده باشد.
.PP
\fBsize\fR:
.br
نوع: عدد صحیح (integer)
.br
عرض/ارتفاع برای رندر تصویر.\&
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح یا اعشاری (integer or float)
.br
بازه زمانی (به ثانیه) برای رندر مجدد تصویر.\&
.br
حداقل مقدار 0.\&001 (۱ میلی‌ثانیه) است.\& مقادیر کمتر از ۱ میلی‌ثانیه روی ۱ میلی‌ثانیه تنظیم خواهند شد.\&
.br
زمانی که محتویات \fBpath\fR تغییر می‌کند مفید است.\&
.br
اگر هیچ \fBinterval\fR مشخص نشود، تصویر فقط یک بار رندر خواهد شد.\&
.PP
\fBsignal\fR:
.br
نوع: عدد صحیح (integer)
.br
شماره سیگنال مورد استفاده برای به‌روزرسانی ماژول.\&
.br
اگر فایل به‌طور نامنظم تغییر کند، می‌تواند به جای \fBinterval\fR استفاده شود.\&
.br
عدد بین ۱ و N معتبر است، جایی که \fBSIGRTMIN+N\fR = \fBSIGRTMAX\fR باشد.\&
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\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)
.br
دستوری که هنگام پیمایش به پایین روی ماژول اجرا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: عدد اعشاری دقیق (double)
.br
آستانه‌ای که هنگام پیمایش استفاده می‌شود.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
گزینه‌ای برای فعال‌سازی تولتیپ هنگام نگه داشتن ماوس روی آن.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به صورت پویا مصرف کند.\&
.PP
.SH "خروجی اسکریپت (SCRIPT OUTPUT)"
.PP
مشابه ماژول \fBcustom\fR، مقادیر خروجی اسکریپت با \fBخط جدید (newline)\fR از یکدیگر جدا می‌شوند.\&
قالب خروجی به شکل زیر است:
.PP
.nf
.RS 4
$path\n$tooltip
.fi
.RE
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"image#album\-art": {
	"path": "/tmp/mpd_art",
	"size": 32,
	"interval": 5,
	"on\-click": "mpc toggle"
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#image\fR
.IP \(bu 4
\fB#image.\&empty\fR