نام (NAME)

pamx - نمایش تصویر Netpbm در پنجره X Window System

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

pamx

[-fullscreen] [-install] [-private] [-fit] [-pixmap] [-verbose] [-display=x-display] [-title=text] [-foreground=color] [-background=color] [-border=color] [-geometry=x-geometry-string] [-visual=name] netpbm_file

همه گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به جای یک خط تیره از دو خط تیره برای تعیین یک گزینه استفاده کنید. همچنین می‌توانید بین نام گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید.

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

دستور pamx یک تصویر Netpbm را در پنجره‌ای از X Window System نمایش می‌دهد. این ابزار مانند نسخه بسیار ساده‌ای از نمایشگر کلاسیک تصویر در X یعنی xloadimage عمل می‌کند.

اگر فایل ورودی netpbm_file را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود. تصویر ورودی می‌تواند در هر یک از قالب‌های تصویری Netpbm باشد. اگر ورودی یک جریان چندتصویری باشد، pamx همه تصاویر به جز تصویر اول را نادیده می‌گیرد.

ابزار pamx بهترین گزینه برای مشاهده عمومی تصاویر نیست، زیرا یک جزء سازنده ساده و سنتی در Netpbm به شمار می‌رود. این ابزار برای ادغام در برنامه‌های دیگر مناسب است و می‌تواند برای اشکال‌زدایی سیستم‌های پیچیده‌تر مفید باشد، اما نمایشگرهای بسیار قدرتمندتری در دسترس هستند که می‌توانند تصاویر Netpbm را نمایش دهند؛ به عنوان مثال xloadimage، xli، xzgv و هر مرورگر وب.

برنامه xwud (X Window Undump) بخشی از X Window System است و عملکرد نمایشی پایه‌ای مشابهی را انجام می‌دهد، هرچند ورودی آن در قالب ویژه X Window Dump است (که Netpbm مبدل‌هایی برای آن دارد).

اندازه پنجره اولیه حداکثر ۹۰٪ اندازه صفحه نمایش است، مگر اینکه مدیر پنجره درخواست‌های مربوط به اندازه پنجره را به درستی پردازش نکند یا از گزینه -fullscreen استفاده کرده باشید. می‌توانید با نگه‌داشتن و کشیدن کلید اول موشواره، تصویر را درون پنجره جابه‌جا کنید. نشانگر موشواره جهت‌هایی را که کشیدن به آن‌ها مجاز است (در صورت وجود) مشخص می‌کند. هنگامی که فوکوس صفحه‌کلید روی پنجره باشد، می‌توانید با فشردن کلید 'q' یا Control-C از پنجره خارج شوید.

برنامه ppmsvgalib برنامه‌ای مشابه است که یک تصویر را بدون نیاز به X Window System در یک سیستم لینوکس نمایش می‌دهد.

کلاس منابع اکس (X RESOURCE CLASS)

دستور pamx برای مدیران پنجره‌ای که به این مجموعه منبع نیاز دارند، از نام کلاس منبع Xloadimage استفاده می‌کند. این دقیقاً همان کلاس منبعی است که برنامه نمایشگر سنتی xloadimage استفاده می‌نماید.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به ویژه -quiet، ببینید گزینه‌های مشترک )، دستور pamx گزینه‌های خط فرمان زیر را به رسمیت می‌شناسد:

-border=color

رنگ بخش‌هایی از پس‌زمینه پنجره را که توسط هیچ تصویری پوشانده نشده است، به color تنظیم می‌کند.

-display=display_name

نام نمایشگر X را برای نمایش پنجره در آن مشخص می‌کند؛ به عنوان مثال 0:0.

-fit

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

-fullscreen

استفاده از تمام صفحه برای نمایش تصویر.

