\
.\" 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 "Pnmtopalm User Manual" 0 "25 August 2017" "netpbm documentation"

.SH "نام (NAME)"
pnmtopalm \- تبدیل تصویر PNM به Palm Bitmap

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

\fBpnmtopalm\fP

[\fB-verbose\fP]

[\fB-depth=\fP\fIN\fP]

[\fB-maxdepth=\fP\fIN\fP]

[\fB-colormap\fP]

[\fB-transparent=\fP\fIcolorspec\fP]

[\fB-density=\fP\fIN\fP]

[\fB-offset\fP]

[\fB-withdummy\fP]
[\fB-scanline_compression\fP | \fB-rle_compression\fP |
\fB-packbits_compression\fP]

[\fIpnmfile\fP]
.PP
کوتاه‌ترین اختصار یکتا برای گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط پیوند، از دو خط پیوند برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جداسازی نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmtopalm\fP یک تصویر PNM را به عنوان ورودی، از ورودی استاندارد یا از \fIpnmfile\fP خوانده و یک Palm Bitmap به عنوان خروجی تولید می‌کند.
.PP
فایل‌های Palm Bitmap یا فایل‌های طیف خاکستری با ۱، ۲ یا ۴ بیت بر هر پیکسل هستند، یا فایل‌های رنگی نگاشته‌شده (mapped color) با ۸ بیت بر هر پیکسل، یا یک فایل رنگی مستقیم با ۱۶ بیت بر هر پیکسل. دستور \fBpnmtopalm\fP این عمق رنگ را بر اساس maxval و تعداد رنگ‌های موجود در ورودی انتخاب می‌کند، مگر آنکه با گزینهٔ \fB-depth\fP یک عمق مشخص (بیت بر پیکسل) تعیین کنید. همچنین می‌توانید با گزینهٔ \fB-maxdepth\fP حداکثر عمق مجاز را تعیین کرده تا انتخاب \fBpnmtopalm\fP تا حدی محدود شود. فایل‌های ورودی باید دارای تعداد و مجموعه‌ای متناسب از رنگ‌ها برای محدودیت‌های خروجیِ انتخاب‌شده باشند.
.PP
این موضوع معمولاً بدین معناست که باید پیش از ارسال تصویر PNM به \fBpnmtopalm\fP، آن را از طریق \fBpnmquant\fP یا \fBpnmremap\fP پردازش کنید. به همراه Netpbm چندین فایل نقشه‌رنگ (colormap) ارائه شده است که می‌توانید برای این منظور با \fBpnmremap\fP استفاده نمایید. این فایل‌ها عبارتند از:
\fIpalmgray2.map\fP (۴ سایهٔ خاکستری برای عمق ۲)،
\fIpalmgray4.map\fP (۱۶ سایهٔ خاکستری برای عمق ۴)، و
\fIpalmcolor8.map\fP (۲۳۲ رنگ در نقشه‌رنگ پیش‌فرض Palm). در یک نصب استاندارد Netpbm، این فایل‌ها در دایرکتوری داده‌های Netpbm قرار دارند، و می‌توانید دایرکتوری داده‌های Netpbm را با دستور پوستهٔ \fBnetpbm-config --datadir\fP پیدا کنید.
.PP
مثال:

.nf
  pnmremap myimage.ppm \e
           -mapfile=$(netpbm-config --datadir)/palmgray2.map \e
  | pnmtopalm -depth=2 >myimage.palm

.fi
.PP
فایل‌های فشرده‌شدهٔ Palm Bitmap، دست‌کم آن‌هایی که \fBpnmtopalm\fP قابلیت ایجادشان را دارد، نمی‌توانند بیش از ۸ بیت بر هر پیکسل داشته باشند. در صورتی که یک خروجی فشرده‌شده را مشخص کنید، \fBpnmtopalm\fP به صورت پیش‌فرض از ۸ بیت بر هر پیکسل استفاده می‌کند. می‌توانید تعداد بیت‌ها بر هر پیکسل را به طور صریح با \fB-depth\fP مشخص نمایید. گزینهٔ \fB-maxdepth\fP تأثیری مشابه با \fB-depth\fP دارد. اگر با هر یک از این دو گزینه مقداری بیشتر از ۸ بیت بر هر پیکسل تعیین کنید، \fBpnmtopalm\fP با خطا متوقف می‌شود.

