.\" Copyright 1988, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\"
.TH XWININFO 1 2023-06-08 "xwininfo 1.1.7" "X Version 11"
.SH "نام (NAME)"
xwininfo \- ابزار دریافت اطلاعات پنجره برای X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxwininfo\fP [\fB\-help\fP] [\fB\-id\fP \fIwdid\fP] [\fB\-root\fP] [\fB\-name\fP \fIwdname\fP] [\fB\-int\fP]
         [\fB\-children\fP] [\fB\-tree\fP] [\fB\-stats\fP] [\fB\-bits\fP] [\fB\-events\fP] [\fB\-size\fP] [\fB\-wm\fP]
         [\fB\-shape\fP] [\fB\-frame\fP] [\fB\-all\fP]
         [\fB\-english\fP] [\fB\-metric\fP]
         [\fB\-display\fP \fIhost:dpy\fP] [\fB\-version\fP]
.fi
.SH "توضیحات (DESCRIPTION)"
دستور
.B xwininfo
ابزاری برای نمایش اطلاعات درباره پنجره‌ها است.
بسته به گزینه‌های انتخاب‌شده، اطلاعات گوناگونی نمایش داده می‌شود.
چنانچه گزینه‌ای مشخص نشود، فرض بر \fB\-stats\fP است.
.PP
کاربر می‌تواند پنجرهٔ هدف را با موشواره انتخاب کند
(با کلیک روی هر یک از کلیدهای موشواره در پنجرهٔ مورد نظر)،
یا با مشخص کردن شناسهٔ پنجره در خط فرمان با گزینهٔ \fB\-id\fP،
یا با مشخص کردن نام پنجره با گزینهٔ \fB\-name\fP.
همچنین گزینهٔ ویژهٔ \fB\-root\fP برای دریافت سریع اطلاعات پنجرهٔ ریشهٔ (root window) صفحه نمایش وجود دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B "\-help"
چاپ خلاصه ساختار دستور (\[lq]Usage:\[rq]).
.TP 8
.B "\-id \fIwdid\fP"
این گزینه به کاربر امکان می‌دهد شناسه پنجرهٔ هدف \fIwdid\fP را در خط فرمان مشخص کند، به جای اینکه از موشواره برای انتخاب آن استفاده نماید. این ویژگی در اشکال‌زدایی برنامه‌های X که در آن‌ها پنجرهٔ هدف روی صفحه نگاشت (map) نشده است یا جاهایی که استفاده از موشواره ممکن نیست یا با برنامه تداخل ایجاد می‌کند، بسیار مفید است.
.TP 8
.B "\-name \fIwdname\fP"
این گزینه به کاربر امکان می‌دهد پنجره‌ای با نام \fIwdname\fP را به جای انتخاب با موشواره، مستقیماً از طریق خط فرمان به عنوان پنجرهٔ هدف مشخص کند.
.TP 8
.B "\-root"
این گزینه تعیین می‌کند که پنجرهٔ ریشهٔ X پنجرهٔ هدف است. این حالت در شرایطی که پنجرهٔ ریشه کاملاً پوشانده شده باشد کاربرد دارد.
.TP 8
.B "\-int"
این گزینه تعیین می‌کند که تمامی شناسه‌های پنجره‌های X به عنوان مقادیر صحیح ده‌دهی (decimal) نمایش داده شوند. حالت پیش‌فرض نمایش آن‌ها به صورت مقادیر شانزده‌شانزدهی (hexadecimal) است.
.TP 8
.B \-children
این گزینه باعث نمایش شناسه‌ها و نام‌های پنجره‌های ریشه، والد و فرزندانِ پنجرهٔ انتخاب‌شده می‌شود.
.TP 8
.B \-tree
این گزینه مشابه \fB\-children\fP است ولی تمام پنجره‌های فرزند را به صورت بازگشتی نمایش می‌دهد.
.TP 8
.B \-stats
این گزینه ویژگی‌های گوناگون مربوط به مکان و مشخصات ظاهری پنجرهٔ انتخاب‌شده را نمایش می‌دهد. اطلاعات نمایش‌داده‌شده شامل موقعیت پنجره، عرض و ارتفاع، عمق رنگ (depth)، ضخامت حاشیه (border width)، شناسه و کلاس visual، شناسه colormap در صورت وجود، وضعیت نگاشت (map state)، راهنمای backing-store و موقعیت گوشه‌ها است.
.TP 8
.B \-bits
این گزینه ویژگی‌های مختلف مربوط به بیت‌های خام پنجرهٔ انتخاب‌شده و چگونگی ذخیره‌سازی آن را نمایش می‌دهد. اطلاعات ارائه‌شده شامل bit gravity پنجره، window gravity، راهنمای backing-store، مقدار backing-planes، مقدار backing pixel، و وضعیت فعال بودن یا نبودن save-under است.
.TP 8
.B \-events
این گزینه ماسک‌های رویداد (event masks) پنجرهٔ انتخاب‌شده را نمایش می‌دهد؛ هم ماسک رویدادهای درخواستی توسط کلاینت‌ها و هم ماسک رویدادهایی که نباید منتشر شوند (not to propagate) نمایش داده می‌شوند.
.TP 8
.B \-size
این گزینه راهنماهای اندازه (sizing hints) پنجرهٔ انتخاب‌شده را نمایش می‌دهد. اطلاعات نمایش‌داده‌شده هم برای اندازه‌های عادی و هم بزرگ‌نمایی (zoom) شامل این موارد است: موقعیت تعیین‌شده توسط کاربر در صورت وجود؛ موقعیت تعیین‌شده توسط برنامه در صورت وجود؛ اندازه تعیین‌شده توسط کاربر در صورت وجود؛ اندازه تعیین‌شده توسط برنامه در صورت وجود؛ حداقل اندازه؛ حداکثر اندازه؛ گام‌های تغییر اندازه (resize increments)؛ و حداقل و حداکثر نسبت تصویر (aspect ratio) در صورت وجود.
.TP 8
.B \-wm
این گزینه باعث نمایش راهنماهای مدیر پنجره (window manager hints) برای پنجرهٔ انتخاب‌شده می‌شود. اطلاعات نمایش‌داده‌شده می‌تواند شامل پذیرش یا عدم پذیرش ورودی توسط برنامه، شماره و نام پنجرهٔ آیکون، محل قرارگیری آیکون پنجره، و وضعیت اولیه پنجره باشد.
.TP 8
.B \-shape
این گزینه ابعاد و محدودهٔ شکل (shape extents) پنجره و حاشیهٔ پنجرهٔ انتخاب‌شده را نمایش می‌دهد.
.TP 8
.B \-frame
این گزینه باعث می‌شود هنگام انتخاب دستی پنجره‌ها، قاب‌های مدیر پنجره (window manager frames) نیز در نظر گرفته شوند.
.TP 8
.B \-metric
این گزینه باعث می‌شود تمام مقادیر ارتفاع، عرض، و موقعیت‌های x و y علاوه بر تعداد پیکسل، بر اساس وضوحی که کارگزار (server) در نظر دارد، به میلی‌متر نیز نمایش داده شوند. مشخصات هندسی که در قالب \fI+x+y\fP هستند تغییر نمی‌کنند.
.TP 8
.B \-english
این گزینه باعث می‌شود تمامی مقادیر ارتفاع، عرض، و موقعیت‌های x و y علاوه بر تعداد پیکسل، بر حسب اینچ (و در صورت لزوم فوت، یارد و مایل) نمایش داده شوند. گزینه‌های \fB\-metric\fP و \fB\-english\fP می‌توانند به طور هم‌زمان فعال باشند.
.TP 8
.B \-all
این گزینه روشی سریع برای درخواست تمامی اطلاعات ممکن است. برای دریافت تمام اطلاعات برای همهٔ پنجره‌ها از دستور \fB\-tree \-root \-all\fP استفاده کنید.
.TP 8
.B "\-d, \-display" \fIhost:dpy\fP
این گزینه کارگزاری را که باید به آن متصل شد مشخص می‌کند؛ نگاه کنید به
.BR X (7).
.TP 8
.B \-version
این گزینه مشخص می‌کند که
.I xwininfo
باید اطلاعات نسخهٔ خود را چاپ کرده و خارج شود.
.SH "مثال‌ها (EXAMPLES)"
در ادامه نمونه‌ای از خلاصه اطلاعات ارائه‌شده بدون تعیین هیچ گزینه‌ای آمده است:
.sp
.nf
xwininfo: Window id: 0x60000f "xterm"
.sp
  Absolute upper-left X: 2
  Absolute upper-left Y: 85
  Relative upper-left X:  0
  Relative upper-left Y:  25
  Width: 579
  Height: 316
  Depth: 8
  Visual: 0x1e
  Visual Class: PseudoColor
  Border width: 0
  Class: InputOutput
  Colormap: 0x27 (installed)
  Bit Gravity State: NorthWestGravity
  Window Gravity State: NorthWestGravity
  Backing Store State: NotUseful
  Save Under State: no
  Map State: IsViewable
  Override Redirect State: no
  Corners:  +2+85  -699+85  -699-623  +2-623
  -geometry 80x24+0+58
.fi
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت میزبان پیش‌فرض و شمارهٔ نمایشگر (display number).
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xprop (1),
.BR xdpyinfo (1),
.BR xdriinfo (1),
.BR xvinfo (1),
.BR glxinfo (1)
.SH "گزارش باگ‌ها (BUGS)"
استفاده هم‌زمان از \fB\-stats \-bits\fP برخی اطلاعات تکراری را نمایش می‌دهد.
.PP
رشتهٔ \fB\-geometry\fP نمایش‌داده‌شده ناچار است فرضیاتی را در رابطه با پهنای حاشیهٔ پنجره و رفتار برنامه و مدیر پنجره در نظر بگیرد؛ در نتیجه، مکان ارائه‌شده همواره دقیق نیست.
.SH "نویسندگان (AUTHORS)"
Mark Lillibridge, MIT Project Athena