.\" 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 XWUD 1 2025-04-12 "xwud 1.0.8" "X Version 11"
.SH "نام (NAME)"
xwud \- نمایش‌دهنده تصویر برای X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxwud\fP [\fB\-in\fP \fIfile\fP] [\fB\-noclick\fP] [\fB\-geometry\fP \fIgeom\fP] [\fB\-display\fP \fIdisplay\fP]
     [\fB\-new\fP] [\fB\-std\fP \fImaptype\fP] [\fB\-raw\fP] [\fB\-vis\fP \fIvis-type-or-id\fP] [\fB\-scale\fP]
     [\fB\-help\fP] [\fB\-rv\fP] [\fB\-plane\fP \fInumber\fP] [\fB\-fg\fP \fIcolor\fP] [\fB\-bg\fP \fIcolor\fP]
     [\fB\-dumpheader\fP] [\fB\-version\fP]
.fi
.SH "توضیحات (DESCRIPTION)"
.B Xwud
یک ابزار بازیابی و نمایش تصویر (undumping) برای سیستم پنجره X است.
.B Xwud
به کاربران X امکان می‌دهد تصویری را که در یک فایل رونوشت (dump) با قالب‌بندی خاص ذخیره شده است (مانند تصاویری که توسط
.BR xwd (1)
تولید می‌شوند)، در یک پنجره نمایش دهند.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B "\-bg \fIcolor\fP"
اگر یک تصویر بیت‌مپ (یا یک صفحه منفرد از یک تصویر) نمایش داده شود، می‌توان از این گزینه برای تعیین رنگ نمایش بیت‌های "0" در تصویر استفاده کرد.
.TP 8
.B "\-display \fIdisplay\fP"
این گزینه به شما اجازه می‌دهد کارگزاری را که باید به آن متصل شوید مشخص کنید؛
.BR X (7)
را ببینید.
.TP 8
.B \-dumpheader
این گزینه تنها اطلاعات سرآیند XWD را چاپ می‌کند. هیچ چیزی نمایش داده نمی‌شود.
.TP 8
.B "\-fg \fIcolor\fP"
اگر یک تصویر بیت‌مپ (یا یک صفحه منفرد از یک تصویر) نمایش داده شود، می‌توان از این گزینه برای تعیین رنگ نمایش بیت‌های "1" در تصویر استفاده کرد.
.TP 8
.B "\-geometry \fIgeom\fP"
این گزینه به شما امکان می‌دهد اندازه و موقعیت پنجره را مشخص کنید. به‌طور معمول فقط تعیین موقعیت لازم است و اندازه به‌صورت پیش‌فرض برابر با اندازه واقعی تصویر در نظر گرفته می‌شود.
.TP 8
.B "\-help"
چاپ توضیح کوتاهی از گزینه‌های مجاز.
.TP 8
.B "\-in \fIfile\fP"
این گزینه به کاربر امکان می‌دهد فایل ورودی را صراحتاً در خط فرمان مشخص کند. اگر هیچ فایل ورودی داده نشود، ورودی استاندارد فرض می‌شود.
.TP 8
.B \-new
این گزینه ایجاد یک نقشه رنگ (colormap) جدید را برای نمایش تصویر اجباری می‌کند. اگر مشخصات تصویر با نمایشگر مطابقت داشته باشد، این کار می‌تواند نمایش تصویر روی صفحه را سریع‌تر کند، اما به بهای استفاده از یک نقشه رنگ جدید (که در نمایشگرهای PseudoColor ممکن است باعث شود پنجره‌های دیگر با رنگ‌های اشتباه نمایش داده شوند).
.TP 8
.B "\-noclick"
کلیک کردن روی هر دکمه‌ای در پنجره، برنامه را خاتمه می‌دهد، مگر اینکه این گزینه مشخص شده باشد. خروج از برنامه همیشه با فشردن کلیدهای 'q'، 'Q' یا ctrl-c امکان‌پذیر است.
.TP 8
.B "\-plane \fInumber\fP"
با این گزینه می‌توانید یک صفحه بیتی منفرد از تصویر را برای نمایش انتخاب کنید. شماره‌گذاری صفحه‌ها با در نظر گرفتن صفر به عنوان کم‌ارزش‌ترین بیت انجام می‌شود.
.TP 8
.B \-raw
این گزینه تصویر را وادار می‌کند تا با مقادیر رنگی که در حال حاضر روی صفحه وجود دارند نمایش داده شود. این گزینه بیشتر زمانی مفید است که تصویر را مجدداً روی همان صفحه‌ای بازیابی کنید که تصویر در اصل از آن آمده است، در حالی که پنجره‌های اصلی هنوز روی صفحه باز هستند، و این امر منجر به نمایش سریع‌تر تصویر روی صفحه می‌شود.
.TP 8
.B \-rv
اگر یک تصویر بیت‌مپ (یا یک صفحه منفرد از یک تصویر) نمایش داده شود، این گزینه رنگ‌های پیش‌زمینه و پس‌زمینه را جابه‌جا (معکوس) می‌کند. این کار ممکن است هنگام نمایش تصویر بیت‌مپی لازم باشد که مفهوم رنگی مقادیر پیکسل‌های "0" و "1" در آن برعکس نمایشگر شماست.
.TP 8
.B \-scale
امکان تغییر اندازه پنجره را فراهم کرده و تصویر را به اندازه پنجره مقیاس‌بندی می‌کند.
.TP 8
.B "\-std \fImaptype\fP"
این گزینه باعث می‌شود تصویر با استفاده از نقشه رنگ استاندارد (Standard Colormap) مشخص‌شده نمایش داده شود. نام مشخصه (property) با تبدیل نوع به حروف بزرگ، افزودن پیشوند "RGB_" و پسوند "_MAP" به دست می‌آید. انواع معمول عبارتند از "best"، "default" و "gray". برای یکی از روش‌های ایجاد نقشه‌های رنگ استاندارد،
.BR xstdcmap (1)
را ببینید.
.TP 8
.B "\-version"
این گزینه باعث می‌شود
.I xwd
اطلاعات نگارش خود را چاپ کرده و خارج شود.
.TP 8
.B "\-vis \fIvis-type-or-id\fP"
این گزینه به شما امکان می‌دهد یک نمای بصری یا رده بصری خاص را مشخص کنید. حالت پیش‌فرض انتخاب "بهترین" مورد است. یک رده خاص را می‌توان تعیین کرد:
"StaticGray"، "GrayScale"، "StaticColor"، "PseudoColor"، "DirectColor" یا "TrueColor".
یا می‌توان "Match" را تعیین کرد، به این معنی که از همان رده تصویر مبدأ استفاده شود. در غیر این صورت، می‌توان یک شناسه بصری دقیق (مختص کارگزار) را به‌صورت یک عدد هگزادسیمال (با پیشوند "0x") یا یک عدد ده‌دهی مشخص کرد. سرانجام، می‌توان "default" را تعیین کرد، به این معنی که از همان رده نقشه رنگ پنجره ریشه (root window) استفاده شود. بزرگی و کوچکی حروف در هیچ‌کدام از این رشته‌ها اهمیت ندارد.
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت نمایشگر پیش‌فرض.
.SH "فایل‌ها (FILES)"
.TP 8
.B XWDFile.h
فایل تعریف قالب فایل رونوشت پنجره X (X Window Dump File).
.SH "گزارش باگ‌ها (BUGS)"
برنامه xwud در کارگزارهایی که فاقد افزونه BIG\-REQUESTS هستند، تصاویر بزرگ یا عمیق (deep) را چندان خوب مدیریت نمی‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR xwd (1),
.BR xstdcmap (1),
.BR X (7)
.SH "نویسندگان (AUTHORS)"
Bob Scheifler، کنسرسیوم X در MIT