.UN version.SS نسخه Palm Bitmap
.PP
دستور \fBpnmtopalm\fP یک بیت‌مپ Palm از نسخه 0، 1، 2 یا 3 تولید می‌کند.
این دستور قدیمی‌ترین (پایین‌ترین) نسخه‌ای را که می‌تواند برای تصویر داده‌شده و
گزینه‌های تعیین‌شده تولید کند، به کار می‌گیرد.


.IP \(bu
اگر تراکمی (گزینه \fB-density\fP) بالاتر از
«low» مشخص کنید، نسخه حداقل 3 خواهد بود.

.IP \(bu
اگر شفافیت (گزینه \fB-transparent\fP) یا 
هرگونه فشرده‌سازی را مشخص کنید، نسخه حداقل 2 خواهد بود.

.IP \(bu
اگر یک نقشه رنگ سفارشی (گزینه \fB-colormap\fP) مشخص کنید،
نسخه حداقل 1 خواهد بود.

.IP \(bu
اگر تصویر بیش از یک بیت در هر پیکسل داشته باشد، نسخه حداقل
1 خواهد بود. تصویر زمانی بیش از یک بیت در هر پیکسل دارد که آن را با
\fB-depth\fP تعیین کرده باشید یا مقدار را روی پیش‌فرض بگذارید و تصویر دارای بیش از
دو رنگ (یا سایه‌های خاکستری) باشد.


.PP
تمام نگارش‌های Palm OS می‌توانند بیت‌مپ نسخه 0 را بخوانند. Palm OS 3.0 و
نسخه‌های جدیدتر می‌توانند بیت‌مپ نسخه 1 را بخوانند. Palm OS 3.5 و جدیدتر می‌توانند
بیت‌مپ نسخه 2 را بخوانند. برای خواندن بیت‌مپ نسخه 3، به Palm OS Garnet
یا یک دستگاه دستی مجهز به High Density Display Feature Set نیاز دارید.

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


.TP
\fB-verbose\fP
قالب فایل خروجی را نمایش می‌دهد.

.TP
\fB-depth=\fP\fIN\fP
فایلی با عمق \fIN\fP تولید می‌کند، که در آن \fIN\fP باید ۱، ۲،
۴، ۸ یا ۱۶ باشد. از آنجا که نقشه رنگ ۸-بیتی پیش‌فرض Palm از نوع
طیف خاکستری نیست، اگر ورودی یک تصویر تک‌رنگ یا طیف خاکستری باشد،
خروجی بدون در نظر گرفتن عمق مشخص‌شده، هرگز عمیق‌تر از ۴ بیت نخواهد بود.
توجه داشته باشید که رنگ ۸-بیتی فقط در PalmOS 3.5 (و
بالاتر) کار می‌کند، و رنگ مستقیم ۱۶-بیتی فقط در PalmOS 4.0 (و
بالاتر) عمل می‌کند. با این حال، قالب رنگ مستقیم ۱۶-بیتی همچنین با
نسخه‌های گوناگون PalmOS 3.x استفاده‌شده در Handspring Visor سازگار است، بنابراین
این تصاویر ممکن است در آن دستگاه نیز کار کنند.

.TP
\fB-maxdepth=\fP\fIN\fP
فایلی با حداقل عمق، اما در هر حال کمتر از پهنای \fIN\fP
بیت تولید می‌کند. اگر 16-bit را تعیین کنید، خروجی همواره رنگ مستقیم
۱۶-بیتی خواهد بود.

.TP
\fB-offset\fP
فیلد \fBnextDepthOffset\fP را در سرآیند فایل palm تنظیم می‌کند تا پایان
فایل را نشان دهد (و انتهای فایل را تا مضرب ۴ بایت تراز می‌کند، زیرا
\fBnextDepthOffset\fP تنها می‌تواند به مرزهای ۴ بایتی اشاره کند).
.sp
یک فایل تصویر palm می‌تواند شامل چندین نگاشت از همان تصویر با
عمق‌های رنگ مختلف باشد تا نمایش‌گر بتواند تصویر مناسب با
صفحه نمایش را انتخاب کند. فیلد \fBnextDepthOffset\fP مشخص می‌کند که در جریان داده
نگاشت بعدی از کجا آغاز می‌شود.
.sp
دستور \fBpnmtopalm\fP فایلی ایجاد می‌کند که تنها حاوی یک تصویر است، اما
می‌توانید به طور جداگانه چندین فایل تک‌تصویری را به هم متصل کنید تا یک
فایل چندتصویری بسازید. در این صورت، باید از \fB-offset\fP استفاده کنید
تا اتصال حاصل یک جریان داده معتبر باشد.
.sp
به‌طور پیش‌فرض (اگر \fB-offset\fP را تعیین نکنید)، \fBpnmtopalm\fP
فیلد \fBnextDepthOffset\fP را طوری تولید می‌کند که نشان دهد تصویر دیگری در ادامه
وجود ندارد (و هیچ داده لایه‌گذاری پس از تصویر اضافه نمی‌کند).
.sp
بیت‌مپ‌های نسخه ۳ Palm در واقع به جای \fBnextDepthOffset\fP دارای یک
فیلد \fBnextBitmapOffset\fP هستند. موارد فوق برای هرکدام که مرتبط باشد صدق می‌کند.
.sp
گزینه \fB-offset\fP در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شد.
پیش از آن، \fBpnmtopalm\fP همواره فیلد \fBnextDepthOffset\fP را
روی «none» تنظیم می‌کرد.
.sp
پیش از Netpbm 10.27 (مارس ۲۰۰۵)، در صورت ایجاد یک رستر فشرده نمی‌توانستید از \fB-offset\fP
استفاده کنید (زیرا \fBpnmtopalm\fP آن‌قدر هوشمند نبود که در زمان نوشتن سرآیند،
اندازه تصویر را بداند). همچنین به دلایلی مشابه، نمی‌توانستید آن را با عمق رنگ ۱۶ بیتی یا با
گزینه \fB-colormap\fP به کار ببرید.

.TP
\fB-withdummy\fP
این گزینه به \fBpnmtopalm\fP اعلام می‌کند که پس از تصویر، یک سرآیند تصویر ساختگی
در جریان داده قرار دهد تا تصاویر با تراکم بالا (high density) بعدی را معرفی کند.
.sp
این سرآیند تصویر ساختگی، یک دنباله ویژه است که در مشخصات Palm Bitmap
تعریف شده است. برای مفسرهای قدیمی Palm Bitmap مانند یک سرآیند تصویر نامعتبر
به نظر می‌رسد، بنابراین چنین مفسری خواندن جریان داده را در آن نقطه متوقف
می‌کند. اما یک مفسر جدید Palm Bitmap ماهیت آن را تشخیص می‌دهد (صرفاً چیزی
برای متوقف کردن مفسر قدیمی) و از روی آن عبور می‌کند. قاعدتاً شما پس از این،
تصاویر با تراکم بالایی را به جریان اضافه خواهید کرد که باعث سردرگمی مفسر قدیمی‌تر می‌شدند.
.sp
اگر \fB-withdummy\fP را مشخص می‌کنید، باید \fB-offset\fP را نیز تعیین کنید،
چرا که در غیر این صورت فاقد معنی است.
.sp
گزینه \fB-withdummy\fP در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شد.

.TP
\fB-colormap\fP
یک نقشه رنگ سفارشی ایجاد کرده و آن را در فایل خروجی می‌گنجاند. به دلایل
کارایی، این کار از سوی Palm توصیه نمی‌شود. در غیر این صورت، \fBpnmtopalm\fP
از نقشه رنگ پیش‌فرض Palm برای خروجی رنگی استفاده می‌کند.

.TP
\fB-transparent=\fP\fIcolorspec\fP
\fIیک\fP رنگ خاص را به عنوان کاملاً شفاف علامت‌گذاری می‌کند.
.sp
مقدار \fIcolorspec\fP همان‌گونه است که برای
.UR libnetpbm_image.html#colorname
آرگومان روتین کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& شرح داده شده است.
.sp
شفافیت فقط در Palm OS 3.5 و بالاتر کار می‌کند.

.TP
\fB-scanline_compression\fP
مشخص می‌کند که بیت‌مپ خروجی Palm از طرح فشرده‌سازی خط‌اسکن (scanline)
Palm استفاده کند. فشرده‌سازی خط‌اسکن تنها در Palm OS 2.0
و بالاتر کار می‌کند.

.TP
\fB-rle_compression\fP
مشخص می‌کند که بیت‌مپ خروجی Palm از طرح فشرده‌سازی RLE
متعلق به Palm استفاده کند. فشرده‌سازی RLE تنها با Palm OS 3.5 و
بالاتر کار می‌کند.

.TP
\fB-packbits_compression\fP
مشخص می‌کند که بیت‌مپ خروجی Palm از طرح فشرده‌سازی packbits
متعلق به Palm استفاده کند. فشرده‌سازی Packbits تنها با Palm OS 4.0 و
بالاتر کار می‌کند.
.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شد.

.TP
\fB-density\fP=\fIN\fP
تراکم بیت‌مپ Palm را مشخص می‌کند. تراکم عددی است که با
تفکیک‌پذیری نمایش تصویر تناسب دارد.
ضریب تناسب به عهده نرم‌افزار یا دستگاه نمایش‌دهنده است،
اما سودمند است که این اعداد را به عنوان پیکسل بر اینچ در نظر بگیرید.
مقادیر مجاز عبارتند از:


.IP \(bu
72
.IP \(bu
108
.IP \(bu
144
.IP \(bu
216
.IP \(bu
288

.sp
این گزینه در Netpbm 10.27 (مارس ۲۰۰۵) اضافه شد. نگارش‌های قبلی Netpbm
نمی‌توانستند بیت‌مپ‌های نسخه ۳ Palm را تولید کنند، بنابراین مفهومی
به نام تراکم وجود نداشت.



.UN seealso.SH "همچنین ببینید (SEE ALSO)"
.BR "palmtopnm" (1)\c
\&,
.BR "pdbimgtopam" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "pnmremap" (1)\c
\&,
.BR "pnm" (1)\c
\&

.UN notes
.SH "نکات (NOTES)"
.PP
بیت‌مپ‌های Palm ممکن است شامل چندین نسخه (rendition) از یک بیت‌مپ یکسان در عمق‌های مختلف باشند. برای ساخت یک بیت‌مپ Palm با N نسخه به‌وسیلهٔ \fBpnmtopalm\fP، ابتدا نسخه‌های ۱ تا N-1 را با استفاده از گزینهٔ \fB-offset\fP ایجاد کنید، سپس تصویر N-ام را بدون گزینهٔ \fB-offset\fP بسازید. در نهایت، با استفاده از \fBcat\fP نسخه‌های مجزا را در قالب یک فایل واحد به یکدیگر متصل کنید.
.PP
اگر قصد دارید هر دو نسخه‌های با تراکم بالا (high density) و تراکم پایین (low density) را بگنجانید، تصاویر با تراکم بالا را در انتها قرار دهید و هنگام ساخت آخرین تصویر از نسخه‌های با تراکم پایین، از گزینهٔ \fB-withdummy\fP استفاده کنید.
.PP
اگر طرح فشرده‌سازی Palm packbits را برای یک بیت‌مپ رنگ مستقیم ۱۶ بیتی مشخص کنید، این برنامه یک بیت‌مپ نامعتبر تولید می‌کند.


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

این برنامه در ابتدا با نام ppmtoTbmp.c توسط Ian Goldberg و George Caswell نوشته شد. سپس برای افزودن قابلیت‌های رنگ، فشرده‌سازی و شفافیت به‌طور کامل توسط Bill Janssen بازنویسی گردید.
حق نشر (Copyright) ۱۹۹۵-۲۰۰۱ متعلق به Ian Goldberg، George Caswell و Bill Janssen است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار Netpbm با نام makeman از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmtopalm.html
.PP