awww-img(1) General Commands Manual awww-img(1)

awww-img - ارسال تصویر به دیمن awww برای نمایش به عنوان تصویر زمینه

awww img [گزینه‌ها] <path/to/img>

-a,--all

ارسال این دستور به تمامی فضاهای نام (namespaces) فعال awww-daemon.

-f, --filter <FILTER>

فیلتر مورد استفاده هنگام تغییر مقیاس تصویرها

گزینه‌های در دسترس عبارتند از:

Nearest | Bilinear | CatmullRom | Mitchell | Lanczos3

این موارد توسط کریت fast_image_resize ارائه می‌شوند (https://docs.rs/fast_image_resize/2.5.0/fast_image_resize). گزینه Nearest برای کارهای پیکسلی (pixel art) و صرفاً برای پیکسلی پیشنهاد می‌شود. همچنین سریع‌ترین فیلتر است.

برای موارد غیر پیکسلی، معمولاً یکی از سه مورد آخر توصیه می‌شود، هرچند برای تعیین بهترین گزینه مورد نظرتان، کمی آزمایش لازم خواهد بود.

توجه داشته باشید که می‌توانید پرچم --no-resize را نیز (که در ادامه توضیح داده شده) ارسال کنید. در این حالت، پرچم --filter هیچ تأثیری نخواهد داشت.

پیش‌فرض Lanczos3 است.

-n,--namespace <namespace>

مشخص می‌کند که این دستور به کدام فضای نام وی‌لند ارسال شود.

می‌توانید این گزینه را چندین بار مشخص کنید تا دستورات به چندین فضای نام به‌طور هم‌زمان ارسال شوند: awww img -n <namespace1> -n <namespace 2>.

این گزینه بر روی نام سوکت awww-daemon که برای ارتباط استفاده می‌کنیم تأثیر می‌گذارد. به طور خاص، نام سوکت ما ${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket است.

برخی از کامپوزیتورها می‌توانند چندین تصویر زمینه مختلف به ازای هر خروجی داشته باشند. این گزینه امکان تفکیک بین آن‌ها را فراهم می‌سازد. بیشتر کاربران احتمالاً نیازی به تنظیم این گزینه نخواهند داشت.

--no-resize

تغییر مقیاس تصویر انجام نشود. معادل با --resize no.

در صورت تنظیم، تصویر تغییر مقیاس نمی‌یابد و در مرکز صفحه قرار می‌گیرد. اگر کوچک‌تر از اندازه صفحه باشد، با مقدار --fill_color زیر پدینگ (فاصله) پر خواهد شد.

--resize <RESIZE>

آیا تصویر تغییر مقیاس داده شود و روش تغییر مقیاس آن چگونه باشد.

مقادیر ممکن:

  • no: عدم تغییر اندازه تصویر
  • crop: تغییر اندازه تصویر برای پر کردن کل صفحه، همراه با برش بخش‌های اضافی
  • fit: تغییر اندازه تصویر برای جا گرفتن در صفحه، با حفظ نسبت ابعاد اصلی
  • stretch: تغییر اندازه تصویر برای جا گرفتن در صفحه، بدون حفظ نسبت ابعاد اصلی

پیش‌فرض crop است.

--crop-gravity <CROP_GRAVITY>

مشخص کردن بخشی از تصویر برای لنگر انداختن هنگام برش. فقط زمانی استفاده می‌شود که `--resize crop` مشخص شده باشد.

مقادیر ممکن:

  • center: برش یکسان بالا و پایین، و چپ و راست تصویر.
  • top-left: برش پایین و راست تصویر.
  • top: برش پایین، و برش یکسان چپ و راست تصویر.
  • top-right: برش پایین و چپ تصویر.
  • left: برش راست، و برش یکسان بالا و پایین تصویر.
  • right: برش چپ، و برش یکسان بالا و پایین تصویر.
  • bottom-left: برش بالا و راست تصویر.
  • bottom: برش بالا، و برش یکسان چپ و راست تصویر.
  • bottom-right: برش بالا و چپ تصویر.

پیش‌فرض center است.

--fill-color <RRGGBB>

رنگی که برای پر کردن فاصله‌های خالی هنگام عدم تغییر مقیاس استفاده می‌شود.

پیش‌فرض 000000 است.

-o, --outputs

فهرست جداشده با کاما از خروجی‌هایی که تصویر در آن‌ها نمایش داده شود. از awww query برای اطلاع از خروجی‌های در حال استفاده استفاده کنید.

اگر تنظیم نشود، تصویر روی تمامی خروجی‌ها نمایش داده می‌شود.

-t, --transition-type <TRANSITION_TYPE>

[متغیر محیطی $AWWW_TRANSITION]

نوع گذار (انیمیشن تغییر تصویر) را تنظیم می‌کند. مقدار پیش‌فرض simple است که به آرامی در تصویر جدید محو می‌شود.

گذارهای ممکن عبارتند از:

none simple fade left right top bottom wipe wave grow center any outer random
گزینه none گذار را فوراً کامل می‌کند.

گزینه fade شبیه به simple است اما از منحنی‌های بزیه (bezier) برای محو شدن تصویر استفاده می‌کند؛ نسخه‌ای زیباتر از simple با آرتیفکت کمتر.

گزینه‌های left، right، top و bottom باعث می‌شوند گذار از آن موقعیت به سمت مخالف صفحه رخ دهد.

گزینه wipe مشابه left است اما به شما امکان می‌دهد زاویه گذار را با پرچم --transition-angle مشخص کنید.

گزینه wave مشابه wipe است اما خط جاروب به صورت موج‌دار حرکت می‌کند. می‌توانید میزان موج را با --transition-wave کنترل کنید.

گزینه grow باعث می‌شود یک دایره رو به رشد در سراسر صفحه منتقل شود و تغییر موقعیت مرکز دایره با پرچم --transition-pos امکان‌پذیر است.

گزینه center نام مستعاری برای grow با موقعیت تنظیم‌شده روی مرکز صفحه است.

گزینه any نام مستعاری برای grow با موقعیت تنظیم‌شده روی یک نقطه تصادفی روی صفحه است.

گزینه outer همانند grow است اما دایره به جای رشد کردن، کوچک می‌شود.

در نهایت، random یک افکت گذار را به صورت تصادفی انتخاب می‌کند.

--transition-step <0-255>

[متغیر محیطی $AWWW_TRANSITION_STEP]

سرعت نزدیک شدن گذار به تصویر جدید.

منطق گذار با افزودن یا کم کردن از مقادیر جاری rgb تا زمانی که تصویر قدیمی به تصویر جدید تبدیل شود عمل می‌کند. این پرچم مقدار اضافه یا کم شدن را کنترل می‌کند.

برای مثال، اگر پیکسل A برابر با 000010 باشد و بخواهیم به پیکسل B با مقدار 000020 تبدیل شود، اگر transition-step برابر ۲ باشد، در یک فریم پیکسل A به 000012، در فریم بعد به 000014 و به همین ترتیب تبدیل می‌شود.

مقادیر بزرگتر گذار را سریع‌تر اما ناگهانی‌تر می‌کنند. مقدار ۲۵۵ همیشه بلافاصله به تصویر جدید سوییچ می‌کند.

پیش‌فرض ۹۰ است. اگر transition-type برابر simple باشد، پیش‌فرض ۲ است.

--transition-duration <ثانیه (می‌تواند اعشاری باشد)>

[متغیر محیطی $AWWW_TRANSITION_DURATION]

مدت زمانی که طول می‌کشد تا گذار کامل شود، بر حسب ثانیه.

توجه داشته باشید که این گزینه با گذار simple کار نمی‌کند.

پیش‌فرض ۳ است.

--transition-fps <فریم در ثانیه (حداکثر ۲۵۵)>

[متغیر محیطی $AWWW_TRANSITION_FPS]

نرخ فریم برای افکت گذار.

توجه داشته باشید که تنظیم این مقدار روی عددی کمتر از پشتیبانی مانیتور بی‌فایده است.

همچنین این مورد با transition-step تفاوت دارد؛ آن پرچم مشخص می‌کند در هر فریم چه مقدار به تصویر جدید نزدیک شویم.

پیش‌فرض ۳۰ است.

--transition-angle <زاویه بر حسب درجه (به صورت ممیز شناور)>

[متغیر محیطی AWWW_TRANSITION_ANGLE]

این گزینه برای گذارهای wipe و wave استفاده می‌شود و زاویه پاک‌کردن را کنترل می‌کند.

توجه داشته باشید که زاویه بر حسب درجه است، جایی که '0' راست به چپ، '90' بالا به پایین، و '270' پایین به بالاست.

پیش‌فرض ۴۵ است.

--transition-pos <x,y>

[متغیر محیطی AWWW_TRANSITION_POS]

این گزینه فقط برای گذارهای grow و outer استفاده می‌شود و مرکز دایره را کنترل می‌کند (پیش‌فرض center است).

مقادیر موقعیت را می‌توان هم به درصد و هم بر حسب پیکسل مشخص کرد: مقادیر اعشاری به عنوان درصد و مقادیر صحیح به عنوان پیکسل تفسیر می‌شوند. برای مثال: 0.5,0.5 به معنی ۵۰٪ عرض و ۵۰٪ ارتفاع صفحه است، در حالی که 200,400 به معنی ۲۰۰ پیکسل از چپ و ۴۰۰ پیکسل از پایین است.

این مقدار می‌تواند یک نام مستعار نیز باشد که موقعیت را متناسب با آن تنظیم می‌کند:

center top left right bottom top-left top-right bottom-left bottom-right
پیش‌فرض center است.

--invert-y <bool>

[متغیر محیطی AWWW_INVERT_Y]

معکوس کردن موقعیت y ارسال‌شده در پرچم transition_pos.

--transition-bezier <f1,f2,f3,f4 (همگی اعشاری)>

[متغیر محیطی AWWW_TRANSITION_BEZIER]

منحنی بزیه مورد استفاده برای پویانمایی گذار. وب‌سایت https://cubic-bezier.com برای دریافت این مقادیر مناسب است.

مثال: 0.0,0.0,1.0,1.0 برای انیمیشن خطی.

پیش‌فرض .54,0,.34,.99 است.

--transition-wave <width,height (هر دو اعشاری)>

[متغیر محیطی AWWW_TRANSITION_WAVE]

در حال حاضر فقط برای گذار wave جهت کنترل عرض و ارتفاع هر موج استفاده می‌شود.

پیش‌فرض : 20,20 است.

-h, --help

چاپ راهنما (مشاهده خلاصه با '-h')

تصویری (یا گیف متحرک) را برای دیمن ارسال می‌کند تا نمایش داده شود. همچنین می‌توانید از - برای خواندن از ورودی استاندارد (stdin) استفاده کنید.

تصاویر ارسالی در $XDG_CACHE_HOME/awww یا در صورت عدم وجود آن در $HOME/.cache/awww ذخیره خواهند شد. در این پوشه، پوشه دیگری متناظر با شماره نسخه جاری awww ایجاد می‌شود. در آنجا، پرونده‌هایی داریم که آخرین تصویر نمایش‌داده‌شده و فریم‌های انیمیشن را برای تصاویر زمینه متحرک کَش می‌کنند. به ازای هر خروجی یک پرونده وجود دارد.

همان‌طور که اشاره شد، حافظه موقت نسخه‌های پیش‌پردازش‌شده انیمیشن‌ها را نگه می‌دارد. بنابراین، اگر یک پرونده gif حجیم بارگذاری کنید، هزینه پردازش آن را تنها بار اول پرداخت خواهید کرد. اگر دائماً پرونده‌های گیف بزرگ بارگذاری می‌کنید، ممکن است حافظه موقت بسیار بزرگ شود. در این صورت می‌توانید به سادگی دستور awww clean-cache را اجرا کنید.

awww-clear-cache(1) awww-daemon(1) awww-query(1)

2026-05-23