Package ch.randelshofer.media.jpeg

Class JPEGImageIO

java.lang.Object

ch.randelshofer.media.jpeg.JPEGImageIO

public class JPEGImageIO
extends Object

JPEGImageIO supports reading of JPEG images with YUV, CMYK and YCCK color encoding.

Method Summary

Modifier and Type	Method	Description
static BufferedImage	createRGBImageFromCMYK(Raster cmykRaster, ICC_Profile cmykProfile)	Creates a buffered image from a raster in the CMYK color space, converting the colors to RGB using the provided CMYK ICC_Profile.
static BufferedImage	createRGBImageFromInvertedYCCK(Raster ycckRaster, ICC_Profile cmykProfile)	Creates a buffered image from a raster in the inverted YCCK color space, converting the colors to RGB using the provided CMYK ICC_Profile.
static BufferedImage	createRGBImageFromYCCK(Raster ycckRaster, ICC_Profile cmykProfile)	Creates a buffered image from a raster in the YCCK color space, converting the colors to RGB using the provided CMYK ICC_Profile.
static BufferedImage	read(InputStream in)	Reads a JPEG image from the provided InputStream and convert it into a color space which can be handled by Java2D (that is RGB or Gray in J2SE 5).
static BufferedImage	read(InputStream in, boolean inverseYCCKColors)
static BufferedImage	readImageFromYUVorGray(InputStream in)	Reads a JPEG image from the provided InputStream.
static BufferedImage	readRGBImageFromCMYK(InputStream in, ICC_Profile cmykProfile)	Reads a CMYK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile.
static BufferedImage	readRGBImageFromInvertedYCCK(InputStream in, ICC_Profile cmykProfile)	Reads an inverted-YCCK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile.
static BufferedImage	readRGBImageFromYCCK(InputStream in, ICC_Profile cmykProfile)	Reads a YCCK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

read

public static BufferedImage read(InputStream in)
                          throws IOException

Reads a JPEG image from the provided InputStream and convert it into a color space which can be handled by Java2D (that is RGB or Gray in J2SE 5). The image data in the file can be in the YUV, Gray, YCCK or CMYK color space.

Parameters:

in - An InputStream in the JPEG File Interchange Format (JFIF).

Returns:

a BufferedImage containing the decoded image converted into the RGB color space.

Throws:

IOException

read

public static BufferedImage read(InputStream in,
                                 boolean inverseYCCKColors)
                          throws IOException

Throws:

IOException

readImageFromYUVorGray

public static BufferedImage readImageFromYUVorGray(InputStream in)
                                            throws IOException

Reads a JPEG image from the provided InputStream. The image data must be in the YUV or the Gray color space.

Use this method, if you have already determined that the input stream contains a YUV or Gray JPEG image.

Parameters:

in - An InputStream, preferably an ImageInputStream, in the JPEG File Interchange Format (JFIF).

Returns:

a BufferedImage containing the decoded image converted into the RGB color space.

Throws:

IOException

readRGBImageFromCMYK

public static BufferedImage readRGBImageFromCMYK(InputStream in,
                                                 ICC_Profile cmykProfile)
                                          throws IOException

Reads a CMYK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile. The image data must be in the CMYK color space.

Use this method, if you have already determined that the input stream contains a CMYK JPEG image.

Parameters:

in - An InputStream, preferably an ImageInputStream, in the JPEG File Interchange Format (JFIF).

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage containing the decoded image converted into the RGB color space.

Throws:

IOException

readRGBImageFromYCCK

public static BufferedImage readRGBImageFromYCCK(InputStream in,
                                                 ICC_Profile cmykProfile)
                                          throws IOException

Reads a YCCK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile. The image data must be in the YCCK color space.

Use this method, if you have already determined that the input stream contains a YCCK JPEG image.

Parameters:

in - An InputStream, preferably an ImageInputStream, in the JPEG File Interchange Format (JFIF).

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage containing the decoded image converted into the RGB color space.

Throws:

IOException

readRGBImageFromInvertedYCCK

public static BufferedImage readRGBImageFromInvertedYCCK(InputStream in,
                                                         ICC_Profile cmykProfile)
                                                  throws IOException

Reads an inverted-YCCK JPEG image from the provided InputStream, converting the colors to RGB using the provided CMYK ICC_Profile. The image data must be in the inverted-YCCK color space.

Use this method, if you have already determined that the input stream contains an inverted-YCCK JPEG image.

Parameters:

in - An InputStream, preferably an ImageInputStream, in the JPEG File Interchange Format (JFIF).

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage containing the decoded image converted into the RGB color space.

Throws:

IOException

createRGBImageFromYCCK

public static BufferedImage createRGBImageFromYCCK(Raster ycckRaster,
                                                   ICC_Profile cmykProfile)

Creates a buffered image from a raster in the YCCK color space, converting the colors to RGB using the provided CMYK ICC_Profile.

Parameters:

ycckRaster - A raster with (at least) 4 bands of samples.

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage in the RGB color space.

createRGBImageFromInvertedYCCK

public static BufferedImage createRGBImageFromInvertedYCCK(Raster ycckRaster,
                                                           ICC_Profile cmykProfile)

Creates a buffered image from a raster in the inverted YCCK color space, converting the colors to RGB using the provided CMYK ICC_Profile.

Parameters:

ycckRaster - A raster with (at least) 4 bands of samples.

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage in the RGB color space.

createRGBImageFromCMYK

public static BufferedImage createRGBImageFromCMYK(Raster cmykRaster,
                                                   ICC_Profile cmykProfile)

Creates a buffered image from a raster in the CMYK color space, converting the colors to RGB using the provided CMYK ICC_Profile. As seen from a comment made by 'phelps' at http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4799903

Parameters:

cmykRaster - A raster with (at least) 4 bands of samples.

cmykProfile - An ICC_Profile for conversion from the CMYK color space to the RGB color space. If this parameter is null, a default profile is used.

Returns:

a BufferedImage in the RGB color space.