نام (NAME)

wpaperd-output - قالب مورد استفاده wpaperd برای تعریف نمایشگرهای مختلف

توضیحات (DESCRIPTION)

فایل پیکربندی wpaperd شامل اطلاعات مربوط به هر نمایشگر، تصویر پس‌زمینه متناظر و تنظیمات آن است. این فایل در مسیر XDG_CONFIG_HOME/wpaperd/config.toml (که به طور پیش‌فرض $HOME/.config/wpaperd/config.toml است) قرار دارد.

نحو (SYNTAX)

این فایل یک پیکربندی ساده به زبان TOML است که به بخش‌هایی تقسیم شده، هر بخش برای یک نمایشگر.

بخش‌ها (SECTION)

هر بخش بر اساس شناسه نمایشگر نام‌گذاری می‌شود. اگر از sway استفاده می‌کنید، می‌توانید شناسه خروجی را با اجرای دستور زیر بیابید:

$ swaymsg -t get_outputs

در هایپرلند (Hyprland) می‌توانید این کار را با دستور زیر انجام دهید:

$ hyprctl monitors

فایل پیکربندی برای wpaperd در `XDG_CONFIG_HOME/wpaperd/config.toml` (که به صورت پیش‌فرض `~/.config/wpaperd/config.toml` است) قرار دارد. هر بخش بیانگر یک نمایشگر متفاوت است و می‌تواند کلیدهای زیر را شامل شود:

`path`، مسیر فایل تصویر برای استفاده به عنوان تصویر پس‌زمینه یا پوشه‌ای برای انتخاب تصویر پس‌زمینه از آن
`duration`، مدت زمانی که تصویر باید نمایش داده شود تا با تصویر جدید جایگزین گردد. از قالبی خوانا برای انسان جهت تعیین مدت زمان (مانند `30s` یا `10m`) پشتیبانی می‌کند که در [اینجا](https://docs.rs/humantime/latest/humantime/fn.parse_duration.html) شرح داده شده است. این گزینه فقط زمانی معتبر است که path به یک پوشه اشاره کند. (اختیاری)
`sorting`، انتخاب ترتیب مرتب‌سازی. گزینه‌های معتبر عبارتند از `ascending`، `descending` و `random`، که مقدار پیش‌فرض `random` است. این گزینه فقط زمانی معتبر است که path به یک پوشه اشاره کند. (اختیاری)
`mode`، نحوه نمایش تصویر پس‌زمینه زمانی که اندازه آن با وضوح نمایشگر متفاوت است: - `fit` کل تصویر را با گوشه‌های سیاه برای پوشاندن فضای خالی باقی‌مانده نمایش می‌دهد - `center` تصویر را در مرکز صفحه قرار می‌دهد و لبه‌هایی از تصویر که جا نشده‌اند را حذف می‌کند - `stretch` کل تصویر را با کشیدن آن برای پر کردن کل صفحه بدون باقی گذاشتن لبه‌های سیاه نمایش می‌دهد (نسبت ابعاد تغییر می‌کند) - `tile` تصویر را چندین بار به صورت افقی و عمودی تکرار می‌کند تا صفحه پر شود
`transition_time`، مدت زمان اجرای گذار (انیمیشن تغییر) بر حسب میلی‌ثانیه. (اختیاری، پیش‌فرض `300`).
`queue_size`، تعیین اندازه صف زمانی که `path` روی یک پوشه تنظیم شده و `sorting` روی `random` باشد. (اختیاری، پیش‌فرض `10`)
`initial_transition`، تعیین این‌که گذار از صفحه سیاه اولیه انجام شود یا خیر (اختیاری، پیش‌فرض `true`)

بخش پیش‌فرض (DEFAULT SECTION)

بخش "default" به عنوان پایه برای تمام پیکربندی‌های نمایشگرها استفاده می‌شود؛ بخش "any" برای همه نمایشگرهایی که به صراحت فهرست نشده‌اند به کار می‌رود. این امر امکان داشتن پیکربندی انعطاف‌پذیر را بدون تکرار تنظیمات فراهم می‌کند. ابزار wpaperd پیکربندی را در هنگام شروع و هر بار که تغییر می‌کند بررسی کرده و در صورت نادرست بودن راهنمایی ارائه می‌دهد.

مثال (EXAMPLE)

ساده‌ترین پیکربندی به این شکل است:

[DP-3]
path = "/home/danyspin97/github_octupus.png"
[DP-4]
path = "/home/danyspin97/Wallpapers"
duration = "30m"

پیکربندی پیچیده‌تر نیز امکان‌پذیر است:

[default]
duration = "30m"
mode = "center"
sorting = "ascending"
[any]
path = "/home/danyspin97/default_wallpaper.png"
[DP-3]
path = "/home/danyspin97/Wallpapers"

نویسنده (AUTHOR)

نگهداری‌شده توسط Danilo Spinella <danilo.spinella@suse.com>.