.TH XPR 1 2025-04-06 "xpr 1.2.1" "X Version 11"
.SH "نام (NAME)"
xpr \- چاپ رونوشت پنجره X
.SH "خلاصه دستور (SYNOPSIS)"
.B xpr
.RB [ \-device
.IR devtype ]
.RB [ \-scale
.IR scale ]
.br
.RB "    [" \-height
.IR inches ]
.RB [ \-width
.IR inches ]
.RB [ \-left
.IR inches ]
.RB [ \-top
.IR inches ]
.br
.RB "    [" \-header
.IR string ]
.RB [ \-trailer
.IR string ]
.RB [ \-landscape ]
.RB [ \-portrait ]
.br
.RB "    [" \-plane
.IR number ]
.RB [ \-gray ]
.RB [ \-rv ]
.RB [ \-compact ]
.br
.RB "    [" \-output
.IR filename ]
.RB [ \-append
.IR filename ]
.RB [ \-noff ]
.RB [ \-split
.IR n ]
.br
.RB "    [" \-papertype
.IR format ]
.RB [ \-pheight
.I size
.RI [ units ]]
.RB [ \-pwidth
.I size
.RI [ units ]]
.br
.RB "    [" \-psfig ]
.RB [ \-density
.IR dpi ]
.RB [ \-cutoff
.IR level ]
.RB [ \-noposition ]
.br
.RB "    [" \-gamma
.IR correction ]
.RB [ \-render
.IR algorithm ]
.RB [ \-slide ]
.RI [ filename ]
.sp
.B xpr
.BR \-help | \-version
.SH "توضیحات (DESCRIPTION)"
دستور
.B xpr
یک فایل رونوشت پنجره (dump) تولیدشده توسط
.BR xwd (1)
را به عنوان ورودی دریافت کرده و آن را برای خروجی روی چاپگرهای PostScript،
چاپگر صفحه‌ای IBM PP3812، HP LaserJet (یا سایر چاپگرهای PCL)
یا HP PaintJet قالب‌بندی می‌کند.
اگر هیچ آرگومان فایلی مشخص نشود، از ورودی استاندارد استفاده می‌شود.
به‌طور پیش‌فرض، \fBxpr\fP بزرگ‌ترین نمایش ممکن از پنجره را
در صفحهٔ خروجی چاپ می‌کند.
گزینه‌ها به کاربر امکان می‌دهند که سرصفحه و پانویس اضافه کند،
حاشیه‌ها را تعیین کند، مقیاس و جهت صفحه را تنظیم نماید،
و چندین رونوشت پنجره را به یک فایل خروجی واحد ضمیمه کند.
خروجی به خروجی استاندارد ارسال می‌شود مگر اینکه
.B \-output
مشخص شده باشد.
.sp 1
.ne 8
.B گزینه‌های دستور
.sp 1
.IP "\fB\-device\fP \fIdevtype\fP"
دستگاهی را که فایل روی آن چاپ خواهد شد مشخص می‌کند.
موارد پشتیبانی‌شده در حال حاضر:
.RS 12
.PD 0
.TP
.B ljet
سری \s-1HP\s+1 LaserJet و سایر دستگاه‌های تک‌رنگ PCL
مانند چاپگرهای ThinkJet، QuietJet، RuggedWriter، سری \s-1HP\s+12560
و سری \s-1HP\s+12930
.TP
.B pjet
HP PaintJet (حالت رنگی)
.TP
.B pjetxl
چاپگر گرافیکی رنگی HP PaintJet XL (حالت رنگی)
.TP
.B pp
IBM PP3812
.TP
.B ps
چاپگر PostScript
.PD
.RE
.IP
پیش‌فرض PostScript است.
\fB-device lw\fP (LaserWriter) معادل \fB-device ps\fP بوده و
تنها برای سازگاری با نسخه‌های پیشین ارائه شده است.
.IP "\fB\-scale\fP \fIscale\fP"
اندازهٔ پنجره را در صفحه تحت تأثیر قرار می‌دهد.
چاپگرهای PostScript و HP قادرند
هر بیت از نگاشت پیکسلی پنجره را به شبکه‌ای با اندازهٔ مشخص ترجمه کنند.
به عنوان مثال هر بیت ممکن است به یک شبکهٔ 3x3 ترجمه شود.
این مورد با \fB\-scale\fP \fI3\fP مشخص می‌شود.
به‌طور پیش‌فرض، پنجره با بزرگ‌ترین مقیاسی که
با توجه به جهت‌گیری تعیین‌شده در صفحه جا شود، چاپ می‌شود.
.IP "\fB\-height\fP \fIinches\fP"
حداکثر ارتفاع صفحه را بر حسب اینچ مشخص می‌کند.
.IP "\fB\-width\fP \fIinches\fP"
حداکثر پهنای صفحه را بر حسب اینچ مشخص می‌کند.
.IP "\fB\-left\fP \fIinches\fP"
حاشیهٔ چپ را بر حسب اینچ مشخص می‌کند.
مقادیر کسری مجاز هستند.
به‌طور پیش‌فرض، پنجره در مرکز صفحه قرار می‌گیرد.
.IP "\fB\-top\fP \fIinches\fP"
حاشیهٔ بالای تصویر را بر حسب اینچ مشخص می‌کند.
مقادیر کسری مجاز هستند.
.IP "\fB\-header\fP \fIstring\fP"
یک رشتهٔ سرصفحه را برای چاپ در بالای پنجره تعیین می‌کند.
.IP "\fB\-trailer\fP \fIstring\fP"
یک رشتهٔ پانویس را برای چاپ در پایین پنجره تعیین می‌کند.
.IP "\fB\-landscape\fP"
چاپ پنجره را در حالت افقی (landscape) اجباری می‌کند.
به‌طور پیش‌فرض، پنجره به‌گونه‌ای چاپ می‌شود که ضلع بزرگ‌تر آن
با ضلع بزرگ‌تر کاغذ هم‌راستا باشد.
.IP "\fB\-portrait\fP"
چاپ پنجره را در حالت عمودی (portrait) اجباری می‌کند.
به‌طور پیش‌فرض، پنجره به‌گونه‌ای چاپ می‌شود که ضلع بزرگ‌تر آن
با ضلع بزرگ‌تر کاغذ هم‌راستا باشد.
.IP "\fB\-plane\fP \fInumber\fP"
مشخص می‌کند که از کدام صفحهٔ بیتی (bit plane) در تصویر استفاده شود.
حالت پیش‌فرض، استفاده از کل تصویر و
نگاشت مقادیر به سیاه و سفید بر اساس شدت رنگ‌ها است.
.IP "\fB\-gray 2\fP | \fB3\fP | \fB4\fP"
به‌جای نگاشت دقیقاً به سیاه و سفید، از یک تبدیل طیف خاکستری سادهٔ 2x2، 3x3 یا 4x4 روی یک تصویر رنگی استفاده می‌کند.
این کار پهنا و ارتفاع مؤثر تصویر را
دو، سه یا چهار برابر می‌کند.
.IP "\fB\-rv\fP"
چاپ پنجره را در حالت تصویر معکوس (reverse video) اجباری می‌کند.
.IP "\fB\-compact\fP"
برای نمایش فشردهٔ پنجره‌هایی با تعداد زیادی پیکسل سفید،
از کدگذاری طول اجرا (run-length encoding) ساده استفاده می‌کند.
.IP "\fB\-output\fP \fIfilename\fP"
نام یک فایل خروجی را مشخص می‌کند.
اگر این گزینه مشخص نشود، از خروجی استاندارد استفاده می‌شود.
.IP "\fB\-append\fP \fIfilename\fP"
نام فایلی را مشخص می‌کند که قبلاً توسط \fBxpr\fP تولید شده است و این پنجره
باید به آن پیوست شود.
.IP "\fB\-noff\fP"
هنگامی که همراه با \fB\-append\fP مشخص شود، پنجره در همان صفحهٔ
پنجرهٔ قبلی چاپ خواهد شد.
.IP "\fB\-split\fP \fIn\fP"
این گزینه به کاربر امکان می‌دهد تا یک پنجره را روی چندین صفحه تقسیم کند.
این کار ممکن است برای پنجره‌های بسیار بزرگی لازم باشد که در غیر این صورت
باعث ایجاد بار اضافی روی چاپگر شده و صفحه را به شکلی نامفهوم چاپ می‌کنند.
.IP "\fB\-papertype\fP \fIformat\fP"
قالب کاغذ خروجی را مشخص می‌کند. موارد پشتیبانی‌شده در حال حاضر:
.RS 12
.PD 0
.TP
.B letter
اندازهٔ letter در ابعاد 8.5x11 اینچ
.TP
.B legal
اندازهٔ legal در ابعاد 8.5x14 اینچ.TP
.B A0
اندازهٔ A0 معادل 841x1189 میلی‌متر یا 33.11x46.81 اینچ
.TP
.B A1
اندازهٔ A1 معادل 594x841 میلی‌متر یا 23.39x33.11 اینچ
.TP
.B A2
اندازهٔ A2 معادل 420x594 میلی‌متر یا 16.54x23.39 اینچ
.TP
.B A3
اندازهٔ A3 معادل 297x420 میلی‌متر یا 11.69x16.54 اینچ
.TP
.B A4
اندازهٔ A4 معادل 210x297 میلی‌متر یا 8.27x11.69 اینچ
.TP
.B A5
اندازهٔ A5 معادل 148x210 میلی‌متر یا 5.83x8.27 اینچ
.TP
.B A6
اندازهٔ A6 معادل 105x148 میلی‌متر یا 4.13x5.83 اینچ
.TP
.B A7
اندازهٔ A7 معادل 74x105 میلی‌متر یا 2.91x4.13 اینچ
.TP
.B A8
اندازهٔ A8 معادل 52x74 میلی‌متر یا 2.05x2.91 اینچ
.TP
.B A9
اندازهٔ A9 معادل 37x52 میلی‌متر یا 1.46x2.05 اینچ
.TP
.B A10
اندازهٔ A10 معادل 26x37 میلی‌متر یا 1.02x1.46 اینچ
.TP
.B B0
اندازهٔ B0 معادل 1000x1414 میلی‌متر یا 39.37x55.67 اینچ
.TP
.B B1
اندازهٔ B1 معادل 707x1000 میلی‌متر یا 27.83x39.37 اینچ
.TP
.B B2
اندازهٔ B2 معادل 500x707 میلی‌متر یا 19.69x27.83 اینچ
.TP
.B B3
اندازهٔ B3 معادل 353x500 میلی‌متر یا 13.90x19.69 اینچ
.TP
.B B4
اندازهٔ B4 معادل 250x353 میلی‌متر یا 9.84x13.90 اینچ
.TP
.B B5
اندازهٔ B5 معادل 176x250 میلی‌متر یا 6.93x9.84 اینچ
.TP
.B B6
اندازهٔ B6 معادل 125x176 میلی‌متر یا 4.92x6.93 اینچ
.TP
.B B7
اندازهٔ B7 معادل 88x125 میلی‌متر یا 3.46x4.92 اینچ
.TP
.B B8
اندازهٔ B8 معادل 62x88 میلی‌متر یا 2.44x3.46 اینچ
.TP
.B B9
اندازهٔ B9 معادل 44x62 میلی‌متر یا 1.73x2.44 اینچ
.TP
.B B10
اندازهٔ B10 معادل 31x44 میلی‌متر یا 1.22x1.73 اینچ
.TP
.B C0
اندازهٔ C0 معادل 917x1297 میلی‌متر یا 36.10x51.06 اینچ
.TP
.B C1
اندازهٔ C1 معادل 648x917 میلی‌متر یا 25.51x36.10 اینچ
.TP
.B C2
اندازهٔ C2 معادل 458x648 میلی‌متر یا 18.03x25.51 اینچ
.TP
.B C3
اندازهٔ C3 معادل 324x458 میلی‌متر یا 12.76x18.03 اینچ
.TP
.B C4
اندازهٔ C4 معادل 229x324 میلی‌متر یا 9.02x12.76 اینچ
.TP
.B C5
اندازهٔ C5 معادل 162x229 میلی‌متر یا 6.38x9.02 اینچ
.TP
.B C6
اندازهٔ C6 معادل 114x162 میلی‌متر یا 4.49x6.38 اینچ
.TP
.B C7
اندازهٔ C7 معادل 81x114 میلی‌متر یا 3.19x4.49 اینچ
.TP
.B C8
اندازهٔ C8 معادل 57x81 میلی‌متر یا 2.24x3.19 اینچ
.TP
.B C9
اندازهٔ C9 معادل 40x57 میلی‌متر یا 1.57x2.24 اینچ
.TP
.B C10
اندازهٔ C10 معادل 28x40 میلی‌متر یا 1.10x1.57 اینچ
.PD
.RE
.IP "\fB\-pheight\fP \fIsize\fP [ \fIunits\fP ]"
این گزینه به کاربر امکان می‌دهد تا ارتفاع مشخصی را برای کاغذ تعیین کند.
واحد پیش‌فرض به اینچ (\fBin\fP) است،
اما می‌تواند با \fBcm\fP یا \fBmm\fP
به ترتیب برای سانتی‌متر یا میلی‌متر جایگزین شود.
.IP "\fB\-pwidth\fP \fIsize\fP [ \fIunits\fP ]"
این گزینه به کاربر امکان می‌دهد تا عرض مشخصی را برای کاغذ تعیین کند،
اما می‌تواند با \fBcm\fP یا \fBmm\fP
به ترتیب برای سانتی‌متر یا میلی‌متر جایگزین شود.
.IP "\fB\-psfig\fP"
از انتقال تصویر PostScript به مرکز صفحه جلوگیری می‌کند.
.IP "\fB\-density\fP \fIdpi\fP"
مشخص می‌کند چه تراکمی بر حسب نقطه در اینچ (DPI) باید توسط چاپگر HP استفاده شود.
.IP "\fB\-cutoff\fP \fIlevel\fP"
سطح شدتی را تغییر می‌دهد که در آن رنگ‌ها برای خروجی تک‌رنگ در چاپگر LaserJet به سیاه یا سفید نگاشت می‌شوند.
مقدار \fIlevel\fP به صورت درصدی از روشنایی کامل بیان می‌شود.
مقادیر کسری مجاز هستند.
.IP "\fB\-noposition\fP"
این گزینه باعث می‌شود تولید دستورهای سرآیند، پایان‌بخش و موقعیت‌دهی تصویر برای چاپگرهای LaserJet، PaintJet و PaintJet XL نادیده گرفته شود.
.IP "\fB\-gamma\fP \fIcorrection\fP"
این گزینه شدت رنگ‌های چاپ‌شده توسط چاپگر PaintJet XL را تغییر می‌دهد.
مقدار \fIcorrection\fP یک عدد ممیز شناور در بازهٔ 0.00 تا 3.00 است.
برای تعیین مقدار مناسب برای چاپگر خاص، به دفترچه راهنمای کاربر مراجعه کنید.
.IP "\fB\-render\fP \fIalgorithm\fP"
این گزینه به چاپگر PaintJet XL امکان می‌دهد تا تصویر را با بهترین موازنه بین کیفیت و کارایی رندر کند.
برای تعیین اینکه کدام \fIalgorithm\fPها در دسترس هستند، به دفترچه راهنمای کاربر مراجعه کنید.
.IP "\fB\-slide\fP"
این گزینه امکان چاپ روی طلق‌های شفاف را با استفاده از چاپگرهای PaintJet و PaintJet XL فراهم می‌کند.
.IP "\fB\-help\fP"
این گزینه اطلاعات نحوهٔ استفاده از برنامه را نمایش داده و خارج می‌شود.
.IP "\fB\-version\fP"
این گزینه اطلاعات نسخهٔ برنامه را نمایش داده و خارج می‌شود..SH "همچنین ببینید (SEE ALSO)"
.BR xdpr (1),
.BR xwd (1),
.BR xwud (1),
.BR X (7)
.SH "محدودیت‌ها (LIMITATIONS)"
پشتیبانی از خروجی PostScript در حال حاضر نمی‌تواند گزینه‌های \fB-append\fP،
\fB-noff\fP یا \fB-split\fP را مدیریت کند.
.PP
گزینهٔ \fB-compact\fP
.I تنها
برای خروجی PostScript پشتیبانی می‌شود.
این گزینه فضای سفید را فشرده می‌کند اما فضای سیاه را فشرده نمی‌کند،
بنابراین برای پنجره‌های ویدئوی معکوس (reverse-video) کاربردی ندارد.
.PP
برای تصاویر رنگی، باید مستقیماً با پشتیبانی تصویر در PostScript نگاشت شود.
.SH "چاپگرهای HP (HP PRINTERS)"
اگر هیچ \fB\-density\fP در خط فرمان مشخص نشده باشد،
۳۰۰ نقطه بر اینچ برای \fIljet\fP
و ۹۰ نقطه بر اینچ برای \fIpjet\fP فرض خواهد شد.
مقادیر مجاز \fIdensity\fP برای یک چاپگر LaserJet عبارتند از ۳۰۰، ۱۵۰، ۱۰۰
و ۷۵ نقطه بر اینچ.
برای تعیین تراکم‌های پشتیبانی‌شده توسط سایر چاپگرها
به دفترچه راهنمای کاربر مراجعه کنید.
.PP
اگر هیچ \fB\-scale\fP مشخص نشده باشد، تصویر برای جا گرفتن در ناحیهٔ
قابل چاپ صفحه گسترش داده خواهد شد.
.PP
ناحیهٔ قابل چاپ پیش‌فرض ۸x۱۰٫۵ اینچ است.
سایر اندازه‌های کاغذ را می‌توان با استفاده از گزینهٔ \fB\-papertype\fP
یا گزینه‌های \fB\-height\fP و \fB\-width\fP تنظیم کرد.
.PP
توجه داشته باشید که یک تصویر 1024x768 هنگامی که در 100 dpi با مقیاس scale=1 پردازش شود
در ناحیهٔ قابل چاپ پیش‌فرض جا می‌شود؛ همین تصویر می‌تواند با استفاده از 300 dpi
و scale=3 نیز چاپ شود اما نیازمند انتقال داده‌های بسیار بیشتری به
چاپگر خواهد بود.
.PP
\fBxpr\fP را می‌توان برای استفاده با چاپگرهای تک‌رنگ PCL غیر از
LaserJet نیز سفارشی‌سازی کرد.
برای چاپ روی ThinkJet (\s-1HP\s+12225A)، \fIxpr\fP را می‌توان بدین صورت فراخوانی کرد:
.sp
.RS 4
xpr -density 96 -width 6.667 \fIfilename\fP
.RE
.sp
یا برای خروجی سیاه‌وسفید روی PaintJet:
.sp
.RS 4
xpr -density 180 \fIfilename\fP
.RE
.PP
شدت روشنایی تک‌رنگ یک پیکسل به صورت
\fI0.30*R + 0.59*G + 0.11*B\fP محاسبه می‌شود.
اگر شدت روشنایی محاسبه‌شده برای یک پیکسل کمتر از سطح \fB\-cutoff\fP
باشد، به صورت سفید چاپ خواهد شد.
این کار تصاویر نمایشی روشن روی زمینه تاریک را به نسخهٔ چاپی سیاه روی زمینه سفید نگاشت می‌کند.
شدت cutoff پیش‌فرض ۵۰٪ از روشنایی کامل است.
مثال: مشخص کردن \fB\-cutoff 87.5\fP نقطهٔ
شدت سفید/سیاه را به ۸۷٫۵٪ از روشنایی کامل منتقل می‌کند.
.PP
یک چاپگر LaserJet باید با حافظهٔ کافی برای مدیریت تصویر
پیکربندی شده باشد.
برای یک صفحهٔ کامل در ۳۰۰ نقطه بر اینچ، تقریباً 2MB حافظهٔ
چاپگر مورد نیاز است.
.PP
تصاویر رنگی در PaintJet با ۹۰ نقطه بر اینچ تولید می‌شوند.
PaintJet در هر خط چاپ افقی به شانزده رنگ از پالت ۳۳۰ رنگی خود محدود است.
اگر در یک خط بیش از شانزده رنگ وجود داشته باشد، \fBxpr\fP
یک پیام هشدار صادر خواهد کرد.
\fBxpr\fP چاپگر PaintJet را برای شانزده رنگ اول مشاهده‌شده در هر خط برنامه‌ریزی می‌کند
و برای سایر رنگ‌های موجود در آن خط، از نزدیک‌ترین
مقدار برنامه‌ریزی‌شدهٔ منطبق استفاده می‌کند.
.PP
مشخص کردن گزینهٔ ویدئوی معکوس، \fB\-rv\fP، برای PaintJet باعث
تعویض سیاه و سفید در تصویر خروجی خواهد شد. هیچ رنگ دیگری
تغییر نمی‌کند.
.PP
تصاویر چندصفحه‌ای (Multiplane) باید توسط \fBxwd\fP در قالب \fBZPixmap\fP ثبت شوند.
تصاویر تک‌صفحه‌ای (تک‌رنگ) می‌توانند در هر یک از قالب‌های \fBXYPixmap\fP یا
\fBZPixmap\fP باشند.
.PP
برخی از چاپگرهای PCL دستورات موقعیت‌یابی تصویر را تشخیص نمی‌دهند.
خروجی این چاپگرها در صفحه در مرکز قرار نخواهد گرفت
و رشته‌های سربرگ و پاورقی ممکن است در جای مورد انتظار ظاهر نشوند.
.PP
گزینه‌های \fB\-gamma\fP و \fB-render\fP تنها در
چاپگرهای PaintJet XL پشتیبانی می‌شوند.
.PP
گزینهٔ \fB\-slide\fP برای چاپگرهای LaserJet پشتیبانی نمی‌شود.
.PP
گزینهٔ \fB\-split\fP برای چاپگرهای HP پشتیبانی نمی‌شود.
.PP
گزینهٔ \fB\-gray\fP برای چاپگرهای HP یا IBM پشتیبانی نمی‌شود..SH "نویسندگان (AUTHORS)"
Michael R. Gretzinger، MIT Project Athena،
Jose Capo، MIT Project Athena (پشتیبانی از PP3812)،
Marvin Solomon، University of Wisconsin،
Bob Scheifler، MIT، Angela Bock و E. Mike Durbin، Rich Inc. (طیف خاکستری)،
Larry Rupp، HP (پشتیبانی از چاپگرهای HP)،
Jay Hobson، Sun Microsystems (پشتیبانی از papertype).