نام (NAME)

xwininfo - ابزار دریافت اطلاعات پنجره برای X

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

xwininfo [-help] [-id wdid] [-root] [-name wdname] [-int]
         [-children] [-tree] [-stats] [-bits] [-events] [-size] [-wm]
         [-shape] [-frame] [-all]
         [-english] [-metric]
         [-display host:dpy] [-version]

توضیحات (DESCRIPTION)

دستور xwininfo ابزاری برای نمایش اطلاعات درباره پنجره‌ها است. بسته به گزینه‌های انتخاب‌شده، اطلاعات گوناگونی نمایش داده می‌شود. چنانچه گزینه‌ای مشخص نشود، فرض بر -stats است.

کاربر می‌تواند پنجرهٔ هدف را با موشواره انتخاب کند (با کلیک روی هر یک از کلیدهای موشواره در پنجرهٔ مورد نظر)، یا با مشخص کردن شناسهٔ پنجره در خط فرمان با گزینهٔ -id، یا با مشخص کردن نام پنجره با گزینهٔ -name. همچنین گزینهٔ ویژهٔ -root برای دریافت سریع اطلاعات پنجرهٔ ریشهٔ (root window) صفحه نمایش وجود دارد.

گزینه‌ها (OPTIONS)

-help: چاپ خلاصه ساختار دستور (“Usage:”).
-id wdid: این گزینه به کاربر امکان می‌دهد شناسه پنجرهٔ هدف wdid را در خط فرمان مشخص کند، به جای اینکه از موشواره برای انتخاب آن استفاده نماید. این ویژگی در اشکال‌زدایی برنامه‌های X که در آن‌ها پنجرهٔ هدف روی صفحه نگاشت (map) نشده است یا جاهایی که استفاده از موشواره ممکن نیست یا با برنامه تداخل ایجاد می‌کند، بسیار مفید است.
-name wdname: این گزینه به کاربر امکان می‌دهد پنجره‌ای با نام wdname را به جای انتخاب با موشواره، مستقیماً از طریق خط فرمان به عنوان پنجرهٔ هدف مشخص کند.
-root: این گزینه تعیین می‌کند که پنجرهٔ ریشهٔ X پنجرهٔ هدف است. این حالت در شرایطی که پنجرهٔ ریشه کاملاً پوشانده شده باشد کاربرد دارد.
-int: این گزینه تعیین می‌کند که تمامی شناسه‌های پنجره‌های X به عنوان مقادیر صحیح ده‌دهی (decimal) نمایش داده شوند. حالت پیش‌فرض نمایش آن‌ها به صورت مقادیر شانزده‌شانزدهی (hexadecimal) است.
-children: این گزینه باعث نمایش شناسه‌ها و نام‌های پنجره‌های ریشه، والد و فرزندانِ پنجرهٔ انتخاب‌شده می‌شود.
-tree: این گزینه مشابه -children است ولی تمام پنجره‌های فرزند را به صورت بازگشتی نمایش می‌دهد.
-stats: این گزینه ویژگی‌های گوناگون مربوط به مکان و مشخصات ظاهری پنجرهٔ انتخاب‌شده را نمایش می‌دهد. اطلاعات نمایش‌داده‌شده شامل موقعیت پنجره، عرض و ارتفاع، عمق رنگ (depth)، ضخامت حاشیه (border width)، شناسه و کلاس visual، شناسه colormap در صورت وجود، وضعیت نگاشت (map state)، راهنمای backing-store و موقعیت گوشه‌ها است.
-bits: این گزینه ویژگی‌های مختلف مربوط به بیت‌های خام پنجرهٔ انتخاب‌شده و چگونگی ذخیره‌سازی آن را نمایش می‌دهد. اطلاعات ارائه‌شده شامل bit gravity پنجره، window gravity، راهنمای backing-store، مقدار backing-planes، مقدار backing pixel، و وضعیت فعال بودن یا نبودن save-under است.
-events: این گزینه ماسک‌های رویداد (event masks) پنجرهٔ انتخاب‌شده را نمایش می‌دهد؛ هم ماسک رویدادهای درخواستی توسط کلاینت‌ها و هم ماسک رویدادهایی که نباید منتشر شوند (not to propagate) نمایش داده می‌شوند.
-size: این گزینه راهنماهای اندازه (sizing hints) پنجرهٔ انتخاب‌شده را نمایش می‌دهد. اطلاعات نمایش‌داده‌شده هم برای اندازه‌های عادی و هم بزرگ‌نمایی (zoom) شامل این موارد است: موقعیت تعیین‌شده توسط کاربر در صورت وجود؛ موقعیت تعیین‌شده توسط برنامه در صورت وجود؛ اندازه تعیین‌شده توسط کاربر در صورت وجود؛ اندازه تعیین‌شده توسط برنامه در صورت وجود؛ حداقل اندازه؛ حداکثر اندازه؛ گام‌های تغییر اندازه (resize increments)؛ و حداقل و حداکثر نسبت تصویر (aspect ratio) در صورت وجود.
-wm: این گزینه باعث نمایش راهنماهای مدیر پنجره (window manager hints) برای پنجرهٔ انتخاب‌شده می‌شود. اطلاعات نمایش‌داده‌شده می‌تواند شامل پذیرش یا عدم پذیرش ورودی توسط برنامه، شماره و نام پنجرهٔ آیکون، محل قرارگیری آیکون پنجره، و وضعیت اولیه پنجره باشد.
-shape: این گزینه ابعاد و محدودهٔ شکل (shape extents) پنجره و حاشیهٔ پنجرهٔ انتخاب‌شده را نمایش می‌دهد.
-frame: این گزینه باعث می‌شود هنگام انتخاب دستی پنجره‌ها، قاب‌های مدیر پنجره (window manager frames) نیز در نظر گرفته شوند.
-metric: این گزینه باعث می‌شود تمام مقادیر ارتفاع، عرض، و موقعیت‌های x و y علاوه بر تعداد پیکسل، بر اساس وضوحی که کارگزار (server) در نظر دارد، به میلی‌متر نیز نمایش داده شوند. مشخصات هندسی که در قالب +x+y هستند تغییر نمی‌کنند.
-english: این گزینه باعث می‌شود تمامی مقادیر ارتفاع، عرض، و موقعیت‌های x و y علاوه بر تعداد پیکسل، بر حسب اینچ (و در صورت لزوم فوت، یارد و مایل) نمایش داده شوند. گزینه‌های -metric و -english می‌توانند به طور هم‌زمان فعال باشند.
-all: این گزینه روشی سریع برای درخواست تمامی اطلاعات ممکن است. برای دریافت تمام اطلاعات برای همهٔ پنجره‌ها از دستور -tree -root -all استفاده کنید.
-d, -display host:dpy: این گزینه کارگزاری را که باید به آن متصل شد مشخص می‌کند؛ نگاه کنید به X(7).
-version: این گزینه مشخص می‌کند که xwininfo باید اطلاعات نسخهٔ خود را چاپ کرده و خارج شود.

مثال‌ها (EXAMPLES)

در ادامه نمونه‌ای از خلاصه اطلاعات ارائه‌شده بدون تعیین هیچ گزینه‌ای آمده است:

xwininfo: Window id: 0x60000f "xterm"
  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

محیط (ENVIRONMENT)

DISPLAY: برای دریافت میزبان پیش‌فرض و شمارهٔ نمایشگر (display number).

همچنین ببینید (SEE ALSO)

X(7), xprop(1), xdpyinfo(1), xdriinfo(1), xvinfo(1), glxinfo(1)

گزارش باگ‌ها (BUGS)

استفاده هم‌زمان از -stats -bits برخی اطلاعات تکراری را نمایش می‌دهد.

رشتهٔ -geometry نمایش‌داده‌شده ناچار است فرضیاتی را در رابطه با پهنای حاشیهٔ پنجره و رفتار برنامه و مدیر پنجره در نظر بگیرد؛ در نتیجه، مکان ارائه‌شده همواره دقیق نیست.

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

Mark Lillibridge, MIT Project Athena