.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "urxvt-background 1"
.TH urxvt-background 1 2025-10-24 9.31 RXVT-UNICODE
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
background \- مدیریت پس‌زمینه پایانه
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 3
\&   urxvt \-\-background\-expr \*(Aqbackground expression\*(Aq
\&         \-\-background\-border
\&         \-\-background\-interval seconds
.Ve
.SH "راهنمای سریع و دم‌دستی (QUICK AND DIRTY CHEAT SHEET)"
.IX Header "QUICK AND DIRTY CHEAT SHEET"
بارگذاری یک تصویر jpeg دلخواه و چیدمان کاشی‌وار پس‌زمینه با آن، بدون تغییر مقیاس یا هر کار دیگر:
.PP
.Vb 1
\&   load "/path/to/img.jpg"
.Ve
.PP
مشابه حالت قبل، اما استفاده از بازتاب/حالت آینه‌ای به‌جای چیدمان کاشی‌وار:
.PP
.Vb 1
\&   mirror load "/path/to/img.jpg"
.Ve
.PP
بارگذاری یک تصویر و تغییر مقیاس آن به‌طوری که پنجره پایانه را دقیقاً پر کند:
.PP
.Vb 1
\&   scale keep { load "/path/to/img.jpg" }
.Ve
.PP
پیاده‌سازی شبه‌شفافیت (pseudo\-transparency) با استفاده از یک root pixmap با تراز مناسب به‌عنوان پس‌زمینه پنجره:
.PP
.Vb 1
\&   rootalign root
.Ve
.PP
مشابه حالت قبل، اما نگه‌داری یک نسخه مات‌شده:
.PP
.Vb 1
\&   rootalign keep { blur 10, root }
.Ve.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این افزونه پس‌زمینه ترمینال را با ایجاد تصویری در پشت متن مدیریت می‌کند که جایگزین رنگ پس‌زمینه عادی می‌شود.
.PP
این کار با ارزیابی یک عبارت Perl انجام می‌شود که تصویر را در حین اجرا (on the fly) \fIمحاسبه می‌کند\fR؛ برای مثال با گرفتن تصویر پس‌زمینه ریشه (root) یا بارگذاری یک فایل.
.PP
در حالی که تمام توان و امکانات Perl در دسترس است، عملگرها به گونه‌ای طراحی شده‌اند که تا حد امکان ساده باشند.
.PP
برای مثال، جهت بارگذاری یک تصویر و مقیاس‌بندی آن به اندازه پنجره، می‌توانید از دستور زیر استفاده کنید:
.PP
.Vb 1
\&   urxvt \-\-background\-expr \*(Aqscale keep { load "/path/to/mybg.png" }\*(Aq
.Ve
.PP
یا به عنوان یک منبع X (X resource) مشخص شود:
.PP
.Vb 1
\&   URxvt.background.expr: scale keep { load "/path/to/mybg.png" }
.Ve
.SH "مبانی عملکرد (THEORY OF OPERATION)"
.IX Header "THEORY OF OPERATION"
در هنگام راه‌اندازی، درست پیش از آنکه پنجره برای نخستین بار نگاشت (map) شود، عبارت ارزیابی می‌شود و باید یک تصویر تولید کند. سپس تصویر در صورت لزوم گسترش می‌یابد تا کل پنجره ترمینال را پوشش دهد و به عنوان pixmap پس‌زمینه تنظیم می‌شود.
.PP
اگر تصویر حاوی یک کانال آلفا (alpha channel) باشد، در حالت‌های نمایشی (visuals) که از کانال‌های آلفا پشتیبانی می‌کنند (برای مثال برای یک مدیر ترکیب یا compositing manager) بدون تغییر استفاده خواهد شد. در سایر حالت‌های نمایشی، رنگ پس‌زمینه ترمینال برای جایگزینی هرگونه شفافیت استفاده می‌شود.
.PP
هنگامی که عبارت به طور مستقیم یا غیرمستقیم به اندازه پنجره، موقعیت، pixmap ریشه، یا یک تایمر وابسته باشد، به خاطر سپرده می‌شود. در غیر این صورت، حذف خواهد شد.
.PP
اگر هر یک از پارامترهایی که عبارت به آن‌ها وابسته است تغییر کند (هنگامی که پنجره جابه‌جا شده یا اندازه آن تغییر کند؛ هنگامی که pixmap ریشه با تصویر دیگری جایگزین شده و پس‌زمینه ریشه تغییر یابد؛ یا هنگامی که تایمر منقضی شود)، عبارت مجدداً ارزیابی خواهد شد.
.PP
برای نمونه، عبارتی مانند \f(CW\*(C`scale keep { load "$HOME/mybg.png" }\*(C'\fR تصویر را به اندازه پنجره مقیاس‌بندی می‌کند، بنابراین به اندازه پنجره وابسته است و با هر بار تغییر اندازه ترمینال دوباره ارزیابی می‌شود، اما برای مثال با جابه‌جا شدن پنجره مجدداً اجرا نخواهد شد. این تضمین می‌کند که تصویر همیشه ترمینال را پر می‌کند، حتی پس از تغییر اندازه آن.
.SS "عبارت‌ها (EXPRESSIONS)"
.IX Subsection "EXPRESSIONS"
عبارت‌ها همان عبارت‌های معمولی Perl هستند؛ در واقع، آن‌ها بلوک‌های Perl به شمار می‌روند \- به این معنی که می‌توانید از چندین خط و دستور استفاده کنید:
.PP
.Vb 8
\&   scale keep {
\&      again 3600;
\&      if (localtime now)[6]) {
\&         return load "$HOME/weekday.png";
\&      } else {
\&         return load "$HOME/sunday.png";
\&      }
\&   }
.Ve
.PP
این عبارت درونی یک‌بار در هر ساعت (و همچنین هر زمان که اندازه پنجره ترمینال تغییر کند) ارزیابی می‌شود. این عبارت \fIsunday.png\fR را در روزهای یکشنبه و \fIweekday.png\fR را در سایر روزها به عنوان پس‌زمینه تنظیم می‌کند.
.PP
خوشبختانه، انتظار می‌رود بیشتر عبارت‌ها بسیار ساده‌تر باشند و به دانش اندکی از Perl نیاز داشته باشند.
.PP
به طور اساسی، شما همیشه با تابعی شروع می‌کنید که یک شیء تصویر «تولید» می‌کند، مانند \f(CW\*(C`load\*(C'\fR که یک تصویر را از دیسک بارگذاری می‌کند، یا \f(CW\*(C`root\*(C'\fR که تصویر پس‌زمینه پنجره ریشه را بازمی‌گرداند:
.PP
.Vb 1
\&   load "$HOME/mypic.png"
.Ve
.PP
مسیر معمولاً به صورت یک رشته درون گیومه مشخص می‌شود (قوانین دقیق آن را می‌توان در صفحه راهنمای perlop یافت). بخش \fR\f(CI$HOME\fR\fI\fR در ابتدای رشته به دایرکتوری خانگی گسترش می‌یابد.
.PP
سپس یک یا چند اصلاح‌کننده یا عبارت پالاینده (فیلتر) را در ابتدای آن قرار می‌دهید، مانند \&\f(CW\*(C`scale\*(C'\fR:
.PP
.Vb 1
\&   scale load "$HOME/mypic.png"
.Ve
.PP
درست مانند یک عبارت ریاضی شامل توابع، باید این عبارت‌ها را از راست به چپ بخوانید؛ چرا که ابتدا \f(CW\*(C`load\*(C'\fR ارزیابی می‌شود و نتیجه آن آرگومان تابع \f(CW\*(C`scale\*(C'\fR خواهد شد.
.PP
بسیاری از عملگرها همچنین پارامترهایی را پیش از تصویر ورودی می‌پذیرند که رفتار آن را تغییر می‌دهند. برای مثال، \f(CW\*(C`scale\*(C'\fR بدون هیچ آرگومان اضافی، تصویر را به اندازه پنجره ترمینال مقیاس‌بندی می‌کند. اگر یک آرگومان اضافی مشخص کنید، از آن به عنوان ضریب مقیاس استفاده می‌کند (برای به دست آوردن درصد در ۱۰۰ ضرب کنید):
.PP
.Vb 1
\&   scale 2, load "$HOME/mypic.png"
.Ve
.PP
این کار تصویر را با ضریب ۲ (۲۰۰٪) بزرگ می‌کند. همان‌طور که می‌بینید، اکنون \f(CW\*(C`scale\*(C'\fR دو آرگومان دارد: \f(CW2\fR و عبارت \f(CW\*(C`load\*(C'\fR، در حالی که \&\f(CW\*(C`load\*(C'\fR تنها یک آرگومان دارد. آرگومان‌ها با کاما از یکدیگر جدا می‌شوند.
.PP
عملگر scale همچنین دو آرگومان می‌پذیرد که به عنوان ضرایب جداگانه برای ابعاد افقی و عمودی عمل می‌کنند. برای مثال، عبارت زیر عرض تصویر را نصف و ارتفاع آن را دو برابر می‌کند:
.PP
.Vb 1
\&   scale 0.5, 2, load "$HOME/mypic.png"
.Ve
.PP
اگر این عبارت‌ها را امتحان کنید، ممکن است با مقداری کندی مواجه شوید؛ زیرا هر بار که اندازه ترمینال تغییر می‌کند، تصویر PNG دوباره بارگذاری شده و مقیاس‌بندی می‌شود. مقیاس‌بندی معمولاً سریع (و اجتناب‌ناپذیر) است، اما بارگذاری تصویر می‌تواند بسیار زمان‌بر باشد. اینجاست که \f(CW\*(C`keep\*(C'\fR به کار می‌آید:
.PP
.Vb 1
\&   scale 0.5, 2, keep { load "$HOME/mypic.png" }
.Ve
.PP
عملگر \f(CW\*(C`keep\*(C'\fR تمام دستورات درون آکولادها را تنها یک‌بار اجرا می‌کند، مگر زمانی که تشخیص دهد ممکن است نتیجه تغییر کند. در سایر موارد، آخرین مقدار محاسبه شده توسط بلوک آکولاد را بازمی‌گرداند.
.PP
این بدان معناست که \f(CW\*(C`load\*(C'\fR تنها یک‌بار اجرا می‌شود که آن را بسیار سریع‌تر می‌کند، اما همچنین به این معنی است که حافظه بیشتری مصرف می‌شود؛ زیرا تصویر بارگذاری‌شده باید همیشه در حافظه نگه‌داری شود. در این عبارت، به احتمال زیاد این مصالحه ارزشش را دارد.
.PP
اما بازگردیم به جلوه‌ها: جلوه‌های دیگری به جز مقیاس‌بندی نیز به آسانی در دسترس هستند؛ برای مثال، می‌توانید تصویر را به جای تغییر اندازه، کاشی‌کاری (tile) کنید تا کل پنجره را پر کند:
.PP
.Vb 1
\&   tile keep { load "$HOME/mypic.png" }
.Ve
.PP
در واقع، تصاویری که توسط \f(CW\*(C`load\*(C'\fR بازگردانده می‌شوند به طور پیش‌فرض در حالت \f(CW\*(C`tile\*(C'\fR هستند، بنابراین عملگر \&\f(CW\*(C`tile\*(C'\fR تا حدودی زائد است.
.PP
یک جلوه رایج دیگر، قرینه‌سازی یا آینه‌ای کردن (mirror) تصویر است تا لبه‌های یکسان مماس با یکدیگر قرار گیرند:
.PP
.Vb 1
\&   mirror keep { load "$HOME/mypic.png" }
.Ve
.PP
عبارت متداول دیگر برای پس‌زمینه به صورت زیر است:
.PP
.Vb 1
\&   rootalign root
.Ve
.PP
این عبارت ابتدا یک تصویر لحظه‌ای (snapshot) از پس‌زمینه صفحه نمایش تهیه کرده و سپس آن را به گوشه بالا سمت چپ صفحه منتقل می‌کند (برخلاف گوشه بالا سمت چپ پنجره ترمینال) \- نتیجه، شفافیت کاذب (pseudo\-transparency) است: تصویر ثابت به نظر می‌رسد، در حالی که پنجره روی صفحه جابه‌جا می‌شود..SS "مشخصات رنگ (COLOUR SPECIFICATIONS)"
.IX Subsection "COLOUR SPECIFICATIONS"
هر گاه یک عملگر انتظار یک «رنگ» را داشته باشد، می‌توان آن را به یکی از دو روش
مشخص کرد: یا به صورت یک رشته با مشخصات رنگ X11، مانند:
.PP
.Vb 4
\&   "red"               # named colour
\&   "#f00"              # simple rgb
\&   "[50]red"           # red with 50% alpha
\&   "TekHVC:300/50/50"  # anything goes
.Ve
.PP
یا به عنوان یک ارجاع آرایه با یک، سه یا چهار مؤلفه:
.PP
.Vb 3
\&   [0.5]               # 50% gray, 100% alpha
\&   [0.5, 0, 0]         # dark red, no green or blur, 100% alpha
\&   [0.5, 0, 0, 0.7]    # same with explicit 70% alpha
.Ve
.SS "نهان‌سازی و حساسیت (CACHING AND SENSITIVITY)"
.IX Subsection "CACHING AND SENSITIVITY"
از آنجا که برخی عملیات (مانند \f(CW\*(C`load\*(C'\fR و \f(CW\*(C`blur\*(C'\fR) ممکن است زمان زیادی ببرند،
نهان‌سازی (caching) نتایج می‌تواند برای عملکردی روان بسیار حیاتی باشد. همچنین
نهان‌سازی می‌تواند برای کاهش مصرف حافظه نیز مفید باشد؛ برای نمونه هنگامی که یک تصویر
توسط \f(CW\*(C`load\*(C'\fR نهان‌سازی شود، می‌تواند میان چندین پنجرهٔ ترمینال در حال اجرا در
urxvtd به اشتراک گذاشته شود.
.PP
\fR\f(CI\*(C`keep { ... }\*(C'\fR \fIنهان‌سازی\fR
.IX Subsection "keep { ... } caching"
.PP
مهم‌ترین روش برای نهان‌سازی عملیات‌های سنگین، استفاده از \f(CW\*(C`keep {
\&... }\*(C'\fR است. عملگر \f(CW\*(C`keep\*(C'\fR بلوکی از چندین عبارت محصور در
\f(CW\*(C`{}\*(C'\fR را دریافت کرده و مقدار بازگشتی را در حافظه نگه می‌دارد.
.PP
یک عبارت می‌تواند نسبت به رویدادهای خارجی گوناگون، مانند تغییر اندازه یا
جابه‌جایی پنجره، تغییرات پس‌زمینهٔ ریشه (root) و تایمرها «حساس» (sensitive) باشد.
تنها با استفاده از عبارتی (مانند \f(CW\*(C`scale\*(C'\fR بدون پارامتر) که به مقادیر متغیر خاصی
(که «متغیرها» نامیده می‌شوند) وابسته است، یا با استفادهٔ مستقیم از آن متغیرها،
عبارت نسبت به این رویدادها حساس خواهد شد \- برای نمونه، استفاده از \f(CW\*(C`scale\*(C'\fR یا
\f(CW\*(C`TW\*(C'\fR عبارت را نسبت به اندازهٔ ترمینال و در نتیجه نسبت به رویدادهای تغییر اندازه
حساس می‌سازد.
.PP
هنگامی که چنین رویدادی رخ دهد، \f(CW\*(C`keep\*(C'\fR به‌طور خودکار ارزیابی مجدد کل عبارت
را با مقدار جدید عبارت فراخوانی می‌کند.
.PP
\&\f(CW\*(C`keep\*(C'\fR بیشترین کاربرد را برای عملیات‌های سنگین مانند \f(CW\*(C`blur\*(C'\fR دارد:
.PP
.Vb 1
\&   rootalign keep { blur 20, root }
.Ve
.PP
این دستور یک‌بار یک رونوشت مات‌شده از پس‌زمینهٔ ریشه ایجاد می‌کند و در فراخوانی‌های بعدی،
تنها آن را با ریشه تراز می‌کند (root\-aligns). از آنجا که \f(CW\*(C`blur\*(C'\fR معمولاً بسیار کُند
و \&\f(CW\*(C`rootalign\*(C'\fR بسیار سریع است، این کار حافظهٔ اضافی را (برای pixmap مات‌شدهٔ
نهان‌سازی‌شده) با سرعت مبادله می‌کند (عملیات blur تنها زمانی که ریشه تغییر کند تکرار می‌شود).
.PP
\fR\f(CI\*(C`load\*(C'\fR \fIنهان‌سازی\fR
.IX Subsection "load caching"
.PP
عملگر \f(CW\*(C`load\*(C'\fR به‌خودی‌خود تصاویر را در حافظه نگه نمی‌دارد، اما تا زمانی که تصویر
همچنان در حافظه باقی مانده باشد، \f(CW\*(C`load\*(C'\fR به‌جای بارگیری مجدد آن از دیسک،
از همان تصویر درون‌حافظه استفاده خواهد کرد.
.PP
این بدان معناست که این عبارت:
.PP
.Vb 1
\&   keep { load "$HOME/path..." }
.Ve
.PP
نه تنها تصویر را در حافظه نهان‌سازی می‌کند، بلکه دیگر نمونه‌های ترمینال نیز که برای
\&\f(CW\*(C`load\*(C'\fR کردن آن تلاش می‌کنند می‌توانند از آن رونوشت درون‌حافظه استفاده مجدد کنند.
.SH "مرجع (REFERENCE)"
.IX Header "REFERENCE"
.SS "سوئیچ‌های خط فرمان (COMMAND LINE SWITCHES)"
.IX Subsection "COMMAND LINE SWITCHES"
.IP "\-\-background\-expr perl\-expression" 4
.IX Item "--background-expr perl-expression"
عبارت Perl مورد نظر را جهت ارزیابی مشخص می‌کند.
.IP \-\-background\-border 4
.IX Item "--background-border"
به‌طور پیش‌فرض، عبارت تصویری ایجاد می‌کند که تمام پنجره را پر کرده و روی حاشیه‌ها
و هر ناحیهٔ دیگر، مانند نوار پیمایش (scrollbar) را بازنویسی می‌کند.
.Sp
مشخص کردن این پرچم، رفتار را به گونه‌ای تغییر می‌دهد که تصویر تنها جایگزین
پس‌زمینهٔ ناحیهٔ نویسه‌ها شود.
.IP "\-\-background\-interval seconds" 4
.IX Item "--background-interval seconds"
از آنجا که برخی عملیات در افزونهٔ زیربنایی XRender می‌توانند کارساز X شما (X\-server) را
برای مدتی طولانی مسدود کنند، این افزونه حداقل زمان مشخصی را بین به‌روزرسانی‌ها اعمال می‌کند
که به‌طور معمول حدود 0.1 ثانیه است.
.Sp
اگر می‌خواهید به‌روزرسانی‌ها را در دفعات بیشتری انجام دهید، می‌توانید این بازهٔ ایمنی
را با استفاده از این سوئیچ کاهش دهید..SS "تأمین‌کننده‌ها/تولیدکننده‌ها (PROVIDERS/GENERATORS)"
.IX Subsection "PROVIDERS/GENERATORS"
این توابع با بارگذاری تصویر از دیسک، دریافت آن از صفحه ریشه (root screen) یا صرفاً با تولید آن، یک تصویر فراهم می‌کنند. از این توابع به‌عنوان نقطه شروع برای دستیابی به تصویری که بتوانید با آن کار کنید استفاده می‌شود.
.ie n .IP "load $path" 4
.el .IP "load \f(CW$path\fR" 4
.IX Item "load $path"
تصویر موجود در \f(CW$path\fR داده‌شده را بارگذاری می‌کند. تصویر روی حالت کاشی‌کاری صفحه‌ای (plane tiling mode) تنظیم می‌شود.
.Sp
اگر تصویر از قبل در حافظه باشد (برای نمونه به این دلیل که نمونه دیگری از ترمینال از آن استفاده می‌کند)، نسخه درون حافظه به‌جای آن بازگردانده می‌شود.
.ie n .IP "load_uc $path" 4
.el .IP "load_uc \f(CW$path\fR" 4
.IX Item "load_uc $path"
بارگذاری بدون حافظه موقت (uncached) \- مشابه load، اما تصویر را در حافظه موقت ذخیره نمی‌کند؛ بدین معنی که \fIهمیشه\fR دوباره از سیستم فایل بارگذاری می‌شود، حتی اگر نسخه دیگری از آن در همان زمان در حافظه موجود باشد.
.IP root 4
.IX Item "root"
نقشه پیکسلی پنجره ریشه (root window pixmap) را بازمی‌گرداند؛ یعنی، در حالت مطلوب، همان تصویر پس‌زمینه صفحه‌نمایش شما.
.Sp
این تابع عبارت شما را به ریشه حساس (root sensitive) می‌کند؛ بدین معنی که با تغییر تصویر پس‌زمینه (bg)، عبارت دوباره ارزیابی خواهد شد.
.ie n .IP "solid $colour" 4
.el .IP "solid \f(CW$colour\fR" 4
.IX Item "solid $colour"
.PD 0
.ie n .IP "solid $width, $height, $colour" 4
.el .IP "solid \f(CW$width\fR, \f(CW$height\fR, \f(CW$colour\fR" 4
.IX Item "solid $width, $height, $colour"
.PD
یک تصویر جدید ایجاد کرده و آن را کاملاً با رنگ داده‌شده پر می‌کند. تصویر روی حالت کاشی‌کاری تنظیم می‌شود.
.Sp
اگر \f(CW$width\fR و \f(CW$height\fR حذف شوند، یک تصویر 1x1 ایجاد می‌کند که برای پس‌زمینه‌های یک‌دست یا استفاده در جلوه‌های پالایشی (filtering effects) مفید است.
.ie n .IP "clone $img" 4
.el .IP "clone \f(CW$img\fR" 4
.IX Item "clone $img"
یک رونوشت دقیق از تصویر را بازمی‌گرداند. این تابع زمانی مفید است که بخواهید چندین رونوشت از یک تصویر داشته باشید تا جلوه‌های متفاوتی را روی آن‌ها اعمال کنید.
.ie n .IP "merge $img ..." 4
.el .IP "merge \f(CW$img\fR ..." 4
.IX Item "merge $img ..."
هر تعداد تصویر را دریافت کرده و آن‌ها را با یکدیگر ادغام می‌کند، و یک تصویر واحد شامل همه آن‌ها پدید می‌آورد. حالت کاشی‌کاری تصویر نخست به‌عنوان حالت کاشی‌کاری تصویر حاصل استفاده می‌شود.
.Sp
این تابع هنگامی که یک عبارت چندین تصویر را بازمی‌گرداند به‌طور خودکار فراخوانی می‌شود.
.SS "حالت‌های کاشی‌کاری (TILING MODES)"
.IX Subsection "TILING MODES"
عملگرهای زیر حالت کاشی‌کاری یک تصویر را تغییر می‌دهند؛ یعنی روشی که پیکسل‌های خارج از ناحیه تصویر هنگام استفاده از آن ترسیم می‌شوند.
.ie n .IP "tile $img" 4
.el .IP "tile \f(CW$img\fR" 4
.IX Item "tile $img"
کل صفحه را با تصویر کاشی‌کاری می‌کند و این تصویر جدید را بازمی‌گرداند \- یا به عبارت دیگر، رونوشتی از تصویر را در حالت کاشی‌کاری صفحه‌ای بازمی‌گرداند.
.Sp
مثال: بارگذاری یک تصویر و کاشی‌کاری آن روی پس‌زمینه، بدون تغییر اندازه. فراخوانی \f(CW\*(C`tile\*(C'\fR غیرضروری است زیرا \f(CW\*(C`load\*(C'\fR از قبل به‌طور پیش‌فرض در حالت کاشی‌کاری قرار دارد.
.Sp
.Vb 1
\&   tile load "mybg.png"
.Ve
.ie n .IP "mirror $img" 4
.el .IP "mirror \f(CW$img\fR" 4
.IX Item "mirror $img"
مشابه tile، اما هر بار که از یک نسخه جدید استفاده می‌کند تصویر را بازتاب می‌دهد (آینه‌ای می‌کند)، به‌گونه‌ای که لبه‌های بالایی همیشه با لبه‌های بالایی، لبه‌های راست همیشه با لبه‌های راست و به همین ترتیب مماس شوند (در کاشی‌کاری عادی، لبه‌های چپ همیشه به لبه‌های راست و بالا همیشه به لبه‌های پایین می‌رسند).
.Sp
مثال: بارگذاری یک تصویر و بازتاب دادن آن روی پس‌زمینه، که از ایجاد لبه‌های تند و شکسته در مرزهای تصویر جلوگیری می‌کند، به بهای آینه‌ای شدن خود تصویر.
.Sp
.Vb 1
\&   mirror load "mybg.png"
.Ve
.ie n .IP "pad $img" 4
.el .IP "pad \f(CW$img\fR" 4
.IX Item "pad $img"
تصویری را دریافت کرده و آن را طوری تغییر می‌دهد که تمام پیکسل‌های خارج از محدوده تصویر شفاف شوند. این حالت بیش از همه زمانی مفید است که می‌خواهید تصویری را روی تصویر دیگر یا رنگ پس‌زمینه قرار دهید، در حالی که تمام پیکسل‌های پس‌زمینه خارج از تصویر دست‌نخورده باقی بمانند.
.Sp
مثال: بارگذاری یک تصویر و نمایش آن در گوشه بالا سمت چپ. باقی فضا «خالی» رها می‌شود (شفاف یا هر رفتاری که کامپوزیتور شما در حالت آلفا دارد، در غیر این صورت رنگ پس‌زمینه).
.Sp
.Vb 1
\&   pad load "mybg.png"
.Ve
.ie n .IP "extend $img" 4
.el .IP "extend \f(CW$img\fR" 4
.IX Item "extend $img"
تصویر را با استفاده از نزدیک‌ترین پیکسل در ناحیه بیرونی تصویر، در سرتاسر صفحه امتداد می‌دهد. این حالت عمدتاً هنگامی مفید است که از عملیات‌های پالایشی پیچیده‌تر استفاده می‌کنید و می‌خواهید پیکسل‌های خارج از تصویر مقادیری یکسان با پیکسل‌های نزدیک به لبه داشته باشند.
.Sp
مثال: صرفاً جهت کنجکاوی، این سازوکار امتداد پیکسل‌ها چگونه کار می‌کند؟
.Sp
.Vb 1
\&   extend move 50, 50, load "mybg.png"
.Ve.SS "مقادیر متغیر (VARIABLE VALUES)"
.IX Subsection "VARIABLE VALUES"
توابع زیر داده‌های متغیری مانند ابعاد پنجره ترمینال را ارائه می‌دهند.
آن‌ها متغیرهای (پِرل\-) نیستند، بلکه صرفاً مقادیری را برمی‌گردانند که
تغییر می‌کنند. بیشتر آن‌ها عبارت شما را نسبت به برخی از رویدادها حساس می‌کنند؛
برای مثال استفاده از \f(CW\*(C`TW\*(C'\fR (عرض ترمینال) به این معنی است که با
تغییر اندازه ترمینال، عبارت شما دوباره ارزیابی می‌شود.
.IP TX 4
.IX Item "TX"
.PD 0
.IP TY 4
.IX Item "TY"
.PD
مختصات X و Y پنجره ترمینال را برمی‌گردانند (پنجره ترمینال به‌طور پیش‌فرض
کل پنجره است، و در حالت border\-respect تنها ناحیه نویسه‌ها را شامل می‌شود).
.Sp
استفاده از این توابع عبارت شما را نسبت به جابه‌جایی‌های پنجره حساس می‌کند.
.Sp
این توابع عمدتاً برای تراز کردن تصاویر با پنجره ریشه (root window) مفید هستند.
.Sp
مثال: بارگذاری یک تصویر و تراز کردن آن به‌گونه‌ای که گویی به پس‌زمینه مهار شده است
(راستی، این دقیقاً همان کاری است که \f(CW\*(C`rootalign\*(C'\fR انجام می‌دهد):
.Sp
.Vb 1
\&   move \-TX, \-TY, keep { load "mybg.png" }
.Ve
.IP TW 4
.IX Item "TW"
.PD 0
.IP TH 4
.IX Item "TH"
.PD
عرض (\f(CW\*(C`TW\*(C'\fR) و ارتفاع (\f(CW\*(C`TH\*(C'\fR) پنجره ترمینال را برمی‌گردانند (پنجره
ترمینال به‌طور پیش‌فرض کل پنجره است، و در حالت border\-respect تنها ناحیه
نویسه‌ها را شامل می‌شود).
.Sp
استفاده از این توابع عبارت شما را نسبت به تغییر اندازه پنجره حساس می‌کند.
.Sp
این توابع عمدتاً برای مقیاس‌بندی تصاویر یا برش (clip) تصاویر به اندازه
پنجره جهت صرفه‌جویی در حافظه مفید هستند.
.Sp
مثال: پس‌زمینه صفحه نمایش را بگیرید، آن را به اندازه پنجره برش دهید، کمی آن را
مات (blur) کنید، با موقعیت پنجره تراز نمایید و به عنوان پس‌زمینه استفاده کنید.
.Sp
.Vb 1
\&   clip move \-TX, \-TY, keep { blur 5, root }
.Ve
.IP FOCUS 4
.IX Item "FOCUS"
یک مقدار بولی برمی‌گرداند که نشان می‌دهد آیا پنجره ترمینال فوکوس صفحه‌کلید را
در اختیار دارد یا خیر؛ در صورتی که داشته باشد، مقدار true برمی‌گرداند.
.Sp
استفاده از این تابع عبارت شما را نسبت به تغییرات فوکوس حساس می‌کند.
.Sp
یک مورد استفاده رایج، محو کردن (fade) تصویر پس‌زمینه هنگام از دست رفتن فوکوس
ترمینال است، که اغلب همراه با گزینه خط فرمان \f(CW\*(C`\-fade\*(C'\fR استفاده می‌شود. در
واقع، تابعی ویژه دقیقاً برای همین کاربرد وجود دارد: \f(CW\*(C`focus_fade\*(C'\fR.
.Sp
مثال: استفاده از دو تصویر پس‌زمینه کاملاً متفاوت، بسته به اینکه پنجره فوکوس
دارد یا خیر.
.Sp
.Vb 1
\&   FOCUS ? keep { load "has_focus.jpg" } : keep { load "no_focus.jpg" }
.Ve
.IP now 4
.IX Item "now"
زمان کنونی را به صورت ثانیه‌های (کسری) از مبدأ زمان یونیکس (epoch) برمی‌گرداند.
.Sp
استفاده از این عبارت، عبارت شما را نسبت به زمان حساس \fIنمی‌کند\fR، اما دو تابع
بعدی این کار را انجام می‌دهند.
.ie n .IP "again $seconds" 4
.el .IP "again \f(CW$seconds\fR" 4
.IX Item "again $seconds"
هنگامی که از این تابع استفاده می‌شود، عبارت پس از \&\f(CW$seconds\fR ثانیه دوباره
ارزیابی خواهد شد.
.Sp
مثال: بارگذاری یک تصویر و چرخاندن آن بر اساس ساعت روز (مانند عقربه ساعت‌شمار
یک ساعت). این تصویر هر دقیقه به‌روزرسانی می‌شود.
.Sp
.Vb 2
\&   again 60;
\&   rotate 50, 50, (now % 86400) * \-72 / 8640, scale keep { load "myclock.png" }
.Ve
.ie n .IP "counter $seconds" 4
.el .IP "counter \f(CW$seconds\fR" 4
.IX Item "counter $seconds"
مشابه \f(CW\*(C`again\*(C'\fR است، اما یک مقدار شمارنده افزایشی نیز برمی‌گرداند که از 0
شروع می‌شود؛ این مقدار ممکن است برای برخی از جلوه‌های پویانمایی ساده مفید باشد..SS "عملگرهای تغییر شکل (SHAPE CHANGING OPERATORS)"
.IX Subsection "SHAPE CHANGING OPERATORS"
عملگرهای زیر شکل، اندازه یا موقعیت تصویر را تغییر می‌دهند.
.ie n .IP "clip $img" 4
.el .IP "clip \f(CW$img\fR" 4
.IX Item "clip $img"
.PD 0
.ie n .IP "clip $width, $height, $img" 4
.el .IP "clip \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "clip $width, $height, $img"
.ie n .IP "clip $x, $y, $width, $height, $img" 4
.el .IP "clip \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "clip $x, $y, $width, $height, $img"
.PD
تصویر را به مستطیل مشخص‌شده برش می‌زند (clip می‌کند). اگر مستطیل خارج از محدودهٔ تصویر باشد (مثلاً هنگامی که \f(CW$x\fR یا \f(CW$y\fR منفی هستند) یا مستطیل از تصویر بزرگ‌تر باشد، حالت کاشی‌کاری (tiling mode) نحوهٔ پر شدن پیکسل‌های اضافی را تعیین می‌کند.
.Sp
اگر \f(CW$x\fR و \f(CW$y\fR مشخص نشده باشند، مقدار \f(CW0\fR برای هر دو در نظر گرفته می‌شود.
.Sp
اگر \f(CW$width\fR و \f(CW$height\fR مشخص نشده باشند، اندازهٔ پنجره در نظر گرفته خواهد شد.
.Sp
مثال: بارگذاری یک تصویر، تار کردن (blur) آن و برش زدنش به اندازهٔ پنجره برای صرفه‌جویی در حافظه.
.Sp
.Vb 1
\&   clip keep { blur 10, load "mybg.png" }
.Ve
.ie n .IP "scale $img" 4
.el .IP "scale \f(CW$img\fR" 4
.IX Item "scale $img"
.PD 0
.ie n .IP "scale $size_factor, $img" 4
.el .IP "scale \f(CW$size_factor\fR, \f(CW$img\fR" 4
.IX Item "scale $size_factor, $img"
.ie n .IP "scale $width_factor, $height_factor, $img" 4
.el .IP "scale \f(CW$width_factor\fR, \f(CW$height_factor\fR, \f(CW$img\fR" 4
.IX Item "scale $width_factor, $height_factor, $img"
.PD
تصویر را بر اساس ضرایب ارائه‌شده در جهت‌های افقی (\f(CW$width\fR) و عمودی (\f(CW$height\fR) مقیاس‌بندی می‌کند.
.Sp
اگر تنها یک ضریب داده شود، برای هر دو جهت استفاده می‌شود.
.Sp
اگر هیچ ضریبی داده نشود، تصویر را بدون حفظ نسبت تصویر به اندازهٔ پنجره مقیاس‌بندی می‌کند.
.ie n .IP "resize $width, $height, $img" 4
.el .IP "resize \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "resize $width, $height, $img"
اندازهٔ تصویر را دقیقاً به \f(CW$width\fR در \f(CW$height\fR پیکسل تغییر می‌دهد.
.ie n .IP "fit $img" 4
.el .IP "fit \f(CW$img\fR" 4
.IX Item "fit $img"
.PD 0
.ie n .IP "fit $width, $height, $img" 4
.el .IP "fit \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "fit $width, $height, $img"
.PD
تصویر را بدون تغییر نسبت ابعاد، در \f(CW$width\fR و \f(CW$height\fR مشخص‌شده یا اندازهٔ ترمینال می‌گنجاند. این بدان معناست که تصویر تا جایی کوچک یا بزرگ می‌شود که کل آن در ناحیهٔ مشخص‌شده جا بگیرد، که احتمالاً حاشیه‌هایی باقی خواهد گذاشت.
.ie n .IP "cover $img" 4
.el .IP "cover \f(CW$img\fR" 4
.IX Item "cover $img"
.PD 0
.ie n .IP "cover $width, $height, $img" 4
.el .IP "cover \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "cover $width, $height, $img"
.PD
مشابه \f(CW\*(C`fit\*(C'\fR است، اما تصویر را تا جایی کوچک یا بزرگ می‌کند که تمام ناحیه پوشانده شود؛ بنابراین به جای احتمال باقی ماندن حاشیه‌ها، داده‌های تصویری را که جا نمی‌شوند برش می‌دهد.
.ie n .IP "move $dx, $dy, $img" 4
.el .IP "move \f(CW$dx\fR, \f(CW$dy\fR, \f(CW$img\fR" 4
.IX Item "move $dx, $dy, $img"
تصویر را به اندازهٔ \f(CW$dx\fR پیکسل در جهت افقی و \f(CW$dy\fR پیکسل در جهت عمودی جابه‌جا می‌کند.
.Sp
مثال: جابه‌جا کردن تصویر به اندازهٔ ۲۰ پیکسل به سمت راست و ۳۰ پیکسل به سمت پایین.
.Sp
.Vb 1
\&   move 20, 30, ...
.Ve
.ie n .IP "align $xalign, $yalign, $img" 4
.el .IP "align \f(CW$xalign\fR, \f(CW$yalign\fR, \f(CW$img\fR" 4
.IX Item "align $xalign, $yalign, $img"
تصویر را بر اساس یک ضریب تراز می‌کند \- مقدار \f(CW0\fR بدین معناست که تصویر به لبهٔ چپ یا بالا منتقل می‌شود (برای \f(CW$xalign\fR یا \f(CW$yalign\fR)، مقدار \f(CW0.5\fR یعنی دقیقاً در مرکز قرار می‌گیرد و مقدار \f(CW1\fR یعنی به لبهٔ راست یا پایین مماس می‌شود.
.Sp
مثال: حذف هرگونه حاشیهٔ قابل مشاهده در اطراف تصویر، قرار دادن آن در مرکز به صورت عمودی و انتقال آن به سمت راست.
.Sp
.Vb 1
\&   align 1, 0.5, pad $img
.Ve
.ie n .IP "center $img" 4
.el .IP "center \f(CW$img\fR" 4
.IX Item "center $img"
.PD 0
.ie n .IP "center $width, $height, $img" 4
.el .IP "center \f(CW$width\fR, \f(CW$height\fR, \f(CW$img\fR" 4
.IX Item "center $width, $height, $img"
.PD
تصویر را وسط‌چین می‌کند، یعنی مرکز تصویر به مرکز پنجرهٔ ترمینال (یا کادر مشخص‌شده توسط \f(CW$width\fR و \f(CW$height\fR در صورت ارائه) منتقل می‌شود.
.Sp
مثال: بارگذاری یک تصویر و قرار دادن آن در مرکز.
.Sp
.Vb 1
\&  center keep { pad load "mybg.png" }
.Ve
.ie n .IP "rootalign $img" 4
.el .IP "rootalign \f(CW$img\fR" 4
.IX Item "rootalign $img"
تصویر را به‌گونه‌ای جابه‌جا می‌کند که به جای پنجره، به صفحهٔ نمایش چسبیده به نظر برسد. این کار جلوهٔ وجود ناحیه‌ای بزرگ‌تر را در پشت پنجره ایجاد می‌کند. این دستور دقیقاً معادل \f(CW\*(C`move \-TX, \-TY\*(C'\fR است، یعنی تصویر را به گوشهٔ بالا و چپ صفحهٔ نمایش منتقل می‌کند.
.Sp
مثال: بارگذاری تصویر پس‌زمینه، قرار دادن آن در حالت آینه‌ای و تراز کردن آن با ریشه (root).
.Sp
.Vb 1
\&   rootalign keep { mirror load "mybg.png" }
.Ve
.Sp
مثال: گرفتن پس‌زمینهٔ صفحهٔ نمایش و تراز کردن آن، که تا زمانی که پنجره جلوی سایر پنجره‌ها نباشد، جلوهٔ شفافیت ایجاد می‌کند.
.Sp
.Vb 1
\&   rootalign root
.Ve
.ie n .IP "rotate $center_x, $center_y, $degrees, $img" 4
.el .IP "rotate \f(CW$center_x\fR, \f(CW$center_y\fR, \f(CW$degrees\fR, \f(CW$img\fR" 4
.IX Item "rotate $center_x, $center_y, $degrees, $img"
تصویر را در جهت عقربه‌های ساعت به اندازهٔ \f(CW$degrees\fR درجه، حول نقطهٔ واقع در \&\f(CW$center_x\fR و \f(CW$center_y\fR (که به عنوان ضریبی از عرض/ارتفاع تصویر مشخص شده است) می‌چرخاند.
.Sp
مثال: چرخش ۹۰ درجه‌ای تصویر حول مرکز آن.
.Sp
.Vb 1
\&   rotate 0.5, 0.5, 90, keep { load "$HOME/mybg.png" }
.Ve.SS "تغییرات رنگ (COLOUR MODIFICATIONS)"
.IX Subsection "COLOUR MODIFICATIONS"
عملگرهای زیر پیکسل‌های تصویر را تغییر می‌دهند.
.ie n .IP "tint $color, $img" 4
.el .IP "tint \f(CW$color\fR, \f(CW$img\fR" 4
.IX Item "tint $color, $img"
تصویر را با رنگ داده‌شده ته‌رنگ می‌زند.
.Sp
مثال: اعمال ته‌رنگ قرمز به تصویر.
.Sp
.Vb 1
\&   tint "red", load "rgb.png"
.Ve
.Sp
مثال: همان مورد، اما با تعیین رنگ از طریق مؤلفه‌ها.
.Sp
.Vb 1
\&   tint [1, 0, 0], load "rgb.png"
.Ve
.ie n .IP "shade $factor, $img" 4
.el .IP "shade \f(CW$factor\fR, \f(CW$img\fR" 4
.IX Item "shade $factor, $img"
تصویر را با ضریب داده‌شده سایه‌دار (shade) می‌کند.
.ie n .IP "contrast $factor, $img" 4
.el .IP "contrast \f(CW$factor\fR, \f(CW$img\fR" 4
.IX Item "contrast $factor, $img"
.PD 0
.ie n .IP "contrast $r, $g, $b, $img" 4
.el .IP "contrast \f(CW$r\fR, \f(CW$g\fR, \f(CW$b\fR, \f(CW$img\fR" 4
.IX Item "contrast $r, $g, $b, $img"
.ie n .IP "contrast $r, $g, $b, $a, $img" 4
.el .IP "contrast \f(CW$r\fR, \f(CW$g\fR, \f(CW$b\fR, \f(CW$a\fR, \f(CW$img\fR" 4
.IX Item "contrast $r, $g, $b, $a, $img"
.PD
کنتراست (\fIcontrast\fR) تصویر را تنظیم می‌کند.
.Sp
حالت اول یک \f(CW$factor\fR واحد را روی قرمز، سبز و آبی اعمال می‌کند، حالت دوم ضریب‌های جداگانه‌ای را برای هر کانال رنگی به کار می‌برد، و حالت آخر کانال آلفا را نیز شامل می‌شود.
.Sp
مقادیر بین 0 تا 1 کنتراست را کاهش می‌دهند و مقادیر بزرگ‌تر از 1 کنتراست را افزایش می‌دهند.
.Sp
به دلیل محدودیت‌های موجود در اکستنشن پایه‌ای XRender، کاهش کنتراست روشنایی را نیز کم می‌کند، در حالی که در حال حاضر افزایش کنتراست باعث افزایش روشنایی نیز می‌شود.
.ie n .IP "brightness $bias, $img" 4
.el .IP "brightness \f(CW$bias\fR, \f(CW$img\fR" 4
.IX Item "brightness $bias, $img"
.PD 0
.ie n .IP "brightness $r, $g, $b, $img" 4
.el .IP "brightness \f(CW$r\fR, \f(CW$g\fR, \f(CW$b\fR, \f(CW$img\fR" 4
.IX Item "brightness $r, $g, $b, $img"
.ie n .IP "brightness $r, $g, $b, $a, $img" 4
.el .IP "brightness \f(CW$r\fR, \f(CW$g\fR, \f(CW$b\fR, \f(CW$a\fR, \f(CW$img\fR" 4
.IX Item "brightness $r, $g, $b, $a, $img"
.PD
روشنایی (brightness) یک تصویر را تنظیم می‌کند.
.Sp
حالت اول یک \f(CW$bias\fR واحد را روی قرمز، سبز و آبی اعمال می‌کند، حالت دوم بایاس‌های جداگانه‌ای را برای هر کانال رنگی به کار می‌برد، و حالت آخر کانال آلفا را نیز در بر می‌گیرد.
.Sp
مقادیر کمتر از 0 روشنایی را کاهش می‌دهند، در حالی که مقادیر بزرگ‌تر از 0 آن را افزایش می‌دهند. محدودهٔ کاربردی از \-1 تا 1 است \- اولی منجر به تصویری سیاه و دومی منجر به تصویری سفید می‌شود.
.Sp
به دلیل رفتارهای خاص در اکستنشن پایه‌ای XRender، بایاس‌های کمتر از صفر می‌توانند \fIبسیار\fR کند باشند.
.Sp
همچنین می‌توانید عملگر آزمایشی(!) \f(CW\*(C`muladd\*(C'\fR را امتحان کنید.
.ie n .IP "muladd $mul, $add, $img # EXPERIMENTAL" 4
.el .IP "muladd \f(CW$mul\fR, \f(CW$add\fR, \f(CW$img\fR # EXPERIMENTAL" 4
.IX Item "muladd $mul, $add, $img # EXPERIMENTAL"
ابتدا پیکسل‌ها را در \f(CW$mul\fR ضرب کرده، سپس با \f(CW$add\fR جمع می‌کند. این عملگر می‌تواند برای پیاده‌سازی هم‌زمان روشنایی و کنتراست، با دامنه مقادیر وسیع‌تری نسبت به عملگرهای کنتراست و روشنایی استفاده شود.
.Sp
به دلیل باگ‌های متعدد در پیاده‌سازی‌های XRender، همچنین ممکن است باعث ایجاد تعدادی ناهنجاری‌های بصری (artifacts) شود.
.Sp
مثال: افزایش کنتراست با ضریب \f(CW$c\fR بدون تغییر بیش از حد روشنایی تصویر.
.Sp
.Vb 1
\&   muladd $c, (1 \- $c) * 0.5, $img
.Ve
.ie n .IP "blur $radius, $img" 4
.el .IP "blur \f(CW$radius\fR, \f(CW$img\fR" 4
.IX Item "blur $radius, $img"
.PD 0
.ie n .IP "blur $radius_horz, $radius_vert, $img" 4
.el .IP "blur \f(CW$radius_horz\fR, \f(CW$radius_vert\fR, \f(CW$img\fR" 4
.IX Item "blur $radius_horz, $radius_vert, $img"
.PD
تصویر را با محوکردن گاوسی با شعاع (تقریبی) \f(CW$radius\fR پیکسل تار می‌کند. شعاع‌ها را می‌توان به صورت جداگانه نیز مشخص کرد.
.Sp
تار کردن تصویر اغلب \fIبسیار\fR کند است، حداقل در مقایسه با سایر عملگرها. شعاع‌های محوکردن بزرگ‌تر نیز از موارد کوچک‌تر کندتر هستند، بنابراین اگر نمی‌خواهید صفحه‌نمایش شما برای مدت‌های طولانی قفل شود، آزمایش را با مقادیر کم برای شعاع (<5) شروع کنید.
.ie n .IP "focus_fade $img" 4
.el .IP "focus_fade \f(CW$img\fR" 4
.IX Item "focus_fade $img"
.PD 0
.ie n .IP "focus_fade $factor, $img" 4
.el .IP "focus_fade \f(CW$factor\fR, \f(CW$img\fR" 4
.IX Item "focus_fade $factor, $img"
.ie n .IP "focus_fade $factor, $color, $img" 4
.el .IP "focus_fade \f(CW$factor\fR, \f(CW$color\fR, \f(CW$img\fR" 4
.IX Item "focus_fade $factor, $color, $img"
.PD
هنگام از دست رفتن فوکوس، تصویر را با ضریب (و رنگ) مشخص‌شده کم‌رنگ/محو (fade) می‌کند (مشابه گزینه‌های خط فرمان \f(CW\*(C`\-fade\*(C'\fR/\f(CW\*(C`\-fadecolor\*(C'\fR که مقادیر پیش‌فرض را برای \f(CW\*(C`factor\*(C'\fR و \f(CW$color\fR نیز ارائه می‌دهند). برخلاف \f(CW\*(C`\-fade\*(C'\fR، مقدار \f(CW$factor\fR یک مقدار حقیقی است نه مقداری درصدی (یعنی 0..1، نه 0..100).
.Sp
مثال: انجام عملکرد درست هنگام درخواست focus fading.
.Sp
.Vb 1
\&   focus_fade load "mybg.jpg";
.Ve.SS "سایر موارد (OTHER STUFF)"
.IX Subsection "OTHER STUFF"
هر چیزی که در هیچ‌یک از دسته‌بندی‌های دیگر جای نگرفت، حتی پس از اعمال زور و بستن چشمانمان.
.IP "keep { ... }" 4
.IX Item "keep { ... }"
این عملگر یک بلوک کد را به عنوان آرگومان دریافت می‌کند؛ یعنی یک یا چند دستور که درون آکولاد محصور شده‌اند.
.Sp
ترفند کار در این است که این بلوک کد تنها زمانی ارزیابی می‌شود که نتیجه تغییر کند \- در سایر فراخوانی‌ها، \f(CW\*(C`keep\*(C'\fR صرفاً تصویری را که قبلاً محاسبه کرده بود بازمی‌گرداند (بله، این عملگر فقط باید برای تصاویر استفاده شود). یا به عبارت دیگر، \f(CW\*(C`keep\*(C'\fR نتیجهٔ بلوک کد را \fIکَش (حافظه موقت)\fR می‌کند تا نیازی به محاسبه مجدد آن نباشد.
.Sp
این قابلیت می‌تواند برای جلوگیری از تکرار عملیات‌های کند بسیار مفید باشد \- برای مثال، اگر عبارت پس‌زمینه شما پس‌زمینه ریشه (root) را بگیرد، آن را مات کند و سپس هم‌تراز با ریشه (root-align) سازد، با هر جابه‌جایی یا تغییر اندازهٔ پنجره، مجبور خواهد بود پس‌زمینه ریشه را دوباره مات کند.
.Sp
مثال دیگر \f(CW\*(C`load\*(C'\fR است که می‌تواند بسیار کند باشد.
.Sp
در واقع، خود urxvt کل عبارت را درون نوعی بلوک \f(CW\*(C`keep\*(C'\fR محصور می‌کند تا فقط در صورت نیاز مجدداً ارزیابی شود.
.Sp
قرار دادن مات‌سازی درون یک بلوک \f(CW\*(C`keep\*(C'\fR تضمین می‌کند که مات‌کردن فقط یک بار انجام گیرد، در حالی که \f(CW\*(C`rootalign\*(C'\fR همچنان با هر جابه‌جایی پنجره اجرا می‌شود.
.Sp
.Vb 1
\&   rootalign keep { blur 10, root }
.Ve
.Sp
این پرسش باقی می‌ماند که در صورت تغییر پس‌زمینه ریشه، چگونه ارزیابی مجدد بلوک را اجبار کنیم: اگر عبارت درون بلوک به رویدادی حساس باشد (مانند تغییرات پس‌زمینه ریشه، تغییرات هندسهٔ پنجره)، در صورت نیاز به‌طور خودکار مجدداً ارزیابی خواهد شد.
.SH "تنظیمات قدیمی تصویر پس‌زمینه (OLD BACKGROUND IMAGE SETTINGS)"
.IX Header "OLD BACKGROUND IMAGE SETTINGS"
این افزونه همچنین از گزینه‌ها/منابع قدیمی و دنباله‌های OSC برای تنظیم تصویر پس‌زمینه پشتیبانی می‌کند. این تنظیمات \fBمنسوخ شده‌اند\fR و در نسخه‌های آینده حذف خواهند شد.
.SS "گزینه‌ها و منابع (OPTIONS AND RESOURCES)"
.IX Subsection "OPTIONS AND RESOURCES"
.IP "\fB\-pixmap\fR \fIfile[;oplist]\fR" 4
.IX Item "-pixmap file[;oplist]"
.PD 0
.IP "\fBbackgroundPixmap:\fR \fIfile[;oplist]\fR" 4
.IX Item "backgroundPixmap: file[;oplist]"
.PD
از فایل تصویری مشخص‌شده به عنوان پس‌زمینه پنجره استفاده می‌کند و همچنین به طور اختیاری فهرستی از عملیات‌ها را که با دونقطه (:) از هم جدا شده‌اند برای تغییر آن مشخص می‌سازد. توجه داشته باشید که ممکن است هنگام استفاده از گزینهٔ خط فرمان نیاز باشد نویسهٔ \f(CW\*(C`;\*(C'\fR را نقل‌قول کنید، زیرا \f(CW\*(C`;\*(C'\fR معمولاً در شل‌ها یک فرانویسه (metacharacter) است. عملیات‌های پشتیبانی‌شده عبارتند از:
.RS 4
.IP \fBWxH+X+Y\fR 4
.IX Item "WxH+X+Y"
مقیاس و موقعیت را تنظیم می‌کند. \fB"W" / "H"\fR مقیاس افقی/عمودی (درصد) را مشخص می‌کنند و \fB"X" / "Y"\fR مرکز تصویر را تعیین می‌کنند (درصد). مقیاس 0 تغییر مقیاس را غیرفعال می‌کند.
.IP \fBop=tile\fR 4
.IX Item "op=tile"
چیدمان کاشی‌وار (تکرارشونده) را فعال می‌کند
.IP \fBop=keep\-aspect\fR 4
.IX Item "op=keep-aspect"
هنگام تغییر مقیاس، نسبت ابعاد تصویر را حفظ می‌کند
.IP \fBop=root\-align\fR 4
.IX Item "op=root-align"
از موقعیت پنجرهٔ ترمینال نسبت به پنجرهٔ ریشه به عنوان آفست تصویر استفاده می‌کند و پس‌زمینه پنجره ریشه را شبیه‌سازی می‌نماید
.RE
.RS 4
.Sp
تنظیم پیش‌فرض مقیاس و موقعیت \f(CW\*(C`100x100+50+50\*(C'\fR است. همچنین، می‌توان از مجموعه‌ای از الگوهای از پیش تعریف‌شده برای دستیابی به متداول‌ترین پیکربندی‌ها استفاده کرد:
.IP \fBstyle=tiled\fR 4
.IX Item "style=tiled"
تصویر بدون تغییر مقیاس، کاشی‌وار چیده می‌شود. معادل با 0x0+0+0:op=tile
.IP \fBstyle=aspect\-stretched\fR 4
.IX Item "style=aspect-stretched"
تصویر برای پر کردن کل پنجره با حفظ نسبت ابعاد کشیده شده و در مرکز قرار می‌گیرد. معادل با 100x100+50+50:op=keep\-aspect
.IP \fBstyle=stretched\fR 4
.IX Item "style=stretched"
تصویر برای پر کردن کل پنجره کشیده می‌شود. معادل با 100x100
.IP \fBstyle=centered\fR 4
.IX Item "style=centered"
تصویر بدون تغییر مقیاس در مرکز قرار می‌گیرد. معادل با 0x0+50+50
.IP \fBstyle=root\-tiled\fR 4
.IX Item "style=root-tiled"
تصویر بدون تغییر مقیاس و با استفاده از موقعیت‌یابی «root» کاشی‌وار چیده می‌شود. معادل با 0x0:op=tile:op=root\-align
.RE
.RS 4
.Sp
اگر چندین الگو مشخص شود، آخرین مورد اعمال خواهد شد. توجه داشته باشید که یک الگو تمام تنظیمات مقیاس، موقعیت و عملیات‌ها را لغو می‌کند.
.Sp
اگر به همراه شبه‌شفافیت (pseudo\-transparency) استفاده شود، تصویر مشخص‌شده با استفاده از آمیزش آلفا (alpha\-blending) روی پس‌زمینه شفاف ترکیب خواهد شد.
.RE
.IP \fB\-tr\fR|\fB+tr\fR 4
.IX Item "-tr|+tr"
.PD 0
.IP "\fBtransparent:\fR \fIboolean\fR" 4
.IX Item "transparent: boolean"
.PD
فعال/غیرفعال کردن شبه‌شفافیت با استفاده از پیکس‌مپ ریشه (root pixmap) به عنوان پس‌زمینه.
.IP "\fB\-tint\fR \fIcolour\fR" 4
.IX Item "-tint colour"
.PD 0
.IP "\fBtintColor:\fR \fIcolour\fR" 4
.IX Item "tintColor: colour"
.PD
اعمال ته‌رنگ (tint) با رنگ داده‌شده روی پس‌زمینهٔ شفاف. توجه داشته باشید که ته‌رنگ سیاه تصویری کاملاً سیاه ایجاد می‌کند، در حالی که ته‌رنگ سفید تصویر را بدون تغییر می‌گذارد.
.IP "\fB\-sh\fR \fInumber\fR" 4
.IX Item "-sh number"
.PD 0
.IP "\fBshading:\fR \fInumber\fR" 4
.IX Item "shading: number"
.PD
تیره‌تر کردن (0 .. 99) یا روشن‌تر کردن (101 .. 200) پس‌زمینهٔ شفاف. مقدار 100 به معنای عدم اعمال سایه‌روشن است.
.IP "\fB\-blr\fR \fIHxV\fR" 4
.IX Item "-blr HxV"
.PD 0
.IP "\fBblurRadius:\fR \fIHxV\fR" 4
.IX Item "blurRadius: HxV"
.PD
اعمال مات‌سازی گاوسی با شعاع مشخص‌شده بر روی پس‌زمینه شفاف. اگر یک عدد منفرد مشخص شود، شعاع‌های عمودی و افقی یکسان در نظر گرفته می‌شوند. تنظیم یکی از شعاع‌ها روی 1 و دیگری روی یک عدد بزرگ جلوه‌های جالبی بر روی برخی پس‌زمینه‌ها ایجاد می‌کند. حداکثر مقدار شعاع 128 است. شعاع افقی یا عمودی برابر با 0 مات‌سازی را غیرفعال می‌کند..SS "توالی‌های OSC (OSC sequences)"
.IX Subsection "OSC sequences"
این افزونه به توالی‌های OSC زیر واکنش نشان خواهد داد. توجه داشته باشید که
این افزونه در حال حاضر هنگام استفاده از این موارد به‌طور خودکار بارگذاری نمی‌شود،
بنابراین برای اینکه urxvt آن‌ها را شناسایی کند، باید افزونهٔ \f(CW\*(C`background\*(C'\fR
را فعال کنید. یک راه برای دستیابی به این هدف، استفاده از آرگومان
خط فرمان \f(CW\*(C`\-\-background\-expr \*(Aq\*(Aq\*(C'\fR یا مشخص کردن یک
منبع خالی \f(CW\*(C`URxvt.background.expr:\*(C'\fR> است.
.ie n .IP "\fR\fB""ESC ] 705 ; Pt ST""\fR\fB\fR تغییر رنگ ته‌رنگ پس‌زمینه شفاف به \fB\fR\fB""Pt""\fR\fB\fR." 4
.el .IP "\fR\f(CBESC ] 705 ; Pt ST\fR\fB\fR تغییر رنگ ته‌رنگ پس‌زمینه شفاف به \fB\fR\f(CBPt\fR\fB\fR." 4
.IX Item "ESC ] 705 ; Pt ST Change transparent background tint colour to Pt."
.PD 0
.ie n .IP "\fR\fB""ESC ]  20 ; Pt ST""\fR\fB\fR تغییر/پرس‌وجوی پارامترهای تصویر پس‌زمینه: مقدار \fB\fR\fB""Pt""\fR\fB\fR می‌تواند یکی از دستورهای زیر باشد:" 4
.el .IP "\fR\f(CBESC ]  20 ; Pt ST\fR\fB\fR تغییر/پرس‌وجوی پارامترهای تصویر پس‌زمینه: مقدار \fB\fR\f(CBPt\fR\fB\fR می‌تواند یکی از دستورهای زیر باشد:" 4
.IX Item "ESC ] 20 ; Pt ST Change/Query background image parameters: the value of Pt can be one of the following commands:"
.RS 4
.ie n .IP "\fR\fB""?""\fR\fB\fR" 4
.el .IP \fR\f(CB?\fR\fB\fR 4
.IX Item "?"
.PD
نمایش مقیاس و موقعیت در عنوان
.ie n .IP "\fR\fB"";WxH+X+Y""\fR\fB\fR" 4
.el .IP \fR\f(CB;WxH+X+Y\fR\fB\fR 4
.IX Item ";WxH+X+Y"
تغییر مقیاس و/یا موقعیت
.ie n .IP "\fR\fB""FILE;WxH+X+Y""\fR\fB\fR" 4
.el .IP \fR\f(CBFILE;WxH+X+Y\fR\fB\fR 4
.IX Item "FILE;WxH+X+Y"
تغییر تصویر پس‌زمینه
.RE
.RS 4
.RE