Apache Commons Imaging

Clone this repo:
  1. 84dc6da IMAGING-186: Add sCAL support to PNG reading and writing. Thanks to Ric Emery. This also closes #23 from GitHub. by Benedikt Ritter · 1 year, 2 months ago trunk
  2. 3a550ab Split up roundtrip test into separat test cases using the Theories runner to build up test input combinations. This also closes #22 from GitHub. by Benedikt Ritter · 1 year, 3 months ago
  3. d61a6b0 This important comment should be part of the API docs. by Benedikt Ritter · 1 year, 3 months ago
  4. 7a65b53 Drop commented out code by Benedikt Ritter · 1 year, 3 months ago
  5. 4224c58 Fix broken site build - add profile for deactivating doclint and update to latest JavaNCSS plugin version by Benedikt Ritter · 1 year, 3 months ago

Apache Commons Imaging

Build Status License

Apache Commons Imaging (previously Sanselan) is a pure-Java image library.

Documentation

More information can be found on the homepage. The JavaDoc can be browsed. Questions related to the usage of Apache Commons Imaging should be posted to the user mailing list.

Where can I get the latest release?

There is currently no stable release of Imaging. However you can pull the latest SNAPSHOT from the Apache snapshot repository by adding the snapshot repository to your pom.xml:

<repository>
  <id>apache.snapshots</id>
  <name>Apache Development Snapshot Repository</name>
  <url>https://repository.apache.org/content/repositories/snapshots/</url>
  <releases>
    <enabled>false</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository> 

Then you can use the SNAPSHOT version of Commons Imaging in your pom.xml:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-imaging</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

The last stable release of Sanselan, before it was renamed to Imaging, was 0.97. You may:

  • Download source and binaries from our download page.
  • Pull it from the central Maven repositories:
<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-sanselan</artifactId>
  <version>0.97</version>
</dependency>

Note that Commons Imaging and Commons Sanselan are neither binary nor source compatible.

Contributing

We accept PRs via github. The developer mailing list is the main channel of communication for contributors. There are some guidelines which will make applying PRs easier for us:

  • No tabs! Please use spaces for indentation.
  • Respect the code style.
  • Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
  • Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running mvn clean test.

If you plan to contribute on a regular basis, please consider filing a contributor license agreement. You can learn more about contributing via GitHub in our contribution guidelines.

License

Code is under the Apache Licence v2.

Donations

You like Apache Commons Imaging? Then donate back to the ASF to support the development.

Additional Resources