Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/cosium/jai-imageio-core


https://github.com/cosium/jai-imageio-core

Last synced: over 1 year ago
JSON representation

Awesome Lists containing this project

README 

          
jai-imageio-core (standalone)

=============================



[![Build Status](https://travis-ci.org/Cosium/jai-imageio-core.svg?branch=master)](https://travis-ci.org/Cosium/jai-imageio-core)



NOTE: This is a fork of the

[original jai-imageio-core](https://java.net/projects/jai-imageio-core/)

(which is no longer maintained).



This project adds read/write support for the following file types to 

Java's [ImageIO](http://docs.oracle.com/javase/8/docs/api/javax/imageio/ImageIO.html):

 

* wbmp

* bmp

* pcx

* pnm

* raw

* tiff

* gif (write)



The classes of this projects are not generally used directly, but through

the SPI plugin mechanism of ImageIO. See the 

[ImageIO guide](http://docs.oracle.com/javase/8/docs/technotes/guides/imageio/spec/imageio_guideTOC.fm.html)

for details.



This project is called 'standalone' as unlike the [original

jai-imageio-core](https://java.net/projects/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](LICENSE.txt) (and thus is Apache and GPL compatible).



JPEG 2000 support is available as an additional module 

[jai-imageio-jpeg2000](https://github.com/jai-imageio/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 might instead want to use

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](

http://download.osgeo.org/webdav/geotools/javax/media/jai_core/1.1.3/).



Contribute

----------



You are encouraged to raise a 

[Github Pull Request](https://github.com/jai-imageio/jai-imageio-core/pulls)

with any suggested improvements.



You can also raise an

[issue](https://github.com/jai-imageio/jai-imageio-core/issues) - your stacktrace

might still be of use to someone else.



Current committers and contributors:



* [Stian Soiland-Reyes](http://orcid.org/0000-0001-9842-9718)

* [John Hewson](http://jahewson.com/)

* [Peter Hull](https://github.com/peterhull90)

* [Mark Carroll](https://github.com/mtbc)

* [Robin Stevens](https://github.com/PissedCapslock)

* [Yannick De Turck](https://github.com/yannickdeturck)



Usage

-----



This project requires Java 5 or newer.  To build this project, use [Apache

Maven](https://maven.apache.org/download.cgi) 

2.2.1 or newer and run:



    mvn clean install



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



    

        com.github.jai-imageio

        jai-imageio-core

        1.3.1

    



To find the latest `` above, see 

[jai-imageio-core at BinTray](https://bintray.com/jai-imageio/maven/jai-imageio-core-standalone)



jai-imageio-core is [mirrored to Maven Central](https://repo1.maven.org/maven2/com/github/jai-imageio/jai-imageio-core/). 



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

explicit [bintray repository](https://dl.bintray.com/jai-imageio/maven/):



    

      

        bintray-jai-imageio

        jai-imageio at bintray

        https://dl.bintray.com/jai-imageio/maven/

        

          false

        

      

    



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](https://bintray.com/jai-imageio/maven/jai-imageio-core-standalone/view)

or the [GitHub releases](https://github.com/jai-imageio/jai-imageio-core/releases)



Javadoc

-------



Standalone [Javadoc for jai-imageio-core](http://jai-imageio.github.io/jai-imageio-core/javadoc/) is also

provided.



Copyright and licenses

----------------------



* Copyright © 2005 Sun Microsystems

* Copyright © 2010-2014 University of Manchester

* Copyright © 2010-2015 Stian Soiland-Reyes

* Copyright © 2015 Peter Hull

* Copyright © 2015 Yannick De Turck

* Copyright © 2015 Robin Stevens

* Copyright © 2015 Mark Carroll



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](COPYRIGHT.txt)



The source code license for this project is **BSD 3-clause** with an

additional nuclear disclaimer, see

[LICENSE.txt](LICENSE.txt)



Changelog

---------



* 1.3.1 - Available as OSGi bundle (issue #13). 

      Fixed memory leak in TIFFImageWriter (issue #14).

* 1.3.0 - Java package changed to com.github.jaiimageio (issue #10).

    MANIFEST.MF metadata corrected.

* 1.2.1 - Version 1.2.1 released. Pushing to Maven Central and BinTray. 

      Workaround for OpenJDK8 libjpeg bug (issue #6).

      groupId changed from net.java.dev.jai-imageio to com.github.jai-imageio.

      Fix for PNM ASCII write (issue #7).

* 1.2-pre-dr-b04-2014-09-13 - Removed last jpeg2000 plugin. Javadoc now includes overview.      

* 1.2-pre-dr-b04-2014-09-12 - Separated out [JPEG 2000](https://github.com/jai-imageio/jai-imageio-core/issues/4)

      support from [jai-imageio-core](http://github.com/jai-imageio/jai-imageio-core)

      for [licensing reasons](https://github.com/jai-imageio/jai-imageio-core/issues/4).

      Re-enabled junit test (issue #5).

* 1.2-pre-dr-b04-2013-04-23 - Updated README and pom, newer maven plugins, removed

  broken links to dev.java.net. Javadocs included and published at

  http://jai-imageio.github.com/jai-imageio-core/

* 1.2-pre-dr-b04-2011-07-04 - Avoid Maven many build warnings. Fixed character set.

* 1.2-pre-dr-b04-2010-04-30 - Initial Maven version, based on CVS checkout from

  dev.java.net, but with Maven pom.xml and only code covered

  by open source license.



More info

---------



* https://github.com/jai-imageio/jai-imageio-core

* http://jai-imageio.github.io/jai-imageio-core/javadoc/

* https://java.net/projects/jai-imageio-core/

* http://www.oracle.com/technetwork/java/current-142188.html

* http://download.java.net/media/jai/builds/release/1_1_3/

* http://docs.oracle.com/javase/8/docs/api/javax/imageio/ImageIO.html

* http://docs.oracle.com/javase/8/docs/technotes/guides/imageio/index.html 

* http://docs.oracle.com/javase/8/docs/technotes/guides/imageio/spec/imageio_guideTOC.fm.html