GitHub - saharNooby/qoi-java: A pure Java 8 implementation of Quite OK Image Format (original) (raw)

qoi-java

A pure Java 8 implementation of Quite OK Image Format.

This library has no runtime dependencies, including Java AWT. ImageIO/BufferedImage support is provided using separate module qoi-java-awt.

Performance

On average, when using qoi-java-awt as an ImageIO plugin, QOI can encode 7 times faster than PNG with default settings and decode 2 times faster, while having 15% less size than PNG.

To get maximum performance, you can skip ImageIO and use pixel data arrays directly.

See full results in BENCHMARK.md.

Before choosing or rejecting QOI for your project, it is recommended to run benchmarks yourself with appropriate sample files. Here is benchmark code used to produce above results.

How to Use

Add as a dependency

This library is available in Maven Central.

Maven

Gradle

dependencies { implementation 'me.saharnooby:qoi-java:1.2.1' // Also add this, if you want to use QOI with ImageIO implementation 'me.saharnooby:qoi-java-awt:1.2.1' }

Other build systems

You can download prebuilt JARs from GitHub releases or build them yourself.

Usage

Use methods in class me.saharnooby.qoi.QOIUtil:

// Read image from a file QOIImage image = QOIUtil.readFile(new File("image.qoi"));

System.out.println("Image size: " + image.getWidth() + " x " + image.getHeight());

// Access pixel data System.out.println("Red channel is " + image.getPixelData()[0]);

// Create new 1x1 RGBA image from raw pixel data byte[] pixelData = {(byte) 255, 127, 0, (byte) 255};

QOIImage orangeImage = QOIUtil.createFromPixelData(pixelData, 1, 1, 4);

// Write image to a file QOIUtil.writeImage(orangeImage, new File("orange.qoi"));

Usage with ImageIO

To use QOI with ImageIO, you need to also add qoi-java-awt dependency. It provides an ImageIO plugin, which installs automatically using service provider mechanism.

To read and write QOI images, use standard ImageIO methods:

// Read QOI image from a file BufferedImage image = ImageIO.read(new File("image.qoi"));

Objects.requireNonNull(image, "Invalid QOI image");

// Write QOI image into a file if (!ImageIO.write(image, "QOI", new File("copy.qoi"))) { throw new IllegalStateException("Image type is not supported"); }

To convert QOI images into BufferedImages and back, use methods in class me.saharnooby.qoi.QOIUtilAWT:

// Convert PNG to QOI BufferedImage image = ImageIO.read(new File("image.png")); QOIImage qoi = QOIUtilAWT.createFromBufferedImage(image); QOIUtil.writeImage(qoi, new File("image.qoi"));

// Convert QOI to PNG QOIImage secondImage = QOIUtil.readFile(new File("second-image.qoi")); BufferedImage convertedImage = QOIUtilAWT.convertToBufferedImage(secondImage); ImageIO.write(convertedImage, "PNG", new File("second-image.png"));

Building

You will need Git, Maven and JDK 8 or higher.

git clone https://github.com/saharNooby/qoi-java.git cd qoi-java mvn clean install

Compatibility

No AWT classes are used, so it should be compatible with Android. Please report compatibility issues, if they arise.

Versioning

This project uses semantic versioning.