نام (NAME)

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

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

rawtopgm

[-bpp [1|2]]

[-littleendian]

[-maxval N]

[-headerskip N]

[-rowskip N]

[-tb|-topbottom]

[width height]

[imagefile]

توضیحات (DESCRIPTION)

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

دستور rawtopgm مقادیر خام مقیاس خاکستری (grayscale) را در ورودی خوانده و یک تصویر PGM در خروجی تولید می‌کند. فایل ورودی صرفاً دنباله‌ای از اعداد دودویی خالص است که هر کدام یک یا دو بایت هستند، به صورت bigendian یا littleendian، و مقادیر خاکستری را نشان می‌دهند. این داده‌ها ممکن است از بالا به پایین و چپ به راست، یا از پایین به بالا و چپ به راست مرتب شده باشند. همچنین ممکن است اطلاعات سرآیند (header) دلخواهی در ابتدای فایل وجود داشته باشد (که rawtopgm به جز اندازه سرآیند، هیچ توجهی به محتوای آن نمی‌کند).

آرگومان‌های ارائه‌شده به rawtopgm نحوه تفسیر پیکسل‌ها را مشخص می‌کنند (وظیفه‌ای که در فرمت‌های گرافیکی استاندارد توسط سرآیند انجام می‌شود).

پارامترهای width و height ابعاد تصویر را مشخص می‌کنند. اگر این پارامترها را نادیده بگیرید، rawtopgm فرض می‌کند تصویر مربعی است و ابعاد را بر اساس اندازه جریان ورودی تعیین می‌کند. اگر این اندازه یک مربع کامل نباشد، اجرای rawtopgm ناموفق خواهد بود.

هنگامی که width و height را تعیین نکنید، rawtopgm کل جریان ورودی را به طور یکجا در حافظه می‌خواند که ممکن است حافظه زیادی مصرف کند. در غیر این صورت، rawtopgm معمولاً فقط یک سطر را در هر لحظه در حافظه نگه می‌دارد.

اگر imagefile را مشخص نکنید، یا - را وارد کنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.

خروجی PGM به خروجی استاندارد (Standard Output) ارسال می‌شود.

گزینه‌ها (OPTIONS)

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

-maxval N

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

-bpp [1|2]

تعداد بایت‌های نمایانگر هر نمونه در ورودی را مشخص می‌کند. اگر مقدار 2 باشد، باارزش‌ترین بایت در ابتدای جریان قرار دارد.

پیش‌فرض ۱ بایت به ازای هر نمونه است.

-littleendian

مشخص می‌کند که بایت‌های هر نمونه ورودی با کم‌ارزش‌ترین بایت در ابتدا مرتب شده‌اند. بدون این گزینه، rawtopgm فرض می‌کند باارزش‌ترین بایت در ابتدا است (MSB first). بدیهی است که در صورت وجود تنها یک بایت به ازای هر نمونه، این گزینه هیچ اثری ندارد.

-headerskip N

برنامه rawtopgm از روی N بایت در ابتدای جریان رد شده و تصویر را بلافاصله پس از آن می‌خواند. مقدار پیش‌فرض 0 است.

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

-rowskip N

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

رد کردن کسری از بایت در هر سطر به معنای رد کردن یک بایت به ازای چندین سطر است.

-bt -bottomfirst

به‌طور پیش‌فرض، rawtopgm فرض می‌کند که پیکسل‌های ورودی از بالا به پایین و چپ به راست قرار دارند. اگر -bt یا -bottomfirst را مشخص کنید، rawtopgm فرض می‌کند پیکسل‌ها از پایین به بالا و چپ به راست چیده شده‌اند. برای مثال، فرمت Leica confocal و Molecular Dynamics از چیدمان دوم استفاده می‌کنند.

اگر در جایی که لازم است -bt را مشخص نکنید یا بالعکس، تصویر حاصل وارونه خواهد بود که می‌توانید آن را با pamflip اصلاح کنید.

این گزینه باعث می‌شود rawtopgm کل جریان ورودی را به یکباره در حافظه بخواند که ممکن است حافظه زیادی مصرف کند. به‌طور معمول، rawtopgm در هر لحظه تنها یک سطر را ذخیره می‌کند.

برای سازگاری با نسخه‌های گذشته، rawtopgm همچنین گزینه‌های -tb و -topbottom را با دقیقاً همان معنا می‌پذیرد. علت این نام‌گذاری برعکس آن است که نویسنده اصلی تصور می‌کرد تعیین این گزینه یعنی نتیجه نادرست ناشی از فرض بالا به پایین، باید با معکوس کردن تصویر از بالا به پایین اصلاح شود. امروزه، ما به سادگی آن را تعیین فرمت داده‌های ورودی در نظر می‌گیریم تا از بروز نتایج نادرست جلوگیری شود.

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

pgm(1)، rawtoppm(1)، pamflip(1)

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

حق نشر (C) ۱۹۸۹ متعلق به Jef Poskanzer. ویرایش‌شده در ژوئن ۱۹۹۳ توسط Oliver Trepte، oliver@fysik4.kth.se

منبع سند (DOCUMENT SOURCE)

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

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