\
.\" 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 "Rawtopgm User Manual" 0 "14 September 2000" "netpbm documentation"

.SH "نام (NAME)"

rawtopgm \- تبدیل بایت‌های خام مقیاس خاکستری به تصویر PGM

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

\fBrawtopgm\fP

[\fB-bpp\fP [\fB1\fP|\fB2\fP]]

[\fB-littleendian\fP]

[\fB-maxval\fP \fIN\fP]

[\fB-headerskip\fP \fIN\fP]

[\fB-rowskip\fP \fIN\fP]

[\fB-tb\fP|\fB-topbottom\fP]

[\fIwidth\fP \fIheight\fP]

[\fIimagefile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBrawtopgm\fP مقادیر خام مقیاس خاکستری (grayscale) را در ورودی خوانده و یک تصویر PGM در خروجی تولید می‌کند. فایل ورودی صرفاً دنباله‌ای از اعداد دودویی خالص است که هر کدام یک یا دو بایت هستند، به صورت bigendian یا littleendian، و مقادیر خاکستری را نشان می‌دهند. این داده‌ها ممکن است از بالا به پایین و چپ به راست، یا از پایین به بالا و چپ به راست مرتب شده باشند. همچنین ممکن است اطلاعات سرآیند (header) دلخواهی در ابتدای فایل وجود داشته باشد (که \fBrawtopgm\fP به جز اندازه سرآیند، هیچ توجهی به محتوای آن نمی‌کند).
.PP
آرگومان‌های ارائه‌شده به \fBrawtopgm\fP نحوه تفسیر پیکسل‌ها را مشخص می‌کنند (وظیفه‌ای که در فرمت‌های گرافیکی استاندارد توسط سرآیند انجام می‌شود).
.PP
پارامترهای \fIwidth\fP و \fIheight\fP ابعاد تصویر را مشخص می‌کنند. اگر این پارامترها را نادیده بگیرید، \fBrawtopgm\fP فرض می‌کند تصویر مربعی است و ابعاد را بر اساس اندازه جریان ورودی تعیین می‌کند. اگر این اندازه یک مربع کامل نباشد، اجرای \fBrawtopgm\fP ناموفق خواهد بود.
.PP
هنگامی که \fIwidth\fP و \fIheight\fP را تعیین نکنید، \fBrawtopgm\fP کل جریان ورودی را به طور یکجا در حافظه می‌خواند که ممکن است حافظه زیادی مصرف کند. در غیر این صورت، \fBrawtopgm\fP معمولاً فقط یک سطر را در هر لحظه در حافظه نگه می‌دارد.
.PP
اگر \fIimagefile\fP را مشخص نکنید، یا \fB-\fP را وارد کنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.
.PP
خروجی PGM به خروجی استاندارد (Standard Output) ارسال می‌شود.

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


.TP
\fB-maxval\fP \fIN\fP
مقدار \fIN\fP بیشینه مقدار (maxval) برای مقادیر خاکستری در ورودی و همچنین بیشینه مقدار تصویر خروجی PGM است. مقدار پیش‌فرض، بیشترین مقداری است که می‌توان در تعداد بایت‌های استفاده‌شده برای هر نمونه نمایش داد (یعنی ۲۵۵ یا ۶۵۵۳۵).

.TP
\fB-bpp\fP [\fB1\fP|\fB2\fP]
تعداد بایت‌های نمایانگر هر نمونه در ورودی را مشخص می‌کند. اگر مقدار \fB2\fP باشد، باارزش‌ترین بایت در ابتدای جریان قرار دارد.
.sp
پیش‌فرض ۱ بایت به ازای هر نمونه است.

.TP
\fB-littleendian\fP
مشخص می‌کند که بایت‌های هر نمونه ورودی با کم‌ارزش‌ترین بایت در ابتدا مرتب شده‌اند. بدون این گزینه، \fBrawtopgm\fP فرض می‌کند باارزش‌ترین بایت در ابتدا است (MSB first). بدیهی است که در صورت وجود تنها یک بایت به ازای هر نمونه، این گزینه هیچ اثری ندارد.

.TP
\fB-headerskip\fP \fIN\fP
برنامه \fBrawtopgm\fP از روی \fIN\fP بایت در ابتدای جریان رد شده و تصویر را بلافاصله پس از آن می‌خواند. مقدار پیش‌فرض 0 است.
.sp
این گزینه زمانی مفید است که ورودی در واقع یک فرمت گرافیکی دارای یک سرآیند توصیفی همراه با داده‌های شطرنجی (raster) معمولی باشد و شما برنامه‌ای برای خواندن سرآیند ندارید یا می‌خواهید از سرآیند چشم‌پوشی کنید.

.TP
\fB-rowskip\fP \fIN\fP
اگر در انتهای سطرها فاصله‌گذاری یا لایه‌گذاری (padding) وجود دارد، می‌توانید با این گزینه از آن رد شوید. توجه داشته باشید که rowskip نیازی نیست حتماً یک عدد صحیح باشد. در کمال شگفتی، من زمانی تصویری با 0.376 بایت لایه‌گذاری در هر سطر داشتم. مشخص شد که این مسئله ناشی از مشکلی در انتقال فایل بوده است، اما با این حال توانستم تصویر را بخوانم.
.sp
رد کردن کسری از بایت در هر سطر به معنای رد کردن یک بایت به ازای چندین سطر است.

.TP
\fB-bt -bottomfirst\fP
به‌طور پیش‌فرض، \fBrawtopgm\fP فرض می‌کند که پیکسل‌های ورودی از بالا به پایین و چپ به راست قرار دارند. اگر \fB-bt\fP یا \fB-bottomfirst\fP را مشخص کنید، \fBrawtopgm\fP فرض می‌کند پیکسل‌ها از پایین به بالا و چپ به راست چیده شده‌اند. برای مثال، فرمت Leica confocal و Molecular Dynamics از چیدمان دوم استفاده می‌کنند.
.sp
اگر در جایی که لازم است \fB-bt\fP را مشخص نکنید یا بالعکس، تصویر حاصل وارونه خواهد بود که می‌توانید آن را با \fBpamflip\fP اصلاح کنید.
.sp
این گزینه باعث می‌شود \fBrawtopgm\fP کل جریان ورودی را به یکباره در حافظه بخواند که ممکن است حافظه زیادی مصرف کند. به‌طور معمول، \fBrawtopgm\fP در هر لحظه تنها یک سطر را ذخیره می‌کند.
.sp
برای سازگاری با نسخه‌های گذشته، \fBrawtopgm\fP همچنین گزینه‌های \fB-tb\fP و \fB-topbottom\fP را با دقیقاً همان معنا می‌پذیرد. علت این نام‌گذاری برعکس آن است که نویسنده اصلی تصور می‌کرد تعیین این گزینه یعنی نتیجه نادرست ناشی از فرض بالا به پایین، باید با معکوس کردن تصویر از بالا به پایین اصلاح شود. امروزه، ما به سادگی آن را تعیین فرمت داده‌های ورودی در نظر می‌گیریم تا از بروز نتایج نادرست جلوگیری شود.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pgm" (1)\c
\&،
.BR "rawtoppm" (1)\c
\&،
.BR "pamflip" (1)\c
\&

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

حق نشر (C) ۱۹۸۹ متعلق به Jef Poskanzer.
ویرایش‌شده در ژوئن ۱۹۹۳ توسط Oliver Trepte، \fIoliver@fysik4.kth.se\fP
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' متعلق به Netpbm از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/rawtopgm.html
.PP