Mirror of Apache Commons Imaging
Clone or download
Latest commit eb98398 Aug 25, 2018

README.md

Apache Commons Imaging

Build Status

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

Documentation

More information can be found on the Apache Commons Imaging 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 Pull Requests 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

This code is under the Apache Licence v2.

See the NOTICE.txt file for required notices and attributions.

Donations

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

Additional Resources