نام (NAME)

kitten-@-set-background-image - تنظیم تصویر پس‌زمینه در پنجره‌های ترمینال kitty

نحوه استفاده (USAGE)

kitten @ set-background-image PATH_TO_IMAGE_OR_INDEX

توضیحات (DESCRIPTION)

تنظیم تصویر پس‌زمینه برای پنجره‌های مشخص‌شده سیستم‌عامل. باید مسیر تصویر مورد استفاده به عنوان پس‌زمینه را مشخص کنید. اگر مقدار ویژه none را مشخص کنید، هرگونه تصویر موجود حذف خواهد شد. قالب‌های تصویری پشتیبانی‌شده عبارتند از: PNG، JPEG، WEBP، GIF، BMP و TIFF.

همچنین می‌توانید یک اندیس مشخص کنید تا تصویر پس‌زمینه به یکی از تصاویر از پیش پیکربندی‌شده تغییر یابد. اندیس یا یک عدد است یا عددی با علامت مثبت یا منفی در ابتدا که به عنوان مقدار افزایشی/کاهشی عمل می‌کند. اگر اندیس خارج از محدوده تصاویر پیکربندی‌شده باشد، نخستین تصویر پیکربندی‌شده استفاده می‌شود. برای مثال: set-background -- -1 یا set-background 3

گزینه‌ها (OPTIONS)

--all, -a [=no]: به‌طور پیش‌فرض، تصویر پس‌زمینه فقط برای پنجره فعال جاری سیستم‌عامل تغییر می‌کند. این گزینه باعث تغییر تصویر در تمام پنجره‌ها می‌شود.
--configured, -c [=no]: تغییر تصویر پس‌زمینه پیکربندی‌شده که برای پنجره‌های جدید سیستم‌عامل استفاده می‌شود. توجه داشته باشید که تعیین اندیس همراه با این گزینه پشتیبانی نمی‌شود. تعیین none باعث حذف *تمامی* تصاویر پس‌زمینه پیکربندی‌شده خواهد شد.
--layout [=configured]: نحوه نمایش تصویر. مقدار configured از مقدار پیکربندی‌شده استفاده می‌کند.

انتخاب‌ها: configured، centered، clamped، cscaled، mirror-tiled، scaled، tiled

--no-response [=no]: منتظر پاسخ از kitty نماند. این بدان معناست که حتی اگر تنظیم تصویر پس‌زمینه با شکست مواجه شود، دستور با کد موفقیت خارج خواهد شد.
--match, -m: پنجره مورد نظر برای تطبیق. مشخصات تطبیق به فرم field:query هستند. در اینجا field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. بخش query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی ترکیب کرد.

مقدار ویژه all با تمام پنجره‌ها تطبیق می‌یابد.

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای id از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه -1 نشان‌دهنده جدیدترین پنجره ایجاد‌شده است.

فیلد num به موقعیت پنجره در زبانه جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (مشابه ترتیبی که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره جاری از طریق متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ به این صورت که صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: left، right، top یا bottom.

فیلد session با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال فعلی، و از ~ برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق بر اساس متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای مثال: env:MY_ENV_VAR=2.

به همین ترتیب، فیلد var با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. همانند فیلد env، می‌توانید تنها نام یا نام و مقدار را مشخص کنید.

فیلد state با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self و overlay_parent. پنجره‌های فعال پنجره‌هایی هستند که در زبانه والد خود فعال می‌باشند. تنها یک پنجره دارای فوکوس وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره دارای فوکوس تطبیق داده می‌شود. مقدار focused_os_window با تمامی پنجره‌های موجود در پنجره دارای فوکوس سیستم‌عامل تطبیق می‌یابد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق می‌یابد. مقدار overlay_parent با پنجره‌ای که زیر پنجره self قرار دارد (هنگامی که پنجره self یک اورلی باشد) تطبیق می‌یابد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرست پنجره‌ها استفاده کنید.

--help, -h [=no]: نمایش راهنمای این دستور

گزینه‌های عمومی (GLOBAL OPTIONS)

--to: نشانی نمونه kitty برای کنترل. منطبق با نشانی داده‌شده به نمونه kitty از طریق گزینه --listen-on یا تنظیم listen_on در فایل kitty.conf است. در صورت عدم تعیین، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، به این معنی که تنها زمانی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
--password: رمز عبور مورد استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بگیرد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از رمز عبور خالی، گزینه --use-password را برابر با always قرار دهید.
--password-file [=rc-pass]: فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی بر مبنای دایرکتوری پیکربندی kitty حل می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌کننده فایل (file descriptor) شماره num استفاده کنید. در صورتی که --password ارائه نشده باشد استفاده می‌شود. به‌طور پیش‌فرض به دنبال فایل rc-pass در دایرکتوری پیکربندی kitty می‌گردد.
--password-env [=KITTY_RC_PASSWORD]: نام یک متغیر محیطی برای خواندن رمز عبور از آن. در صورتی که --password-file ارائه نشده باشد استفاده می‌شود. به‌طور پیش‌فرض متغیر محیطی KITTY_RC_PASSWORD بررسی می‌شود.
--use-password [=if-available]: اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از رمز عبور ارائه‌شده به کار رود. اگر روی always تنظیم شود و هیچ رمز عبوری ارائه نشده باشد، از رمز عبور خالی استفاده می‌شود.

انتخاب‌ها: if-available، always و never