diff options
Diffstat (limited to '')
| -rw-r--r-- | upstream/opensuse-leap-15-6/man1/jpeg2ktopam.1 | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/jpeg2ktopam.1 b/upstream/opensuse-leap-15-6/man1/jpeg2ktopam.1 new file mode 100644 index 00000000..e8d67894 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/jpeg2ktopam.1 @@ -0,0 +1,156 @@ +\ +.\" 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 - convert JPEG-2000 code stream to PAM/PNM + +.UN synopsis +.SH SYNOPSIS + +\fBjpeg2ktopam\fP +[\fB-verbose\fP] +[\fB-debuglevel=\fP\fInumber\fP] +\fIfilename\fP + +.SH OPTION USAGE +.PP +Minimum unique abbreviation of option is acceptable. You may use double +hyphens instead of single hyphen to denote options. You may use white +space in place of the equals sign to separate an option name from its value. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBjpeg2ktopam\fP converts the named JPEG-2000 file (JP2 or JPC), +or Standard Input if no file is named, to a PBM, PGM, PPM, or PAM +file on Standard Output. +.PP +The JPEG-2000 specification specifies two different formats: JP2 and +JPEG-2000 code stream (JPC). JP2 represents a visual image quite +specifically, whereas JPC is a more or less arbitrary array of codes. A JP2 +image contains a JPC stream and metadata describing how that stream represents +a visual image. \fBjpeg2ktopam\fP converts both. +.PP +If the color space identified in the image is grayscale +(JAS_IMAGE_CS_GRAY), \fBjpeg2ktopam\fP generates a PGM image, unless the +image contains only one bit per pixel, in which case \fBjpeg2ktopam\fP +generates PBM. If the color space is RGB (JAS_IMAGE_CS_RGB), +\fBjpeg2ktopam\fP generates a PPM image. If the input image is anything +else, \fBjpeg2ktopam\fP generates a PAM image with no tuple type identified. +.PP +In the PGM and PPM cases, \fBjpeg2ktopam\fP assumes the intensity +values in the input image have the same meaning as for PGM and PPM. +One thing that implies is the ITU-R Recommendation BT.709 color space, +which means the assumption is false for JP2 input. JP2 input uses +SRGB color encoding. So if you use \fBjpeg2ktopam\fP to convert a +JP2 image to PPM, it changes the visual image (slightly) -- the colors +in the output are not the same as in the input. +.PP +In the PAM image, the output samples are numerically identical to +the input samples. If the input samples are signed, they are +represented in two's complement form in the output (because PAM +samples are always unsigned). The PAM plane numbers are identical to +the JPC component numbers. +.PP +A JPEG-2000 image has a "precision," which is the number of bits used for +each code (in Netpbm lingo, "sample"). Actually, each component has a +separate precision. The maxval of a PGM, PPM, or PAM output is the +largest number you can represent in the JPEG-2000 precision of the JPEG-2000 +component with the greatest precision. The samples in all components are +scaled to that maxval. So if the red component has a precision of 4 bits +and the green component has a precision of 6 bits, the maxval is 63 and +the red component codes from the JPEG-2000 image are multiplied by 63/15 to +generate the output samples. +.PP +\fBjpeg2ktopam\fP interprets the JPEG-2000 input with the +.UR http://www.ece.uvic.ca/~mdadams/jasper/ +Jasper JPEG-2000 library +.UE +\&. See documentation of the library for details on what +\fBjpeg2ktopam\fP handles. Note that the Jasper library contains +facilities for writing PNM images, but \fBjpeg2ktopam\fP does not use +those. It uses the Netpbm library instead. Note that the makers of +the Jasper library write it "JasPer," but Netpbm documentation follows +standard American English typography rules, which don't allow that +kind of capitalization. +.PP +Use \fBpamtojpeg2k\fP to convert in the other direction. +.PP +The program \fBjasper\fP, which is packaged with the Jasper +JPEG-2000 library, also converts between JPEG-2000 and PNM formats. +Because it's packaged with the library, it may exploit it better, +especially recently added features. However, since it does not use the +Netpbm library to read and write the Netpbm formats, it doesn't do as +good a job on that side. + +.UN options +.SH OPTIONS + + + +.TP +\fB-verbose\fP +This option causes \fBjpeg2ktopam\fP to issue informational +messages about the conversion process. + +.TP +\fB-debuglevel\fP=\fInumber\fP +This option controls debug messages from the Jasper library. +\fBjpeg2ktopam\fP passes \fInumber\fP as the debug level to the Jasper +JPEG-2000 decoder. + + + +.UN examples +.SH EXAMPLES + +.nf + jpeg2ktopam myimg.jpc >myimg.ppm +.fi + + +.UN jpeg2000 +.SH ABOUT JPEG-2000 +.PP +See +.BR "the \fBpamtojpeg2k\fP manual" (1)\c +\& +for general information on JPEG-2000 compression and the +JPEG-2000 formats. + + +.UN seealso +.SH SEE ALSO +.BR "pamtojpeg2k" (1)\c +\&, +.BR "jpegtopnm" (1)\c +\&, +.BR "ppm" (5)\c +\&, +.BR "pgm" (5)\c +\&, +.BR "pbm" (5)\c +\&, +.BR "pam" (5)\c +\&, + +.SH History +.PP +\fBjpeg2ktopam\fP was added to Netpbm in Release 10.12 (November 2002). +.PP +Before Netpbm 10.49 (December 2009), \fBjpeg2ktopam\fP could not convert +a JP2 file -- only JPC. +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/jpeg2ktopam.html +.PP
\ No newline at end of file |