.TH "kitten-@-set-background-image" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-set-background-image \- تنظیم تصویر پس‌زمینه در پنجره‌های ترمینال kitty
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ set-background-image PATH_TO_IMAGE_OR_INDEX"
.YS
.SH "توضیحات (DESCRIPTION)"
تنظیم تصویر پس‌زمینه برای پنجره‌های مشخص‌شده سیستم‌عامل. باید مسیر تصویر مورد استفاده به عنوان پس‌زمینه را مشخص کنید. اگر مقدار ویژه
.B none
را مشخص کنید، هرگونه تصویر موجود حذف خواهد شد. قالب‌های تصویری پشتیبانی‌شده عبارتند از: PNG، JPEG، WEBP، GIF، BMP و TIFF.
.PP
همچنین می‌توانید یک اندیس مشخص کنید تا تصویر پس‌زمینه به یکی از تصاویر از پیش پیکربندی‌شده تغییر یابد. اندیس یا یک عدد است یا عددی با علامت مثبت یا منفی در ابتدا که به عنوان مقدار افزایشی/کاهشی عمل می‌کند. اگر اندیس خارج از محدوده تصاویر پیکربندی‌شده باشد، نخستین تصویر پیکربندی‌شده استفاده می‌شود. برای مثال:
.B set\-background \-\- \-1
یا
.B set\-background 3
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--all, -a" " [=no]"
به‌طور پیش‌فرض، تصویر پس‌زمینه فقط برای پنجره فعال جاری سیستم‌عامل تغییر می‌کند. این گزینه باعث تغییر تصویر در تمام پنجره‌ها می‌شود.
.TP
.BI "--configured, -c" " [=no]"
تغییر تصویر پس‌زمینه پیکربندی‌شده که برای پنجره‌های جدید سیستم‌عامل استفاده می‌شود. توجه داشته باشید که تعیین اندیس همراه با این گزینه پشتیبانی نمی‌شود. تعیین
.B none
باعث حذف *تمامی* تصاویر پس‌زمینه پیکربندی‌شده خواهد شد.
.TP
.BI "--layout" " [=configured]"
نحوه نمایش تصویر. مقدار
.B configured
از مقدار پیکربندی‌شده استفاده می‌کند.
.PP
انتخاب‌ها:
.BR configured ،
.BR centered ،
.BR clamped ،
.BR cscaled ،
.BR mirror\-tiled ،
.BR scaled ،
.B tiled
.TP
.BI "--no-response" " [=no]"
منتظر پاسخ از kitty نماند. این بدان معناست که حتی اگر تنظیم تصویر پس‌زمینه با شکست مواجه شود، دستور با کد موفقیت خارج خواهد شد.
.TP
.BI "--match, -m"
پنجره مورد نظر برای تطبیق. مشخصات تطبیق به فرم
.I field:query
هستند. در اینجا
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.B session
و
.BR recent .
بخش
.I query
عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی ترکیب کرد.
.PP
مقدار ویژه
.B all
با تمام پنجره‌ها تطبیق می‌یابد.
.PP
برای فیلدهای عددی:
.BR id ،
.BR pid ،
.B num
و
.BR recent ،
عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای
.B id
از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه
.B \-1
نشان‌دهنده جدیدترین پنجره ایجاد‌شده است.
.PP
فیلد
.B num
به موقعیت پنجره در زبانه جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (مشابه ترتیبی که پنجره‌ها توسط دستور
.B kitten @ ls
گزارش می‌شوند).
.PP
شناسه پنجره جاری از طریق متغیر محیطی
.B KITTY_WINDOW_ID
در دسترس است.
.PP
فیلد
.B recent
به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ به این صورت که صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.
.PP
فیلد
.B neighbor
به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد:
.BR left ،
.BR right ،
.B top
یا
.BR bottom .
.PP
فیلد
.B session
با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت
.B \(ha$
برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از
.B .
برای تطبیق با نشست فعال فعلی، و از
.B \(ti
برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده کنید.
.PP
هنگام استفاده از فیلد
.B env
برای تطبیق بر اساس متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای مثال:
.BR env:MY_ENV_VAR=2 .
.PP
به همین ترتیب، فیلد
.B var
با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. همانند فیلد
.BR env ،
می‌توانید تنها نام یا نام و مقدار را مشخص کنید.
.PP
فیلد
.B state
با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از:
.BR active ،
.BR focused ،
.BR needs_attention ،
.BR parent_active ،
.BR parent_focused ،
.BR focused_os_window ،
.B self
و
.BR overlay_parent .
پنجره‌های فعال پنجره‌هایی هستند که در زبانه والد خود فعال می‌باشند. تنها یک پنجره دارای فوکوس وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره دارای فوکوس تطبیق داده می‌شود. مقدار
.B focused_os_window
با تمامی پنجره‌های موجود در پنجره دارای فوکوس سیستم‌عامل تطبیق می‌یابد. مقدار
.B self
با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق می‌یابد. مقدار
.B overlay_parent
با پنجره‌ای که زیر پنجره
.B self
قرار دارد (هنگامی که پنجره
.B self
یک اورلی باشد) تطبیق می‌یابد.
.PP
توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست پنجره‌ها استفاده کنید.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to"
نشانی نمونه kitty برای کنترل. منطبق با نشانی داده‌شده به نمونه kitty از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در فایل
.I kitty.conf
است. در صورت عدم تعیین، متغیر محیطی
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، به این معنی که تنها زمانی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
.TP
.BI "--password"
رمز عبور مورد استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بگیرد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا در
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از رمز عبور خالی، گزینه
.B \-\-use\-password
را برابر با
.B always
قرار دهید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی بر مبنای دایرکتوری پیکربندی kitty حل می‌شوند. از
.B \-
برای خواندن از STDIN استفاده کنید. از
.I fd:num
برای خواندن از توصیف‌کننده فایل (file descriptor) شماره
.I num
استفاده کنید. در صورتی که
.B \-\-password
ارائه نشده باشد استفاده می‌شود. به‌طور پیش‌فرض به دنبال فایل
.I rc\-pass
در دایرکتوری پیکربندی kitty می‌گردد.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن رمز عبور از آن. در صورتی که
.B \-\-password\-file
ارائه نشده باشد استفاده می‌شود. به‌طور پیش‌فرض متغیر محیطی
.B KITTY_RC_PASSWORD
بررسی می‌شود.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از رمز عبور ارائه‌شده به کار رود. اگر روی
.B always
تنظیم شود و هیچ رمز عبوری ارائه نشده باشد، از رمز عبور خالی استفاده می‌شود.
.PP
انتخاب‌ها:
.BR if\-available ،
.B always
و
.B never