\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Xwdtopnm User Manual" 0 "08 January 2010" "netpbm documentation"

.SH "نام (NAME)"
xwdtopnm \- تبدیل فایل روگرفت پنجره X11 یا X10 به تصویر PNM

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBxwdtopnm\fP
[\fB-verbose\fP]
[\fB-headerdump\fP]
[\fIxwdfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBxwdtopnm\fP یک فایل روگرفت پنجره X11 یا X10 را به عنوان ورودی خوانده و یک تصویر PNM در خروجی تولید می‌کند. نوع تصویر خروجی به فایل ورودی بستگی دارد \- اگر تصویر ورودی سیاه و سفید باشد، خروجی PBM خواهد بود؛ اگر در مقیاس خاکستری باشد، خروجی PGM است؛ در غیر این صورت خروجی PPM خواهد بود. برنامه مشخص می‌کند که در حال نوشتن کدام نوع است.
.PP
با استفاده از این برنامه می‌توانید هر آنچه را که بر روی نمایشگر یک ایستگاه کاری X قابل مشاهده است، به یک تصویر PNM تبدیل کنید. کافی است محتوای مد نظر خود را نمایش دهید، برنامه \fBxwd\fP را برای تصویربرداری از پنجره اجرا کنید، آن را به \fBxwdtopnm\fP ارسال نمایید، و سپس با استفاده از \fBpamcut\fP بخش دلخواه خود را برش دهید.
.PP
توجه داشته باشید که یک تصویر XWD با رنگ کاذب (pseudocolor) (که معمولاً از تهیه روگرفت از پنجره‌های رنگ کاذب X به دست می‌آید) دارای مقدار maxval برابر با ۶۵۵۳۵ است؛ این یعنی فایل PNM تولیدشده توسط \fBxwdtopnm\fP نیز دارای maxval برابر با ۶۵۵۳۵ خواهد بود. بسیاری از برنامه‌های پردازش تصویر قدیمی‌تر (که بخشی از بسته Netpbm نبوده و از کتابخانه برنامه‌نویسی Netpbm استفاده نمی‌کنند) نحوه کار با تصاویر PNM با maxval بزرگتر از ۲۵۵ را پشتیبانی نمی‌کنند (زیرا در تصویر برای هر نمونه به جای یک بایت، دو بایت اختصاص یافته است). بنابراین شاید لازم باشد خروجی \fBxwdtopnm\fP را پیش از ارسال به این برنامه‌های قدیمی، از طریق \fBpamdepth\fP تبدیل کنید.
.PP
برنامه \fBxwdtopnm\fP توانایی تبدیل تمامی انواع تصاویر XWD را ندارد (به این معنا که نمی‌تواند تصویر XWD تولیدشده از هر نوع پیکربندی نمایشگر X را تبدیل کند). به‌ویژه، قادر به تبدیل تصاویری با بیش از ۲۴ بیت در هر پیکسل نیست.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمامی برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، رجوع کنید به
.UR index.html#commonoptions
 گزینه‌های مشترک
.UE
\&)، دستور \fBxwdtopnm\fP گزینه‌های خط فرمان زیر را می‌شناسد:


.TP
\fB-verbose\fP
این گزینه باعث می‌شود \fBxwdtopnm\fP اطلاعات مفیدی را درباره تصویر ورودی و فرایند تبدیل نمایش دهد.

.TP
\fB-headerdump\fP
این گزینه باعث می‌شود \fBxwdtopnm\fP محتوای سرایند (header) مربوط به X11 را نمایش دهد. در صورتی که ورودی از نوع X10 باشد، این گزینه تأثیری ندارد. این گزینه در Netpbm 10.26 (دسامبر ۲۰۰۴) اضافه شد.


.UN notes
.SH "نکات (NOTES)"

.UN twobytesamples
.SS نمونه‌های دو بایتی (Two Byte Samples)
.PP
برنامه \fBxwdtopnm\fP گاهی اوقات خروجی‌هایی با maxval بزرگتر از ۲۵۵ تولید می‌کند؛ این بدان معناست که بیشینه مقدار یک نمونه (یک مقدار شدت نور، مانند مؤلفه قرمز یک پیکسل) بیشتر از ۲۵۵ است و در نتیجه برای نمایش هر نمونه ۲ بایت مصرف می‌شود. این وضعیت می‌تواند مشکل‌آفرین باشد، چرا که برخی برنامه‌ها بایت‌ها را در ترتیبی متفاوت با مشخصات قالب‌های Netpbm (که \fBxwdtopnm\fP بر اساس آن خروجی می‌دهد) انتظار دارند، و این امر باعث می‌شود رنگ‌ها را به کلی نادرست مشاهده کنند. برنامه \fBxv\fP یکی از این برنامه‌ها است.
.PP
در صورتی که این مورد مشکل‌ساز شود (برای نمونه زمانی که بخواهید خروجی \fBxwdtopnm\fP را در برنامه \fBxv\fP ببینید)، دو راهکار برای حل آن وجود دارد:


.IP \(bu
خروجی را از طریق \fBpamendian\fP عبور دهید تا ترتیب بایت مورد نظر برنامه را تولید کند.
.IP \(bu
خروجی را از طریق \fBpamdepth\fP پردازش کنید تا maxval به مقداری کمتر از ۲۵۶ کاهش یابد و در هر نمونه فقط یک بایت مصرف شود.

.PP
اغلب اوقات، دلیل فنی خاصی برای استفاده از maxval بزرگتر از ۲۵۵ وجود ندارد. این حالت به این دلیل رخ می‌دهد که در XWD (برخلاف PNM)، هر یک از مؤلفه‌های رنگی یک پیکسل می‌توانند وضوح و تفکیک‌پذیری متفاوتی داشته باشند؛ به عنوان مثال ۵ بیت برای آبی (maxval برابر ۳۱)، ۵ بیت برای قرمز (maxval برابر ۳۱) و ۶ بیت برای سبز (maxval برابر ۶۳) که در کل ۱۶ بیت برای هر پیکسل می‌شود. جهت بازتولید رنگ‌ها با بیشترین دقت ممکن، \fBxwdtopnm\fP ناچار است از مقدار maxval بزرگی استفاده نماید. در این مثال، از maxval برابر با ۳۱ * ۶۳ = ۱۹۵۳ استفاده می‌شود که نیازمند دو بایت به ازای هر نمونه و در مجموع ۴۸ بیت برای هر پیکسل خواهد بود.
.PP
به دلیل آن که این مسئله یکی از مشکلات رایج و دردسرساز در زمان استفاده از \fBxwdtopnm\fP است، برنامه هرگاه خروجی با نمونه‌های دو بایتی تولید کند، یک پیام هشدار صادر می‌نماید. می‌توانید این هشدار را با استفاده از گزینه عمومی \fB-quiet\fP
.UR index.html#commonoptions
(گزینه‌های مشترک)
.UE
\& غیرفعال کنید. این هشدار در Netpbm 10.46 (مارس ۲۰۰۹) معرفی شد.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmtoxwd" (1)\c
\&،
.BR "pamendian" (1)\c
\&،
.BR "pamdepth" (1)\c
\&،
.BR "pnm" (1)\c
\&،
صفحه راهنمای \fBxwd\fP

.UN author
.SH "نویسندگان (AUTHORS)"

حق نشر (C) ۱۹۸۹، ۱۹۹۱ متعلق به Jef Poskanzer.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما از کد منبع HTML و به وسیله ابزار makeman متعلق به Netpbm تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/xwdtopnm.html
.PP