\
.\" 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 "Jpeg2ktopam User Manual" 0 "08 October 2009" "netpbm documentation"

.SH "نام (NAME)"
jpeg2ktopam \- تبدیل جریان کد JPEG-2000 به PAM/PNM

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

\fBjpeg2ktopam\fP
[\fB-verbose\fP]
[\fB-debuglevel=\fP\fInumber\fP]
\fIfilename\fP

.SH "نحوه استفاده از گزینه‌ها (OPTION USAGE)"
.PP
کوتاه‌ترین کوته‌نوشت یکتای هر گزینه پذیرفته می‌شود. می‌توانید برای مشخص کردن گزینه‌ها به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBjpeg2ktopam\fP فایل نام‌بردهٔ JPEG-2000 (با فرمت JP2 یا JPC) یا در صورت نام برده نشدن فایل، ورودی استاندارد را به یک فایل PBM، PGM، PPM، یا PAM در خروجی استاندارد تبدیل می‌کند.
.PP
مشخصات JPEG-2000 دو فرمت مختلف را تعیین می‌کند: JP2 و جریان کد JPEG-2000 (یا JPC). فرمت JP2 یک تصویر دیداری را کاملاً دقیق نشان می‌دهد، در حالی که JPC کم‌وبیش آرایه‌ای دلخواه از کدها است. یک تصویر JP2 حاوی یک جریان JPC و فراداده‌هایی (metadata) است که نحوهٔ نمایش تصویر دیداری توسط آن جریان را توصیف می‌کنند. \fBjpeg2ktopam\fP هر دو را تبدیل می‌کند.
.PP
اگر فضای رنگ شناسایی‌شده در تصویر، مقیاس خاکستری (JAS_IMAGE_CS_GRAY) باشد، \fBjpeg2ktopam\fP یک تصویر PGM تولید می‌کند، مگر اینکه تصویر فقط شامل یک بیت در هر پیکسل باشد که در این حالت \fBjpeg2ktopam\fP تصویر PBM تولید خواهد کرد. اگر فضای رنگ RGB (JAS_IMAGE_CS_RGB) باشد، \fBjpeg2ktopam\fP یک تصویر PPM تولید می‌کند. در صورتی که تصویر ورودی هر حالت دیگری باشد، \fBjpeg2ktopam\fP تصویری با فرمت PAM بدون تعیین نوع تاپل (tuple type) تولید می‌نماید.
.PP
در حالت‌های PGM و PPM، دستور \fBjpeg2ktopam\fP فرض می‌کند که مقادیر شدت نور در تصویر ورودی معنایی مشابه با PGM و PPM دارند. یکی از مفاهیم ضمنی این فرض، فضای رنگ توصیه‌نامه ITU-R BT.709 است که نشان می‌دهد این فرض برای ورودی JP2 نادرست است؛ چرا که ورودی JP2 از کدگذاری رنگ SRGB استفاده می‌کند. بنابراین اگر از \fBjpeg2ktopam\fP برای تبدیل یک تصویر JP2 به PPM استفاده کنید، تصویر دیداری (اندکی) تغییر می‌کند -- رنگ‌های موجود در خروجی با ورودی یکسان نخواهند بود.
.PP
در تصویر PAM، نمونه‌های خروجی از نظر عددی هم‌ارز با نمونه‌های ورودی هستند. اگر نمونه‌های ورودی علامت‌دار باشند، در خروجی به صورت مکمل دو (two's complement) نمایش داده می‌شوند (چرا که نمونه‌های PAM همواره بدون علامت هستند). شماره‌های صفحه (plane) در PAM با شماره‌های مؤلفه (component) در JPC یکسان هستند.
.PP
یک تصویر JPEG-2000 دارای یک «دقت» (precision) است که تعداد بیت‌های مورد استفاده برای هر کد (در اصطلاح Netpbm، «نمونه» یا sample) می‌باشد. در واقع، هر مؤلفه دارای دقت مجزایی است. مقدار maxval در خروجی PGM، PPM یا PAM بزرگ‌ترین عددی است که می‌توانید در دقت مؤلفه‌ای از JPEG-2000 با بیشترین دقت، نمایش دهید. نمونه‌ها در تمام مؤلفه‌ها به آن مقدار maxval مقیاس‌بندی می‌شوند. بنابراین اگر مؤلفهٔ قرمز دقتی معادل ۴ بیت و مؤلفهٔ سبز دقتی معادل ۶ بیت داشته باشد، maxval برابر با ۶۳ خواهد بود و کدهای مؤلفهٔ قرمز از تصویر JPEG-2000 در ۶۳/۱۵ ضرب می‌شوند تا نمونه‌های خروجی را تولید کنند.
.PP
دستور \fBjpeg2ktopam\fP ورودی JPEG-2000 را با
.UR http://www.ece.uvic.ca/~mdadams/jasper
کتابخانه Jasper JPEG-2000
.UE
\& تفسیر می‌کند. برای جزئیات در مورد مواردی که \fBjpeg2ktopam\fP پشتیبانی می‌کند، مستندات این کتابخانه را ببینید. توجه داشته باشید که کتابخانه Jasper امکاناتی برای نوشتن تصاویر PNM دارد، اما \fBjpeg2ktopam\fP از آن‌ها استفاده نمی‌کند، بلکه به جای آن از کتابخانه Netpbm بهره می‌برد. همچنین توجه داشته باشید که سازندگان کتابخانه Jasper نام آن را «JasPer» می‌نویسند، اما مستندات Netpbm از قواعد نگارشی استاندارد انگلیسی آمریکایی پیروی می‌کنند که چنین شیوه‌ای از بزرگ‌نویسی حروف را مجاز نمی‌شمارد.
.PP
برای تبدیل در جهت معکوس، از \fBpamtojpeg2k\fP استفاده کنید.
.PP
برنامه \fBjasper\fP که همراه با کتابخانه Jasper JPEG-2000 ارائه می‌شود نیز میان فرمت‌های JPEG-2000 و PNM تبدیل انجام می‌دهد. از آنجا که این برنامه همراه با کتابخانه بسته‌بندی شده است، ممکن است بهره‌گیری بهتری از آن داشته باشد، به ویژه در مورد قابلیت‌هایی که اخیراً اضافه شده‌اند. با این حال، از آنجایی که برای خواندن و نوشتن فرمت‌های Netpbm از کتابخانه Netpbm استفاده نمی‌کند، عملکرد آن در این بخش به آن اندازه خوب نیست.

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



.TP
\fB-verbose\fP
این گزینه باعث می‌شود \fBjpeg2ktopam\fP پیام‌های اطلاعاتی درباره فرایند تبدیل صادر کند.

.TP
\fB-debuglevel\fP=\fInumber\fP
این گزینه پیام‌های اشکال‌زدایی کتابخانه Jasper را کنترل می‌کند. \fBjpeg2ktopam\fP مقدار \fInumber\fP را به عنوان سطح اشکال‌زدایی (debug level) به رمزگشای Jasper JPEG-2000 ارسال می‌کند.


     
.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
  jpeg2ktopam myimg.jpc >myimg.ppm
.fi

.UN jpeg2000
.SH "درباره JPEG-2000 (ABOUT JPEG-2000)"
.PP
برای اطلاعات عمومی پیرامون فشرده‌سازی JPEG-2000 و فرمت‌های آن، به
.BR "راهنمای \fBpamtojpeg2k\fP" (1)\c
\&
مراجعه کنید.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamtojpeg2k" (1)\c
\&,
.BR "jpegtopnm" (1)\c
\&,
.BR "ppm" (1)\c
\&,
.BR "pgm" (1)\c
\&,
.BR "pbm" (1)\c
\&,
.BR "pam" (1)\c
\&,

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBjpeg2ktopam\fP در انتشار 10.12 (نوامبر ۲۰۰۲) به Netpbm اضافه شد.
.PP
پیش از Netpbm نسخهٔ 10.49 (دسامبر ۲۰۰۹)، \fBjpeg2ktopam\fP قادر به تبدیل فایل‌های JP2 نبود -- و تنها از JPC پشتیبانی می‌کرد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' متعلق به Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر در دسترس است:
.IP
.B http://netpbm.sourceforge.net/doc/jpeg2ktopam.html
.PP