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 Details

    • 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.