PICOM-TRANS(1)                   User Commands                  PICOM-TRANS(1)

نام (NAME)
       picom-trans - ابزاری برای تنظیم شفافیت پنجره

خلاصه دستور (SYNOPSIS)
       picom-trans [-w WINDOW_ID] [-n WINDOW_NAME] [-c] [-s] OPACITY

توضیحات (DESCRIPTION)
       picom-trans یک اسکریپت bash است که با استفاده از ابزارهای استاندارد خط
       فرمان X11، از جمله xprop(1) و xwininfo(1)، ویژگی _NET_WM_WINDOW_OPACITY
       یک پنجره را تنظیم می‌کند. این برنامه مشابه transset(1) یا transset-df(1)
       عمل می‌کند.

گزینه‌ها (OPTIONS)
       -w, --window=WINDOW_ID
           شناسه (window id) پنجره هدف را مشخص می‌کند.

       -n, --name=WINDOW_NAME
           نام پنجره را مشخص کرده و برای یافتن و تطبیق آن تلاش می‌کند.

       -c, --current
           پنجره فعال فعلی را به عنوان هدف انتخاب می‌کند. تنها در صورتی کار
           می‌کند که ویژگی EWMH با نام '_NET_ACTIVE_WINDOW' روی پنجره ریشه
           (root window) وجود داشته باشد.

       -s, --select
           پنجره هدف را با مکان‌نمای ماوس انتخاب می‌کند. در صورتی که هیچ پنجره‌ای
           تعیین نشده باشد، این حالت پیش‌فرض است.

       -o, --opacity=OPACITY
           مقدار جدید شفافیت (opacity) پنجره را تعیین می‌کند. این مقدار می‌تواند
           عددی بین 1-100 باشد. در صورتی که یک علامت مثبت یا منفی (+/-) در
           ابتدای آن قرار گیرد، این مقدار به جای جایگزینی، به شفافیت فعلی
           پنجره هدف افزوده یا از آن کاسته می‌شود.

       -g, --get
           به جای تنظیم شفافیت، مقدار شفافیت فعلی پنجره هدف را چاپ می‌کند.

       -d, --delete
           به جای تنظیم شفافیت، ویژگی شفافیت پنجره هدف را حذف می‌کند.

       -t, --toggle
           وضعیت شفافیت پنجره هدف را تغییر می‌دهد: اگر شفافیت تنظیم نشده باشد،
           آن را تنظیم می‌کند و اگر از قبل تنظیم شده باشد، آن را حذف می‌کند.

       -r, --reset
           به جای تنظیم، شفافیت تمام پنجره‌ها را بازنشانی می‌کند.

مثال‌ها (EXAMPLES)
       •   تنظیم شفافیت پنجره‌ای با شناسه مشخص به 75%:

               picom-trans -w "$WINDOWID" 75

       •   تنظیم شفافیت پنجره‌ای با نام "urxvt" به 75%:

               picom-trans -n "urxvt" 75

       •   تنظیم شفافیت پنجره فعلی به 75%:

               picom-trans -c 75

       •   انتخاب پنجره هدف با ماوس و تنظیم شفافیت آن به 75%:

               picom-trans -s 75

       •   افزایش شفافیت پنجره فعال فعلی به میزان 5%:

               picom-trans -c +5

       •   کاهش شفافیت پنجره فعال فعلی به میزان 5%:

               picom-trans -c -- -5

       •   حذف ویژگی شفافیت پنجره فعلی:

               picom-trans -c --delete

       •   تغییر وضعیت شفافیت پنجره فعلی بین 90 و حالت لغو تنظیم:

               picom-trans -c --toggle 90

       •   بازنشانی شفافیت تمام پنجره‌ها:

               picom-trans --reset

گزارش باگ‌ها (BUGS)
       لطفاً گزارش باگ‌ها را به نشانی زیر ارسال کنید:
       <https://github.com/yshui/picom>.

همچنین ببینید (SEE ALSO)
       picom(1), xprop(1), xwininfo(1)

نویسندگان (AUTHORS)
       Yuxuan Shui

picom                             2026-04-03                    PICOM-TRANS(1)