نام (NAME)

waybar-image - ماژول تصویر (image module) در waybar

توضیحات (DESCRIPTION)

ماژول image یک تصویر را از یک مسیر مشخص نمایش می‌دهد.

پیکربندی (CONFIGURATION)

path:
نوع: رشته (string)
مسیر فایل تصویر.

exec:
نوع: رشته (string)
مسیر اسکریپتی که باید مسیر فایل تصویر را برگرداند.
فقط در صورتی اجرا می‌شود که path مقداردهی نشده باشد.

size:
نوع: عدد صحیح (integer)
عرض/ارتفاع برای رندر تصویر.

interval:
نوع: عدد صحیح یا اعشاری (integer or float)
بازه زمانی (به ثانیه) برای رندر مجدد تصویر.
حداقل مقدار 0.001 (۱ میلی‌ثانیه) است. مقادیر کمتر از ۱ میلی‌ثانیه روی ۱ میلی‌ثانیه تنظیم خواهند شد.
زمانی که محتویات path تغییر می‌کند مفید است.
اگر هیچ interval مشخص نشود، تصویر فقط یک بار رندر خواهد شد.

signal:
نوع: عدد صحیح (integer)
شماره سیگنال مورد استفاده برای به‌روزرسانی ماژول.
اگر فایل به‌طور نامنظم تغییر کند، می‌تواند به جای interval استفاده شود.
عدد بین ۱ و N معتبر است، جایی که SIGRTMIN+N = SIGRTMAX باشد.

on-click:
نوع: رشته (string)
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.

on-click-middle:
نوع: رشته (string)
دستوری که هنگام کلیک وسط (با چرخ ماوس) روی ماژول اجرا می‌شود.

on-update:
نوع: رشته (string)
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.

on-scroll-up:
نوع: رشته (string)
دستوری که هنگام پیمایش به بالا روی ماژول اجرا می‌شود.

on-scroll-down:
نوع: رشته (string)
دستوری که هنگام پیمایش به پایین روی ماژول اجرا می‌شود.

smooth-scrolling-threshold:
نوع: عدد اعشاری (double)
آستانه‌ای که هنگام پیمایش استفاده می‌شود.

tooltip:
نوع: بولی (bool)
پیش‌فرض: true
گزینه‌ای برای فعال‌سازی تولتیپ (tooltip) هنگام نگه داشتن ماوس روی آن.

expand:
نوع: بولی (bool)
پیش‌فرض: false
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به صورت پویا مصرف کند.

خروجی اسکریپت (SCRIPT OUTPUT)

مشابه ماژول custom، مقادیر خروجی اسکریپت با خط جدید (newline) از یکدیگر جدا می‌شوند. قالب خروجی به شکل زیر است:

$path\n$tooltip

مثال‌ها (EXAMPLES)

"image#album-art": {
	"path": "/tmp/mpd_art",
	"size": 32,
	"interval": 5,
	"on-click": "mpc toggle"
}

استایل (STYLE)

• #image
• #image.empty