.\" 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 "Pamx User Manual" 0 "02 July 2011" "netpbm documentation"

.SH "نام (NAME)"
pamx \- نمایش تصویر Netpbm در پنجره X Window System

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

\fBpamx\fP

[\fB-fullscreen\fP]
[\fB-install\fP]
[\fB-private\fP]
[\fB-fit\fP]
[\fB-pixmap\fP]
[\fB-verbose\fP]
[\fB-display=\fP\fIx-display\fP]
[\fB-title=\fP\fItext\fP]
[\fB-foreground=\fP\fIcolor\fP]
[\fB-background=\fP\fIcolor\fP]
[\fB-border=\fP\fIcolor\fP]
[\fB-geometry=\fP\fIx-geometry-string\fP]
[\fB-visual=\fP\fIname\fP] \fInetpbm_file\fP
.PP
همه گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به جای یک خط تیره از دو خط تیره برای تعیین یک گزینه استفاده کنید. همچنین می‌توانید بین نام گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamx\fP یک تصویر Netpbm را در پنجره‌ای از X Window System نمایش می‌دهد.
این ابزار مانند نسخه بسیار ساده‌ای از نمایشگر کلاسیک تصویر در X یعنی \fBxloadimage\fP عمل می‌کند.
.PP
اگر فایل ورودی \fInetpbm_file\fP را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود. تصویر ورودی می‌تواند در هر یک از قالب‌های تصویری Netpbm باشد. اگر ورودی یک جریان چندتصویری باشد، \fBpamx\fP همه تصاویر به جز تصویر اول را نادیده می‌گیرد.
.PP
ابزار \fBpamx\fP بهترین گزینه برای مشاهده عمومی تصاویر نیست، زیرا یک جزء سازنده ساده و سنتی در Netpbm به شمار می‌رود. این ابزار برای ادغام در برنامه‌های دیگر مناسب است و می‌تواند برای اشکال‌زدایی سیستم‌های پیچیده‌تر مفید باشد، اما نمایشگرهای بسیار قدرتمندتری در دسترس هستند که می‌توانند تصاویر Netpbm را نمایش دهند؛ به عنوان مثال \fBxloadimage\fP، \fBxli\fP، \fBxzgv\fP و هر مرورگر وب.
.PP
برنامه \fBxwud\fP (X Window Undump) بخشی از X Window System است و عملکرد نمایشی پایه‌ای مشابهی را انجام می‌دهد، هرچند ورودی آن در قالب ویژه X Window Dump است (که Netpbm مبدل‌هایی برای آن دارد).
.PP
اندازه پنجره اولیه حداکثر ۹۰٪ اندازه صفحه نمایش است، مگر اینکه مدیر پنجره درخواست‌های مربوط به اندازه پنجره را به درستی پردازش نکند یا از گزینه \fB-fullscreen\fP استفاده کرده باشید. می‌توانید با نگه‌داشتن و کشیدن کلید اول موشواره، تصویر را درون پنجره جابه‌جا کنید. نشانگر موشواره جهت‌هایی را که کشیدن به آن‌ها مجاز است (در صورت وجود) مشخص می‌کند. هنگامی که فوکوس صفحه‌کلید روی پنجره باشد، می‌توانید با فشردن کلید 'q' یا Control-C از پنجره خارج شوید.
.PP
برنامه \fBppmsvgalib\fP برنامه‌ای مشابه است که یک تصویر را بدون نیاز به X Window System در یک سیستم لینوکس نمایش می‌دهد.


.UN resource
.SH "کلاس منابع اکس (X RESOURCE CLASS)"
.PP
دستور \fBpamx\fP برای مدیران پنجره‌ای که به این مجموعه منبع نیاز دارند، از نام کلاس منبع \fBXloadimage\fP استفاده می‌کند. این دقیقاً همان کلاس منبعی است که برنامه نمایشگر سنتی \fBxloadimage\fP استفاده می‌نماید.


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


.TP
\fB-border=\fP\fIcolor\fP
رنگ بخش‌هایی از پس‌زمینه پنجره را که توسط هیچ تصویری پوشانده نشده است، به \fIcolor\fP تنظیم می‌کند.

.TP
\fB-display=\fP\fIdisplay_name\fP
نام نمایشگر X را برای نمایش پنجره در آن مشخص می‌کند؛ به عنوان مثال \fB0:0\fP.

