How to write JPEG 2000 Images in Java

Why do JPEG2000 Images cause problems for Java Developers?

ImageIO does not fully support JPEG2000 images. It supports the jp2 subformat but not jpx.

What options are there for supporting JPEG files in Java?

Java does have some support for JPEG2000 files in ImageIO. There are also Open Source and Commercial options available, including JDeli which offers pure Java support and the option to be added as ImageIO plugin.

We recommend JDeli for working with JGEG 2000 files because it is a pure, complete Java implementation with no known security issues. It can be used with existing ImageIO code and has an API to write new code so we will document that in this article. It can also read JPEG 2000 files and supports several other complex Image formats such as AVIF, HEIC and WEBP.

How to write an image as a JPEG 2000 file with ImageIO

1. ImageIO will need the JAI_ImageIO plugin installed.
2. Create a File (or OutputStream) object for the JPEG2000 output.
3. Pass image, jpg type and File (or OutputStream) object into write method

and the Java code to write JPEG2000 with ImageIO…

File file = new File("/path/to/outputFile.jp2"));

ImageIO.write(bufferedImage, "jpeg2000", file);

• Download the JDeli trial jar with our ImageIO plugin
• Follow the support documentation to install

How to write an image as a JPEG 2000 file with JDeli

1. Add JDeli to your class or module path. (download link to the trial jar).
2. Create a File (or OutputStream) object
3. Pass image, JPEG2000 type and File (or OutputStream) object into write method

and the Java code to write JPEG2000 with JDeli…

File file = new File("/path/to/outputFile.jp2"));

JDeli.write(bufferedImage, "jp2", file);


//In JDeli you can also use a typesafe version

JDeli.write(bufferedImage, OutputFormat.JPEG2000, file);


//or pass in a Jpeg2000EncoderOptions object for more control over JPEG2000 image output

Jpeg2000EncoderOptions options = new Jpeg2000EncoderOptions();

JDeli.write(bufferedImage, options, file);

Other useful JPEG2000 links

• Related articles on our support site.
• How to read JPEG 2000 files in Java.
• How to What is JPEG 2000

How can JDeli help?

JDeli is the best enterprise-level Java image library for image manipulation. You can use JDeli to read, write and convert your images as it has JPEG2000 support. Visit our documentation to learn more about JDeli’s JPEG2000 support.

// Read an image
BufferedImage bufferedImage = JDeli.read(avifImageFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(dicomImageFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(heicImageFile);

// Write an image
JDeli.write(bufferedImage, "heic", outputStreamOrFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(jpegImageFile);

// Write an image
JDeli.write(bufferedImage, "jpeg", outputStreamOrFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(jpeg2000ImageFile);

// Write an image
JDeli.write(bufferedImage, "jpx", outputStreamOrFile);

// Write an image
JDeli.write(bufferedImage, "pdf", outputStreamOrFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(pngImageFile);

// Write an image
JDeli.write(bufferedImage, "png", outputStreamOrFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(tiffImageFile);

// Write an image
JDeli.write(bufferedImage, "tiff", outputStreamOrFile);

// Read an image
BufferedImage bufferedImage = JDeli.read(webpImageFile);

// Write an image
JDeli.write(bufferedImage, "webp", outputStreamOrFile);