.\" Generated by scdoc 1.11.4
.\" 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 "awww-img" "1" "2026-05-23"
.PP
.SH "نام (NAME)"
awww-img \- ارسال تصویر به دیمن awww برای نمایش به عنوان تصویر زمینه
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fBawww img\fR [گزینه‌ها] <path/to/img>
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-a\fR,\fB--all\fR
.RS 4
ارسال این دستور به تمامی فضاهای نام (namespaces) فعال \fBawww-daemon\fR.\&
.PP
.RE
\fB-f\fR, \fB--filter\fR <FILTER>
.RS 4
فیلتر مورد استفاده هنگام تغییر مقیاس تصویرها
.PP
گزینه‌های در دسترس عبارتند از:
.PP
\fINearest\fR | \fIBilinear\fR | \fICatmullRom\fR | \fIMitchell\fR | \fILanczos3\fR
.PP
این موارد توسط کریت fast_image_resize ارائه می‌شوند
(https://docs.rs/fast_image_resize/2.5.0/fast_image_resize).\& گزینه \fINearest\fR برای
کارهای پیکسلی (pixel art) و صرفاً برای پیکسلی پیشنهاد می‌شود.\& همچنین سریع‌ترین فیلتر است.\&
.PP
برای موارد غیر پیکسلی، معمولاً یکی از سه مورد آخر توصیه می‌شود، هرچند برای تعیین بهترین گزینه مورد نظرتان، کمی آزمایش لازم خواهد بود.\&
.PP
توجه داشته باشید که می‌توانید پرچم \fB--no-resize\fR را نیز (که در ادامه توضیح داده شده) ارسال کنید.\& در این حالت، پرچم \fB--filter\fR هیچ تأثیری نخواهد داشت.\&
.PP
پیش‌فرض Lanczos3 است.\&
.PP
.RE
\fB-n\fR,\fB--namespace\fR <namespace>
.RS 4
مشخص می‌کند که این دستور به کدام فضای نام وی‌لند ارسال شود.\&
.PP
می‌توانید این گزینه را چندین بار مشخص کنید تا دستورات به چندین فضای نام به‌طور هم‌زمان ارسال شوند: \fBawww img -n <namespace1> -n <namespace 2>\fR.\&
.PP
این گزینه بر روی نام سوکت \fBawww-daemon\fR که برای ارتباط استفاده می‌کنیم تأثیر می‌گذارد.\& به طور خاص، نام سوکت ما
\fI${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket\fR است.\&
.PP
برخی از کامپوزیتورها می‌توانند چندین تصویر زمینه مختلف به ازای هر خروجی داشته باشند.\& این گزینه امکان تفکیک بین آن‌ها را فراهم می‌سازد.\& بیشتر کاربران احتمالاً نیازی به تنظیم این گزینه نخواهند داشت.\&
.PP
.RE
\fB--no-resize\fR
.RS 4
تغییر مقیاس تصویر انجام نشود.\& معادل با \fB--resize\fR \fIno\fR.\&
.PP
در صورت تنظیم، تصویر تغییر مقیاس نمی‌یابد و در مرکز صفحه قرار می‌گیرد.\& اگر کوچک‌تر از اندازه صفحه باشد، با مقدار \fB--fill_color\fR زیر پدینگ (فاصله) پر خواهد شد.\&
.PP
.RE
\fB--resize\fR <RESIZE>
.RS 4
آیا تصویر تغییر مقیاس داده شود و روش تغییر مقیاس آن چگونه باشد.\&
.PP
مقادیر ممکن:
.RS 4
.PD 0
.IP \(bu 4
\fIno\fR:       عدم تغییر اندازه تصویر
.IP \(bu 4
\fIcrop\fR:     تغییر اندازه تصویر برای پر کردن کل صفحه، همراه با برش بخش‌های اضافی
.IP \(bu 4
\fIfit\fR:      تغییر اندازه تصویر برای جا گرفتن در صفحه، با حفظ نسبت ابعاد اصلی
.IP \(bu 4
\fIstretch\fR:  تغییر اندازه تصویر برای جا گرفتن در صفحه، بدون حفظ نسبت ابعاد اصلی
.PD
.PP
.RE
پیش‌فرض \fIcrop\fR است.\&
.PP
.RE
\fB--crop-gravity\fR <CROP_GRAVITY>
.RS 4
مشخص کردن بخشی از تصویر برای لنگر انداختن هنگام برش.\& فقط زمانی استفاده می‌شود که `--resize crop` مشخص شده باشد.\&
.PP
مقادیر ممکن:
.RS 4
.PD 0
.IP \(bu 4
\fIcenter\fR:       برش یکسان بالا و پایین، و چپ و راست تصویر.\&
.IP \(bu 4
\fItop-left\fR:     برش پایین و راست تصویر.\&
.IP \(bu 4
\fItop\fR:          برش پایین، و برش یکسان چپ و راست تصویر.\&
.IP \(bu 4
\fItop-right\fR:    برش پایین و چپ تصویر.\&
.IP \(bu 4
\fIleft\fR:         برش راست، و برش یکسان بالا و پایین تصویر.\&
.IP \(bu 4
\fIright\fR:        برش چپ، و برش یکسان بالا و پایین تصویر.\&
.IP \(bu 4
\fIbottom-left\fR:  برش بالا و راست تصویر.\&
.IP \(bu 4
\fIbottom\fR:       برش بالا، و برش یکسان چپ و راست تصویر.\&
.IP \(bu 4
\fIbottom-right\fR: برش بالا و چپ تصویر.\&
.PD
.PP
.RE
پیش‌فرض \fIcenter\fR است.\&
.PP
.RE
\fB--fill-color\fR <RRGGBB>
.RS 4
رنگی که برای پر کردن فاصله‌های خالی هنگام عدم تغییر مقیاس استفاده می‌شود.\&
.PP
پیش‌فرض \fI000000\fR است.\&
.PP
.RE
\fB-o\fR, \fB--outputs\fR
.RS 4
فهرست جداشده با کاما از خروجی‌هایی که تصویر در آن‌ها نمایش داده شود.\& از \fBawww query\fR برای اطلاع از خروجی‌های در حال استفاده استفاده کنید.\&
.PP
اگر تنظیم نشود، تصویر روی تمامی خروجی‌ها نمایش داده می‌شود.\&
.PP
.RE
\fB-t\fR, \fB--transition-type\fR <TRANSITION_TYPE>
.RS 4
[متغیر محیطی $AWWW_TRANSITION]
.PP
نوع گذار (انیمیشن تغییر تصویر) را تنظیم می‌کند.\& مقدار پیش‌فرض \fIsimple\fR است که به آرامی در تصویر جدید محو می‌شود.\&
.PP
گذارهای ممکن عبارتند از:
.PP
.RE
.TS
allbox;c c c c c c c c c c c c c c.
T{
\fInone\fR
T}	T{
\fIsimple\fR
T}	T{
\fIfade\fR
T}	T{
\fIleft\fR
T}	T{
\fIright\fR
T}	T{
\fItop\fR
T}	T{
\fIbottom\fR
T}	T{
\fIwipe\fR
T}	T{
\fIwave\fR
T}	T{
\fIgrow\fR
T}	T{
\fIcenter\fR
T}	T{
\fIany\fR
T}	T{
\fIouter\fR
T}	T{
\fIrandom\fR
T}
.TE
.sp 1
.RS 4
گزینه \fInone\fR گذار را فوراً کامل می‌کند.\&
.PP
گزینه \fIfade\fR شبیه به \fIsimple\fR است اما از منحنی‌های بزیه (bezier) برای محو شدن تصویر استفاده می‌کند؛ نسخه‌ای زیباتر از \fIsimple\fR با آرتیفکت کمتر.\&
.PP
گزینه‌های \fIleft\fR، \fIright\fR، \fItop\fR و \fIbottom\fR باعث می‌شوند گذار از آن موقعیت به سمت مخالف صفحه رخ دهد.\&
.PP
گزینه \fIwipe\fR مشابه \fIleft\fR است اما به شما امکان می‌دهد زاویه گذار را با پرچم \fB--transition-angle\fR مشخص کنید.\&
.PP
گزینه \fIwave\fR مشابه \fIwipe\fR است اما خط جاروب به صورت موج‌دار حرکت می‌کند.\& می‌توانید میزان موج را با \fB--transition-wave\fR کنترل کنید.\&
.PP
گزینه \fIgrow\fR باعث می‌شود یک دایره رو به رشد در سراسر صفحه منتقل شود و تغییر موقعیت مرکز دایره با پرچم \fB--transition-pos\fR امکان‌پذیر است.\&
.PP
گزینه \fIcenter\fR نام مستعاری برای \fIgrow\fR با موقعیت تنظیم‌شده روی مرکز صفحه است.\&
.PP
گزینه \fIany\fR نام مستعاری برای \fIgrow\fR با موقعیت تنظیم‌شده روی یک نقطه تصادفی روی صفحه است.\&
.PP
گزینه \fIouter\fR همانند grow است اما دایره به جای رشد کردن، کوچک می‌شود.\&
.PP
در نهایت، \fIrandom\fR یک افکت گذار را به صورت تصادفی انتخاب می‌کند.\&
.PP
.RE
\fB--transition-step\fR <0-255>
.RS 4
[متغیر محیطی $AWWW_TRANSITION_STEP]
.PP
سرعت نزدیک شدن گذار به تصویر جدید.\&
.PP
منطق گذار با افزودن یا کم کردن از مقادیر جاری rgb تا زمانی که تصویر قدیمی به تصویر جدید تبدیل شود عمل می‌کند.\& این پرچم مقدار اضافه یا کم شدن را کنترل می‌کند.\&
.PP
برای مثال، اگر پیکسل A برابر با 000010 باشد و بخواهیم به پیکسل B با مقدار 000020 تبدیل شود، اگر \fBtransition-step\fR برابر ۲ باشد، در یک فریم پیکسل A به 000012، در فریم بعد به 000014 و به همین ترتیب تبدیل می‌شود.\&
.PP
مقادیر بزرگتر گذار را سریع‌تر اما ناگهانی‌تر می‌کنند.\& مقدار ۲۵۵ همیشه بلافاصله به تصویر جدید سوییچ می‌کند.\&
.PP
پیش‌فرض ۹۰ است.\&
اگر \fBtransition-type\fR برابر \fIsimple\fR باشد، پیش‌فرض ۲ است.\&
.PP
.RE
\fB--transition-duration\fR <ثانیه (می‌تواند اعشاری باشد)>
.RS 4
[متغیر محیطی $AWWW_TRANSITION_DURATION]
.PP
مدت زمانی که طول می‌کشد تا گذار کامل شود، بر حسب ثانیه.\&
.PP
توجه داشته باشید که این گزینه با گذار \fIsimple\fR کار نمی‌کند.\&
.PP
پیش‌فرض ۳ است.\&
.PP
.RE
\fB--transition-fps\fR <فریم در ثانیه (حداکثر ۲۵۵)>
.RS 4
[متغیر محیطی $AWWW_TRANSITION_FPS]
.PP
نرخ فریم برای افکت گذار.\&
.PP
توجه داشته باشید که تنظیم این مقدار روی عددی کمتر از پشتیبانی مانیتور بی‌فایده است.\&
.PP
همچنین این مورد با transition-step تفاوت دارد؛ آن پرچم مشخص می‌کند در هر فریم چه مقدار به تصویر جدید نزدیک شویم.\&
.PP
پیش‌فرض ۳۰ است.\&
.PP
.RE
\fB--transition-angle\fR <زاویه بر حسب درجه (به صورت ممیز شناور)>
.RS 4
[متغیر محیطی AWWW_TRANSITION_ANGLE]
.PP
این گزینه برای گذارهای \fIwipe\fR و \fIwave\fR استفاده می‌شود و زاویه پاک‌کردن را کنترل می‌کند.\&
.PP
توجه داشته باشید که زاویه بر حسب درجه است، جایی که '0' راست به چپ، '90' بالا به پایین، و '270' پایین به بالاست.\&
.PP
پیش‌فرض ۴۵ است.\&
.PP
.RE
\fB--transition-pos\fR <x,y>
.RS 4
[متغیر محیطی AWWW_TRANSITION_POS]
.PP
این گزینه فقط برای گذارهای \fIgrow\fR و \fIouter\fR استفاده می‌شود و مرکز دایره را کنترل می‌کند (پیش‌فرض \fIcenter\fR است).\&
.PP
مقادیر موقعیت را می‌توان هم به درصد و هم بر حسب پیکسل مشخص کرد: مقادیر اعشاری به عنوان درصد و مقادیر صحیح به عنوان پیکسل تفسیر می‌شوند.\& برای مثال: 0.5,0.5 به معنی ۵۰٪ عرض و ۵۰٪ ارتفاع صفحه است، در حالی که 200,400 به معنی ۲۰۰ پیکسل از چپ و ۴۰۰ پیکسل از پایین است.\&
.PP
این مقدار می‌تواند یک نام مستعار نیز باشد که موقعیت را متناسب با آن تنظیم می‌کند:
.RE
.TS
allbox;c c c c c c c c c.
T{
\fIcenter\fR
T}	T{
\fItop\fR
T}	T{
\fIleft\fR
T}	T{
\fIright\fR
T}	T{
\fIbottom\fR
T}	T{
\fItop-left\fR
T}	T{
\fItop-right\fR
T}	T{
\fIbottom-left\fR
T}	T{
\fIbottom-right\fR
T}
.TE
.sp 1
.RS 4
پیش‌فرض \fIcenter\fR است.\&
.PP
.RE
\fB--invert-y\fR <bool>
.RS 4
[متغیر محیطی AWWW_INVERT_Y]
.PP
معکوس کردن موقعیت y ارسال‌شده در پرچم \fBtransition_pos\fR.
.PP
.RE
\fB--transition-bezier\fR <f1,f2,f3,f4 (همگی اعشاری)>
.RS 4
[متغیر محیطی AWWW_TRANSITION_BEZIER]
.PP
منحنی بزیه مورد استفاده برای پویانمایی گذار.\& وب‌سایت https://cubic-bezier.com برای دریافت این مقادیر مناسب است.\&
.PP
مثال: 0.0,0.0,1.0,1.0 برای انیمیشن خطی.
.PP
پیش‌فرض .54,0,.34,.99 است.
.PP
.RE
\fB--transition-wave\fR <width,height (هر دو اعشاری)>
.RS 4
[متغیر محیطی AWWW_TRANSITION_WAVE]
.PP
در حال حاضر فقط برای گذار \fIwave\fR جهت کنترل عرض و ارتفاع هر موج استفاده می‌شود.\&
.PP
پیش‌فرض : 20,20 است.
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
چاپ راهنما (مشاهده خلاصه با '\&-h')
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
تصویری (یا گیف متحرک) را برای دیمن ارسال می‌کند تا نمایش داده شود.\& همچنین می‌توانید از \fB-\fR برای خواندن از ورودی استاندارد (stdin) استفاده کنید.\&
.PP
.SH "درباره حافظه موقت (ABOUT THE CACHE)"
.PP
تصاویر ارسالی در \fI$XDG_CACHE_HOME/awww\fR یا در صورت عدم وجود آن در \fI$HOME/.cache/awww\fR ذخیره خواهند شد.\& در این پوشه، پوشه دیگری متناظر با شماره نسخه جاری \fBawww\fR ایجاد می‌شود.\& در آنجا، پرونده‌هایی داریم که آخرین تصویر نمایش‌داده‌شده و فریم‌های انیمیشن را برای تصاویر زمینه متحرک کَش می‌کنند.\& به ازای هر خروجی یک پرونده وجود دارد.\&
.PP
همان‌طور که اشاره شد، حافظه موقت نسخه‌های پیش‌پردازش‌شده انیمیشن‌ها را نگه می‌دارد.\& بنابراین، اگر یک پرونده \fBgif\fR حجیم بارگذاری کنید، هزینه پردازش آن را تنها بار اول پرداخت خواهید کرد.\& اگر دائماً پرونده‌های گیف بزرگ بارگذاری می‌کنید، ممکن است حافظه موقت بسیار بزرگ شود.\& در این صورت می‌توانید به سادگی دستور \fBawww clean-cache\fR را اجرا کنید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBawww-clear-cache\fR(1) \fBawww-daemon\fR(1) \fBawww-query\fR(1)