نام (NAME)

jpeg2ktopam - تبدیل جریان کد JPEG-2000 به PAM/PNM

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

jpeg2ktopam [-verbose] [-debuglevel=number] filename

نحوه استفاده از گزینه‌ها (OPTION USAGE)

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

توضیحات (DESCRIPTION)

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

دستور jpeg2ktopam فایل نام‌بردهٔ JPEG-2000 (با فرمت JP2 یا JPC) یا در صورت نام برده نشدن فایل، ورودی استاندارد را به یک فایل PBM، PGM، PPM، یا PAM در خروجی استاندارد تبدیل می‌کند.

مشخصات JPEG-2000 دو فرمت مختلف را تعیین می‌کند: JP2 و جریان کد JPEG-2000 (یا JPC). فرمت JP2 یک تصویر دیداری را کاملاً دقیق نشان می‌دهد، در حالی که JPC کم‌وبیش آرایه‌ای دلخواه از کدها است. یک تصویر JP2 حاوی یک جریان JPC و فراداده‌هایی (metadata) است که نحوهٔ نمایش تصویر دیداری توسط آن جریان را توصیف می‌کنند. jpeg2ktopam هر دو را تبدیل می‌کند.

اگر فضای رنگ شناسایی‌شده در تصویر، مقیاس خاکستری (JAS_IMAGE_CS_GRAY) باشد، jpeg2ktopam یک تصویر PGM تولید می‌کند، مگر اینکه تصویر فقط شامل یک بیت در هر پیکسل باشد که در این حالت jpeg2ktopam تصویر PBM تولید خواهد کرد. اگر فضای رنگ RGB (JAS_IMAGE_CS_RGB) باشد، jpeg2ktopam یک تصویر PPM تولید می‌کند. در صورتی که تصویر ورودی هر حالت دیگری باشد، jpeg2ktopam تصویری با فرمت PAM بدون تعیین نوع تاپل (tuple type) تولید می‌نماید.

در حالت‌های PGM و PPM، دستور jpeg2ktopam فرض می‌کند که مقادیر شدت نور در تصویر ورودی معنایی مشابه با PGM و PPM دارند. یکی از مفاهیم ضمنی این فرض، فضای رنگ توصیه‌نامه ITU-R BT.709 است که نشان می‌دهد این فرض برای ورودی JP2 نادرست است؛ چرا که ورودی JP2 از کدگذاری رنگ SRGB استفاده می‌کند. بنابراین اگر از jpeg2ktopam برای تبدیل یک تصویر JP2 به PPM استفاده کنید، تصویر دیداری (اندکی) تغییر می‌کند -- رنگ‌های موجود در خروجی با ورودی یکسان نخواهند بود.

در تصویر PAM، نمونه‌های خروجی از نظر عددی هم‌ارز با نمونه‌های ورودی هستند. اگر نمونه‌های ورودی علامت‌دار باشند، در خروجی به صورت مکمل دو (two's complement) نمایش داده می‌شوند (چرا که نمونه‌های PAM همواره بدون علامت هستند). شماره‌های صفحه (plane) در PAM با شماره‌های مؤلفه (component) در JPC یکسان هستند.

یک تصویر JPEG-2000 دارای یک «دقت» (precision) است که تعداد بیت‌های مورد استفاده برای هر کد (در اصطلاح Netpbm، «نمونه» یا sample) می‌باشد. در واقع، هر مؤلفه دارای دقت مجزایی است. مقدار maxval در خروجی PGM، PPM یا PAM بزرگ‌ترین عددی است که می‌توانید در دقت مؤلفه‌ای از JPEG-2000 با بیشترین دقت، نمایش دهید. نمونه‌ها در تمام مؤلفه‌ها به آن مقدار maxval مقیاس‌بندی می‌شوند. بنابراین اگر مؤلفهٔ قرمز دقتی معادل ۴ بیت و مؤلفهٔ سبز دقتی معادل ۶ بیت داشته باشد، maxval برابر با ۶۳ خواهد بود و کدهای مؤلفهٔ قرمز از تصویر JPEG-2000 در ۶۳/۱۵ ضرب می‌شوند تا نمونه‌های خروجی را تولید کنند.

دستور jpeg2ktopam ورودی JPEG-2000 را با کتابخانه Jasper JPEG-2000 تفسیر می‌کند. برای جزئیات در مورد مواردی که jpeg2ktopam پشتیبانی می‌کند، مستندات این کتابخانه را ببینید. توجه داشته باشید که کتابخانه Jasper امکاناتی برای نوشتن تصاویر PNM دارد، اما jpeg2ktopam از آن‌ها استفاده نمی‌کند، بلکه به جای آن از کتابخانه Netpbm بهره می‌برد. همچنین توجه داشته باشید که سازندگان کتابخانه Jasper نام آن را «JasPer» می‌نویسند، اما مستندات Netpbm از قواعد نگارشی استاندارد انگلیسی آمریکایی پیروی می‌کنند که چنین شیوه‌ای از بزرگ‌نویسی حروف را مجاز نمی‌شمارد.

برای تبدیل در جهت معکوس، از pamtojpeg2k استفاده کنید.

برنامه jasper که همراه با کتابخانه Jasper JPEG-2000 ارائه می‌شود نیز میان فرمت‌های JPEG-2000 و PNM تبدیل انجام می‌دهد. از آنجا که این برنامه همراه با کتابخانه بسته‌بندی شده است، ممکن است بهره‌گیری بهتری از آن داشته باشد، به ویژه در مورد قابلیت‌هایی که اخیراً اضافه شده‌اند. با این حال، از آنجایی که برای خواندن و نوشتن فرمت‌های Netpbm از کتابخانه Netpbm استفاده نمی‌کند، عملکرد آن در این بخش به آن اندازه خوب نیست.

گزینه‌ها (OPTIONS)

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

-verbose

این گزینه باعث می‌شود jpeg2ktopam پیام‌های اطلاعاتی درباره فرایند تبدیل صادر کند.

-debuglevel=number

این گزینه پیام‌های اشکال‌زدایی کتابخانه Jasper را کنترل می‌کند. jpeg2ktopam مقدار number را به عنوان سطح اشکال‌زدایی (debug level) به رمزگشای Jasper JPEG-2000 ارسال می‌کند.

مثال‌ها (EXAMPLES)

jpeg2ktopam myimg.jpc >myimg.ppm

درباره JPEG-2000 (ABOUT JPEG-2000)

برای اطلاعات عمومی پیرامون فشرده‌سازی JPEG-2000 و فرمت‌های آن، به راهنمای pamtojpeg2k(1) مراجعه کنید.

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

pamtojpeg2k(1), jpegtopnm(1), ppm(1), pgm(1), pbm(1), pam(1),

تاریخچه (HISTORY)

دستور jpeg2ktopam در انتشار 10.12 (نوامبر ۲۰۰۲) به Netpbm اضافه شد.

پیش از Netpbm نسخهٔ 10.49 (دسامبر ۲۰۰۹)، jpeg2ktopam قادر به تبدیل فایل‌های JP2 نبود -- و تنها از JPC پشتیبانی می‌کرد.

منبع سند (DOCUMENT SOURCE)

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

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