'\" t
.\"     Title: picom-trans
.\"    Author: Yuxuan Shui
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-04-03
.\"    Manual: User Commands
.\"    Source: picom
.\"  Language: Persian
.\"
.TH "PICOM\-TRANS" "1" "2026-04-03" "picom" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
picom-trans \- ابزاری برای تنظیم شفافیت پنجره
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpicom\-trans\fP [\-w \fIWINDOW_ID\fP] [\-n \fIWINDOW_NAME\fP] [\-c] [\-s] \fIOPACITY\fP
.SH "توضیحات (DESCRIPTION)"
.sp
\fBpicom\-trans\fP یک اسکریپت bash است که با استفاده از ابزارهای استاندارد خط فرمان X11، از جمله \fBxprop\fP(1) و \fBxwininfo\fP(1)، ویژگی \fI_NET_WM_WINDOW_OPACITY\fP یک پنجره را تنظیم می‌کند. این برنامه مشابه \fBtransset\fP(1) یا \fBtransset\-df\fP(1) عمل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-w\fP, \fB\-\-window\fP=\fIWINDOW_ID\fP
.RS 4
شناسه (window id) پنجره هدف را مشخص می‌کند.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP=\fIWINDOW_NAME\fP
.RS 4
نام پنجره را مشخص کرده و برای یافتن و تطبیق آن تلاش می‌کند.
.RE
.sp
\fB\-c\fP, \fB\-\-current\fP
.RS 4
پنجره فعال فعلی را به عنوان هدف انتخاب می‌کند. تنها در صورتی کار می‌کند که ویژگی EWMH با نام \*(Aq_NET_ACTIVE_WINDOW\*(Aq روی پنجره ریشه (root window) وجود داشته باشد.
.RE
.sp
\fB\-s\fP, \fB\-\-select\fP
.RS 4
پنجره هدف را با مکان‌نمای ماوس انتخاب می‌کند. در صورتی که هیچ پنجره‌ای تعیین نشده باشد، این حالت پیش‌فرض است.
.RE
.sp
\fB\-o\fP, \fB\-\-opacity\fP=\fIOPACITY\fP
.RS 4
مقدار جدید شفافیت (opacity) پنجره را تعیین می‌کند. این مقدار می‌تواند عددی بین 1\-100 باشد. در صورتی که یک علامت مثبت یا منفی (+/\-) در ابتدای آن قرار گیرد، این مقدار به جای جایگزینی، به شفافیت فعلی پنجره هدف افزوده یا از آن کاسته می‌شود.
.RE
.sp
\fB\-g\fP, \fB\-\-get\fP
.RS 4
به جای تنظیم شفافیت، مقدار شفافیت فعلی پنجره هدف را چاپ می‌کند.
.RE
.sp
\fB\-d\fP, \fB\-\-delete\fP
.RS 4
به جای تنظیم شفافیت، ویژگی شفافیت پنجره هدف را حذف می‌کند.
.RE
.sp
\fB\-t\fP, \fB\-\-toggle\fP
.RS 4
وضعیت شفافیت پنجره هدف را تغییر می‌دهد: اگر شفافیت تنظیم نشده باشد، آن را تنظیم می‌کند و اگر از قبل تنظیم شده باشد، آن را حذف می‌کند.
.RE
.sp
\fB\-r\fP, \fB\-\-reset\fP
.RS 4
به جای تنظیم، شفافیت تمام پنجره‌ها را بازنشانی می‌کند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
تنظیم شفافیت پنجره‌ای با شناسه مشخص به 75%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-w "$WINDOWID" 75
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
تنظیم شفافیت پنجره‌ای با نام "urxvt" به 75%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-n "urxvt" 75
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
تنظیم شفافیت پنجره فعلی به 75%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-c 75
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
انتخاب پنجره هدف با ماوس و تنظیم شفافیت آن به 75%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-s 75
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
افزایش شفافیت پنجره فعال فعلی به میزان 5%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-c +5
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
کاهش شفافیت پنجره فعال فعلی به میزان 5%:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-c \-\- \-5
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
حذف ویژگی شفافیت پنجره فعلی:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-c \-\-delete
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
تغییر وضعیت شفافیت پنجره فعلی بین 90 و حالت لغو تنظیم:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-c \-\-toggle 90
.fam
.fi
.if n .RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
بازنشانی شفافیت تمام پنجره‌ها:
.sp
.if n .RS 4
.nf
.fam C
picom\-trans \-\-reset
.fam
.fi
.if n .RE
.RE
.SH "گزارش باگ‌ها (BUGS)"
.sp
لطفاً گزارش باگ‌ها را به نشانی زیر ارسال کنید: \c
.URL "https://github.com/yshui/picom" "" "."
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBpicom\fP(1), \fBxprop\fP(1), \fBxwininfo\fP(1)
.SH "نویسندگان (AUTHORS)"
.sp
Yuxuan Shui