-geometry=WxH[{+,-}X{+,-}Y

اندازه و موقعیت پنجره‌ای را که pamx تصویر را در آن نمایش می‌دهد تعیین می‌کند.

به طور پیش‌فرض، اندازه پنجره دقیقاً منطبق بر اندازه تصویر است، به استثنای زمانی که -fullscreen را مشخص نکرده باشید؛ در این صورت حداکثر اندازه برابر با ۹۰٪ از ابعاد صفحه نمایش خواهد بود.

-install

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

-pixmap

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

-private

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

-verbose

باعث می‌شود pamx اطلاعات مختلفی درباره فرایندها و اقدامات در حال انجام را در خروجی خطای استاندارد (Standard Error) چاپ کند.

-visual=visual_name

اجبار به استفاده از یک نوع دیداری (visual type) مشخص برای نمایش تصویر. به طور پیش‌فرض، pamx تلاش می‌کند بهترین حالت ممکن را برای یک نوع تصویر ویژه انتخاب کند. انواع دیداری موجود عبارتند از: DirectColor، TrueColor، PseudoColor، StaticColor، GrayScale و StaticGray. می‌توانید از کوتاه‌ترین پیشوند یکتای این نام‌ها استفاده کنید؛ بزرگی و کوچکی حروف نیز اهمیتی ندارد.

-background=color

در صورتی که یک تصویر تک‌رنگ (monochrome) را به یک نمایشگر رنگی منتقل می‌کنید، از color به عنوان رنگ پس‌زمینه به جای مقدار پیش‌فرض (که معمولاً سفید است اما به نوع تصویر بستگی دارد) استفاده می‌کند.

-foreground=color

در صورتی که یک تصویر تک‌رنگ را به یک نمایشگر رنگی منتقل می‌کنید، از color به عنوان رنگ پیش‌زمینه به جای رنگ سیاه استفاده می‌کند. همچنین می‌توانید برای معکوس کردن رنگ‌های پیش‌زمینه و پس‌زمینه در یک تصویر تک‌رنگ از این گزینه بهره ببرید.

-title=text

تنظیم عنوان نوار عنوان پنجره. پیش‌فرض، نام فایل ورودی است یا در صورتی که تصویر از ورودی استاندارد باشد، عبارت "stdin" خواهد بود.

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

ppmsvgalib(1), pam(1), pnm(1), xzgv, xwud, xloadimage, xli

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

دستور pamx توسط برایان هندرسون (Bryan Henderson) در مارس ۲۰۰۶ و بر پایه برنامه xloadimage اثر جیم فراست (Jim Frost، شرکت Centerline Software، به نشانی jimf@centerline.com، ۱۹۸۹–۱۹۹۳) توسعه یافته است.

کد جیم شامل یادداشت حق تکثیر و مجوز زیر بود:

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

تاریخچه (HISTORY)

ابزار pamx در نسخه 10.34 از Netpbm (مه ۲۰۰۶) برای نخستین بار معرفی شد.

دستور pamx در اصل مبتنی بر برنامه کلاسیک نمایشگر X یعنی xloadimage اثر جیم فراست (۱۹۸۹) است. برایان هندرسون در مارس ۲۰۰۶ آن را ساده‌سازی کرد و برای Netpbm تطبیق داد.

ویژگی‌های زیر از xloadimage در pamx حذف شده‌اند تا با فلسفه Netpbm مبنی بر اجزای سازنده ساده و مستقل سازگارتر باشند. توجه داشته باشید که برنامه‌های دیگری در Netpbm وجود دارند که اکثر این قابلیت‌ها را پوشش می‌دهند:

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

  برنامه pamx همچنین از این جهت با xloadimage تفاوت دارد که از کتابخانه Libnetpbm استفاده می‌کند.

در واقعیت تقریباً هیچ کدی از xloadimage در pamx باقی نمانده است، زیرا برایان تمام آن را مجدداً بازنویسی کرد تا درک کد ساده‌تر شود.

منبع سند (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:

http://netpbm.sourceforge.net/doc/pamx.html