search

jai-imageio / jai-imageio-core

JAI ImageIO Core (without javax.media.jai dependencies)
Other
234 stars 88 forks source link

readme

jai-imageio-core (standalone)

Build Status

NOTE: This is a community fork of the original java.net project jai-imageio-core (which is no longer available upstream).

This project adds read/write support for the following file types to Java's ImageIO:

Note that most of these formats are now supported by Java 9.

The classes of this projects are not generally used directly, but through the SPI plugin mechanism of ImageIO. See the ImageIO guide for details.

The implementations provided by this project use the package name com.github.jaiimageio, note that other implementations might be provided by your Java installation or other dependencies.

This project is called 'standalone' as unlike the original jai-imageio-core it has removed dependencies to jai-core packages (javax.media.jai) and JPEG 2000 (jj2000). This version also does not include the C implementations from libJIIO, meaning that this version is platform independent and fully redistributable under the 3-clause BSD license in LICENSE.txt (and thus is Apache and GPL compatible).

JPEG 2000 support is available as an additional module jai-imageio-jpeg2000 as it has a different (non-GPL compatible) license.

If you are not concerned about GPL compatibility or source code availability, you may want to check out https://github.com/geosolutions-it/imageio-ext/ which is actively maintained and extends the original imageio with many useful features, but depends on the binary distribution of jai_core.

Contribute

You are encouraged to raise a Github Pull Request with any suggested improvements.

You can also raise an issue - your stacktrace might still be of use to someone else.

jai-imageio GitHub committers and contributors include (in no particular order):

Usage

This project requires Java 6 or newer. To build this project, use Apache Maven 3.0.5 or newer and run:

mvn clean install

To use jai-imageio-core from a Maven project, add:

<dependency>
    <groupId>com.github.jai-imageio</groupId>
    <artifactId>jai-imageio-core</artifactId>
    <version>1.3.1</version>
</dependency>

To find the latest released <version> above, see jai-imageio-core at BinTray

jai-imageio-core is mirrored to Maven Central.

Alternatively (e.g. right after a new release), you can use this explicit bintray repository:

<repositories>
  <repository>
    <id>bintray-jai-imageio</id>
    <name>jai-imageio at bintray</name>
    <url>https://dl.bintray.com/jai-imageio/maven/</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

The Maven repository include additional artifact types such as javadoc and sources which should be picked up by your IDE's Maven integration.

Download

To download the binary JAR, see the Downloads at BinTray or the GitHub releases

Javadoc

Standalone Javadoc for jai-imageio-core is also provided.

Copyright and licenses

The source code for the jai-imageio-core project is copyrighted code that is licensed to individuals or companies who download or otherwise access the code.

The complete copyright notice for this project is in COPYRIGHT.txt

The source code license for this project is BSD 3-clause with an additional nuclear disclaimer, see LICENSE.txt.

Changelog

More info

These links are no longer available as java.net has shut down: