.\" 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 "Pamtopfm User Manual" 0 "10 April 2004" "netpbm documentation"

.SH "نام (NAME)"
pamtopfm \- تبدیل تصویر Netpbm به PFM (Portable Float Map)

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
\fBpamtopfm\fP
[\fB-endian=\fP{\fBbig\fP|\fBlittle\fP}]
[\fB-scale=\fP\fIfloat\fP]
[\fIimagefile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد.
می‌توانید به جای یک خط پیوند از دو خط پیوند استفاده کنید. همچنین می‌توانید نام یک گزینه
و مقدار آن را به جای علامت مساوی با فاصله (whitespace) از یکدیگر جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamtopfm\fP یک تصویر Netpbm (از نوع PNM یا PAM) را می‌خواند و آن را
به یک تصویر PFM (Portable Float Map) تبدیل می‌کند.
.PP
قالب تصویری PFM (Portable Float Map) شباهت زیادی به PPM دارد، اما از اعداد
ممیز شناور بدون مقدار بیشینه (maxval) استفاده می‌کند تا به یک قالب با دامنه دینامیکی بالا
(HDR یا High Dynamic Range) دست یابد. این بدان معناست که این قالب مفهومی از رنگ مطلق
ندارد و می‌تواند به جای صرفاً اطلاعات بصری مانند PPM، اطلاعات عمومی مربوط به شدت نور را
نمایش دهد. برای نمونه، دو پیکسل که شدت نورشان به قدری به هم نزدیک است که چشم انسان
نمی‌تواند تفاوت آن‌ها را تشخیص دهد، از نظر دیداری متمایز نیستند؛ بنابراین یک قالب تصویری
دیداری مانند PPM دلیلی برای اختصاص مقادیر نمونه‌برداری متفاوت به آن‌ها ندارد، در حالی که
یک قالب HDR این کار را انجام می‌دهد.
.PP
جزئیات قالب PFM در
.BR "PFM
Format Description" (1)\c
\& آمده است.
.PP
برنامه
.UR https://vgl.ict.usc.edu/HDRShop
HDRShop متعلق به USC
.UE
\& و برنامه‌ای به نام Lefty از این قالب استفاده می‌کنند.

اگر ورودی \fBpamtopfm\fP از نوع RGB (PPM) باشد، یک تصویر PFM رنگی
و در غیر این صورت یک تصویر PFM غیررنگی ایجاد می‌کند.
.PP
برای تبدیل یک تصویر PFM به قالب Netpbm از
.BR "\fBpfmtopam\fP" (1)\c
\& استفاده کنید.


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


.TP
\fB-scale=\fP\fIfloat\fP
.sp
ضریب مقیاس (scale factor) تصویر PFM را تعیین می‌کند.
ضریب مقیاس یکی از مؤلفه‌های قالب PFM است.
مقدار پیش‌فرض 1.0 است.

.TP
\fB-endian=\fP{\fBbig\fP|\fBlittle\fP}
.sp
ترتیب بایت‌ها (endianness) در تصویر PFM را تعیین می‌کند. نمونه‌ها
در رستر (raster) یک تصویر PFM، اعداد ممیز شناور ۴ بایتی IEEE
هستند. یکی از پارامترهای قالب IEEE و در نتیجه قالب PFM،
ترتیب بایت‌هاست؛ یعنی این‌که آیا بایت‌های مشخص‌شده از آدرس‌های پایین به بالا
مرتب شده‌اند یا برعکس.
.sp
مقدار \fBbig\fP به معنای big-endian — ترتیب طبیعی بایت‌هاست؛
\fBlittle\fP به معنای little-endian — ترتیب بایت‌های سازگار با Intel است.
.sp
پیش‌فرض بر اساس هر ترتیب بایتی است که دستگاه اجراکننده \fBpamtopfm\fP
به‌صورت داخلی از آن استفاده می‌کند، که منجر به اجرای سریع‌تر خواهد شد.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "Netpbm" (1)\c
\&،
.BR "pfmtopam" (1)\c
\&،
.BR "pam" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamtopfm\fP در نگارش 10.22 (آوریل ۲۰۰۴) به Netpbm اضافه شد.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام «makeman» از روی منبع HTML
تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamtopfm.html
.PP