.TP
\fB-fit\fP
تصویر را وادار می‌کند تا از دیداری (visual) و نقشه رنگ (colormap) پیش‌فرض استفاده کند. این گزینه در صورتی مفید است که نخواهید هنگام قرار گرفتن فوکوس نقشه رنگ روی پنجره تصویر، جلوه‌های تغییر ناگهانی رنگ رخ دهد؛ با این حال ممکن است کیفیت تصویر نمایش‌داده‌شده را کاهش دهد.

.TP
\fB-fullscreen\fP
استفاده از تمام صفحه برای نمایش تصویر.

.TP
\fB-geometry=\fP\fIW\fP\fBx\fP\fIH\fP[{\fB+\fP,\fB-\fP}\fIX\fP{\fB+\fP,\fB-\fP}\fIY\fP
اندازه و موقعیت پنجره‌ای را که \fBpamx\fP تصویر را در آن نمایش می‌دهد تعیین می‌کند.
.sp
به طور پیش‌فرض، اندازه پنجره دقیقاً منطبق بر اندازه تصویر است، به استثنای زمانی که \fB-fullscreen\fP را مشخص نکرده باشید؛ در این صورت حداکثر اندازه برابر با ۹۰٪ از ابعاد صفحه نمایش خواهد بود.

.TP
\fB-install\fP
هنگام فوکوس روی پنجره، نقشه رنگ تصویر را به اجبار نصب می‌کند. این کار استانداردهای ICCCM را نقض می‌کند و فقط برای کارکرد با مدیران پنجره ساده و ابتدایی وجود دارد. تنها زمانی از این گزینه استفاده کنید که مدیر پنجره شما نقشه‌های رنگ را به درستی مدیریت و نصب نمی‌کند.

.TP
\fB-pixmap\fP
استفاده اجباری از یک pixmap به عنوان حافظه پشتیبان (backing-store). این گزینه برای کارگزارهایی که عملکرد backing-store در آن‌ها مختل است (مانند برخی از نسخه‌های کارگزار AIXWindows) تعبیه شده است. این گزینه همچنین می‌تواند کارایی پیمایش (scrolling) را در کارگزارهایی که از backing-store پشتیبانی می‌کنند ارتقا دهد.

.TP
\fB-private\fP
وادار کردن \fBpamx\fP به استفاده از یک نقشه رنگ اختصاصی (private colormap). به طور پیش‌فرض، \fBpamx\fP رنگ‌ها را به صورت اشتراکی تخصیص می‌دهد مگر اینکه رنگ کافی در دسترس نباشد.

.TP
\fB-verbose\fP
باعث می‌شود \fBpamx\fP اطلاعات مختلفی درباره فرایندها و اقدامات در حال انجام را در خروجی خطای استاندارد (Standard Error) چاپ کند.

.TP
\fB-visual=\fP\fIvisual_name\fP
اجبار به استفاده از یک نوع دیداری (visual type) مشخص برای نمایش تصویر. به طور پیش‌فرض، \fBpamx\fP تلاش می‌کند بهترین حالت ممکن را برای یک نوع تصویر ویژه انتخاب کند. انواع دیداری موجود عبارتند از:
\fBDirectColor\fP، \fBTrueColor\fP، \fBPseudoColor\fP،
\fBStaticColor\fP، \fBGrayScale\fP و \fBStaticGray\fP.
می‌توانید از کوتاه‌ترین پیشوند یکتای این نام‌ها استفاده کنید؛ بزرگی و کوچکی حروف نیز اهمیتی ندارد.

.TP
\fB-background=\fP\fIcolor\fP
در صورتی که یک تصویر تک‌رنگ (monochrome) را به یک نمایشگر رنگی منتقل می‌کنید، از \fIcolor\fP به عنوان رنگ پس‌زمینه به جای مقدار پیش‌فرض (که معمولاً سفید است اما به نوع تصویر بستگی دارد) استفاده می‌کند.

.TP
\fB-foreground=\fP\fIcolor\fP
در صورتی که یک تصویر تک‌رنگ را به یک نمایشگر رنگی منتقل می‌کنید، از \fIcolor\fP به عنوان رنگ پیش‌زمینه به جای رنگ سیاه استفاده می‌کند. همچنین می‌توانید برای معکوس کردن رنگ‌های پیش‌زمینه و پس‌زمینه در یک تصویر تک‌رنگ از این گزینه بهره ببرید.

.TP
\fB-title=\fP\fItext\fP
تنظیم عنوان نوار عنوان پنجره. پیش‌فرض، نام فایل ورودی است یا در صورتی که تصویر از ورودی استاندارد باشد، عبارت "stdin" خواهد بود.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppmsvgalib" (1)\c
\&,
.BR "pam" (1)\c
\&,
.BR "pnm" (1)\c
\&,
\fBxzgv\fP,
\fBxwud\fP,
\fBxloadimage\fP,
\fBxli\fP


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
دستور \fBpamx\fP توسط برایان هندرسون (Bryan Henderson) در مارس ۲۰۰۶ و بر پایه برنامه \fBxloadimage\fP اثر جیم فراست (Jim Frost، شرکت Centerline Software، به نشانی jimf@centerline.com، ۱۹۸۹–۱۹۹۳) توسعه یافته است.
.PP
کد جیم شامل یادداشت حق تکثیر و مجوز زیر بود:

.RS
.PP
Copyright 1989, 1993 Jim Frost
   
.PP
بدین‌وسیله اجازه استفاده، رونوشت‌برداری، تغییر، توزیع و فروش این نرم‌افزار و مستندات آن برای هر منظوری بدون دریافت هزینه اعطا می‌شود، مشروط بر اینکه یادداشت حق تکثیر بالا در تمام نسخه‌ها درج شود و هر دو مورد اعلان حق تکثیر و این مجوزنامه در مستندات پشتیبان لحاظ شوند. نویسنده هیچ‌گونه ادعایی درباره مناسب بودن این نرم‌افزار برای هر هدفی ارائه نمی‌دهد. این نرم‌افزار «همان‌گونه که هست» (as is) و بدون ضمانت صریح یا ضمنی ارائه می‌گردد.
   
.PP
نویسنده هرگونه ضمانت را در رابطه با این نرم‌افزار، از جمله تمام ضمانت‌های ضمنی مربوط به قابلیت خرید و فروش یا تناسب با یک هدف خاص، سلب می‌کند. تحت هیچ شرایطی نویسنده در قبال خسارات ویژه، غیرمستقیم، تبعی یا هرگونه خسارت دیگری که ناشی از سلب حق استفاده، از بین رفتن داده‌ها یا سود باشد، چه در قالب یک دعوی قراردادی، سهل‌انگاری یا هر اقدام شبه‌جرم دیگر که مرتبط با استفاده یا عملکرد این نرم‌افزار باشد، مسئولیتی نخواهد داشت.

.RE
.PP
افراد بسیاری در پروژه Xloadimage مشارکت داشته‌اند که فهرست نام آن‌ها در فایل COPYRIGHT در کد منبع قرار دارد.


.UN history
.SH "تاریخچه (HISTORY)"
.PP
ابزار \fBpamx\fP در نسخه 10.34 از Netpbm (مه ۲۰۰۶) برای نخستین بار معرفی شد.
.PP
دستور \fBpamx\fP در اصل مبتنی بر برنامه کلاسیک نمایشگر X یعنی \fBxloadimage\fP اثر جیم فراست (۱۹۸۹) است. برایان هندرسون در مارس ۲۰۰۶ آن را ساده‌سازی کرد و برای Netpbm تطبیق داد.
.PP
ویژگی‌های زیر از \fBxloadimage\fP در \fBpamx\fP حذف شده‌اند تا با فلسفه Netpbm مبنی بر اجزای سازنده ساده و مستقل سازگارتر باشند. توجه داشته باشید که برنامه‌های دیگری در Netpbm وجود دارند که اکثر این قابلیت‌ها را پوشش می‌دهند:

.IP \(bu
بزرگ‌نمایی و کوچک‌نمایی (zoom in/out)
.IP \(bu
قابلیت پذیرش قالب‌هایی غیر از Netpbm
.IP \(bu
تبدیل‌ها و دگرگونی‌های تصویری (روشن‌سازی، برش، چرخش و غیره)
.IP \(bu
فشرده‌زدایی و دیگر رمزگشایی‌های داده‌های ورودی
.IP \(bu
قابلیت نمایش مستقیم روی پنجره ریشه (root window)
.IP \(bu
نمایش خودکار متوالی (اسلایدشو)


برنامه \fBpamx\fP همچنین از این جهت با \fBxloadimage\fP تفاوت دارد که از کتابخانه Libnetpbm استفاده می‌کند.
.PP
در واقعیت تقریباً هیچ کدی از \fBxloadimage\fP در \fBpamx\fP باقی نمانده است، زیرا برایان تمام آن را مجدداً بازنویسی کرد تا درک کد ساده‌تر شود.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamx.html
.PP