نام (NAME)

kitten-@-set-background-opacity - تنظیم شفافیت پس‌زمینه پنجره‌های ترمینال kitty

خلاصه دستور (SYNOPSIS)

kitten @ set-background-opacity OPACITY

توضیحات (DESCRIPTION)

تنظیم شفافیت پس‌زمینه برای پنجره‌های مشخص‌شده. این قابلیت تنها در صورتی کار می‌کند که گزینه dynamic_background_opacity را در kitty.conf فعال کرده باشید. شفافیت پس‌زمینه روی تمام پنجره‌های kitty در یک پنجره واحد سیستم‌عامل اثر می‌گذارد. به عنوان مثال:

kitten @ set-background-opacity 0.5

گزینه‌ها (OPTIONS)

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

مقدار ویژه 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. پنجره‌های active پنجره‌هایی هستند که در برگه والد خود فعال هستند. تنها یک پنجره focused وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره فوکوس‌شده مطابقت داده می‌شود. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره سیستم‌عامل فعلی که فوکوس دارد مطابقت پیدا می‌کند. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود مطابقت دارد. مقدار overlay_parent با پنجره‌ای که زیر پنجره self قرار دارد (زمانی که پنجره self یک overlay است) مطابقت پیدا می‌کند.

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

--match-tab, -t: برگه‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت field:query هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. عبارت query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند عدد یا عبارت منظم (Regex) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

مقدار ویژه all با تمام برگه‌ها مطابقت دارد.

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

هنگام استفاده از title یا id، ابتدا به دنبال یک برگه منطبق جستجو می‌شود و در صورت پیدا نشدن، به دنبال یک پنجره منطبق جستجو شده و برگه مربوط به آن پنجره استفاده می‌شود.

همچنین می‌توانید از window_id و window_title برای مطابقت با برگه‌ای که حاوی پنجره با شناسه یا عنوان مشخص‌شده است استفاده کنید.

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

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

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

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

توجه داشته باشید که می‌توانید از دستور 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 برای خواندن از توصیف‌کننده فایل 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