CINXE.COM
Commons Imaging – Commons
<!DOCTYPE html> <!-- | Generated by Apache Maven Doxia at 27 September 2024 | Rendered using Apache Maven Fluido Skin 1.3.0 --> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="author" content="Commons Documentation Team" /> <meta name="Date-Revision-yyyymmdd" content="20240927" /> <meta http-equiv="Content-Language" content="en" /> <title>Commons Imaging – Commons</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> <script type="text/javascript" src="./js/jquery.min.js"></script> <script type="text/javascript" src="./js/bootstrap.min.js"></script> <script type="text/javascript" src="./js/prettify.min.js"></script> <script type="text/javascript" src="./js/site.js"></script> </head> <body class="composite"> <a href="https://commons.apache.org/" id="bannerLeft" title="Apache Commons logo"> <img class="logo-left" src=" ./images/commons-logo.png " alt="Apache Commons logo"/> </a> <a href="index.html" id="bannerRight" title="Commons Imaging™ logo"> <img class="logo-right" src=" images/logo.png " alt="Commons Imaging™ logo"/> </a> <div class="clear"></div> <div class="navbar"> <div class="navbar-inner"> <div class="container-fluid"> <a class="brand" href="https://commons.apache.org/proper/commons-imaging/">Apache Commons Imaging ™</a> <ul class="nav"> <li id="publishDate">Last Published: 27 September 2024</li> <li class="divider">|</li> <li id="projectVersion">Version: 1.0.0-alpha6-SNAPSHOT</li> </ul> <div class="pull-right"> <ul class="nav"> <li> <a href="https://www.apachecon.com/" class="externalLink" title="ApacheCon"> ApacheCon</a> </li> <li> <a href="https://www.apache.org" class="externalLink" title="Apache"> Apache</a> </li> <li> <a href="../../" title="Commons"> Commons</a> </li> </ul> </div> </div> </div> </div> <div class="container-fluid"> <table class="layout-table"> <tr> <td class="sidebar"> <div class="well sidebar-nav"> <ul class="nav nav-list"> <li class="nav-header">Imaging</li> <li class="none active"> <a href="index.html" title="Overview"> Overview</a> </li> <li class="none"> <a href="mail-lists.html" title="Mailing Lists"> Mailing Lists</a> </li> <li class="none"> <a href="issue-tracking.html" title="Issue Tracking"> Issue Tracking</a> </li> <li class="none"> <a href="scm.html" title="Source Repository"> Source Repository</a> </li> <li class="none"> <a href="apidocs/index.html" title="Javadoc"> Javadoc</a> </li> <li class="none"> <a href="https://javadoc.io/doc/org.apache.commons/commons-imaging/" class="externalLink" title="Javadoc Archive"> Javadoc Archive</a> </li> <li class="none"> <a href="download_imaging.cgi" title="Download"> Download</a> </li> <li class="none"> <a href="security.html" title="Security"> Security</a> </li> </ul> <ul class="nav nav-list"> <li class="nav-header">Documentation</li> <li class="none"> <a href="whyimaging.html" title="Why Use Imaging"> Why Use Imaging</a> </li> <li class="none"> <a href="gettingstarted.html" title="Getting Started"> Getting Started</a> </li> <li class="none"> <a href="sampleusage.html" title="Sample Usage"> Sample Usage</a> </li> <li class="none"> <a href="formatsupport.html" title="Format Support"> Format Support</a> </li> <li class="none"> <a href="history.html" title="History"> History</a> </li> <li class="none"> <a href="sanselan-incubation-status-reports.html" title="Sanselan Incubation Status Reports"> Sanselan Incubation Status Reports</a> </li> <li class="none"> <a href="references.html" title="References"> References</a> </li> <li class="none"> <a href="sampleimages.html" title="Sample Images"> Sample Images</a> </li> <li class="none"> <a href="roadmap.html" title="Roadmap"> Roadmap</a> </li> </ul> <ul class="nav nav-list"> <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> <li class="expanded"> <a href="project-info.html" title="Project Information"> Project Information</a> <ul> <li class="none active"> <a href="index.html" title="About"> About</a> </li> <li class="none"> <a href="summary.html" title="Summary"> Summary</a> </li> <li class="none"> <a href="team.html" title="Team"> Team</a> </li> <li class="none"> <a href="scm.html" title="Source Code Management"> Source Code Management</a> </li> <li class="none"> <a href="issue-management.html" title="Issue Management"> Issue Management</a> </li> <li class="none"> <a href="mailing-lists.html" title="Mailing Lists"> Mailing Lists</a> </li> <li class="none"> <a href="dependency-info.html" title="Maven Coordinates"> Maven Coordinates</a> </li> <li class="none"> <a href="dependency-management.html" title="Dependency Management"> Dependency Management</a> </li> <li class="none"> <a href="dependencies.html" title="Dependencies"> Dependencies</a> </li> <li class="none"> <a href="dependency-convergence.html" title="Dependency Convergence"> Dependency Convergence</a> </li> <li class="none"> <a href="ci-management.html" title="CI Management"> CI Management</a> </li> <li class="none"> <a href="distribution-management.html" title="Distribution Management"> Distribution Management</a> </li> </ul> </li> <li class="collapsed"> <a href="project-reports.html" title="Project Reports"> Project Reports</a> </li> </ul> <ul class="nav nav-list"> <li class="nav-header">Commons</li> <li class="none"> <a href="../../" title="Home"> Home</a> </li> <li class="none"> <a href="https://www.apache.org/licenses/" class="externalLink" title="License"> License</a> </li> <li class="collapsed"> <a href="../../components.html" title="Components"> Components</a> </li> <li class="collapsed"> <a href="../../sandbox/index.html" title="Sandbox"> Sandbox</a> </li> <li class="collapsed"> <a href="../../dormant/index.html" title="Dormant"> Dormant</a> </li> </ul> <ul class="nav nav-list"> <li class="nav-header">General Information</li> <li class="none"> <a href="../../security.html" title="Security"> Security</a> </li> <li class="none"> <a href="../../volunteering.html" title="Volunteering"> Volunteering</a> </li> <li class="none"> <a href="../../patches.html" title="Contributing Patches"> Contributing Patches</a> </li> <li class="none"> <a href="../../building.html" title="Building Components"> Building Components</a> </li> <li class="none"> <a href="../../commons-parent-pom.html" title="Commons Parent POM"> Commons Parent POM</a> </li> <li class="none"> <a href="../../build-plugin/index.html" title="Commons Build Plugin"> Commons Build Plugin</a> </li> <li class="none"> <a href="../../release-plugin/index.html" title="Commons Release Plugin"> Commons Release Plugin</a> </li> <li class="none"> <a href="../../site-publish.html" title="Site Publication"> Site Publication</a> </li> <li class="none"> <a href="../../releases/index.html" title="Releasing Components"> Releasing Components</a> </li> <li class="none"> <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage" class="externalLink" title="Wiki"> Wiki</a> </li> </ul> <ul class="nav nav-list"> <li class="nav-header">ASF</li> <li class="none"> <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> How the ASF works</a> </li> <li class="none"> <a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> Get Involved</a> </li> <li class="none"> <a href="https://www.apache.org/dev/" class="externalLink" title="Developer Resources"> Developer Resources</a> </li> <li class="none"> <a href="https://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> Code of Conduct</a> </li> <li class="none"> <a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink" title="Privacy"> Privacy</a> </li> <li class="none"> <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> Sponsorship</a> </li> <li class="none"> <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> Thanks</a> </li> </ul> </div> <div id="poweredBy"> <a href="https://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png" /> </a> <a href="https://maven.apache.org/" title="Maven" class="builtBy"> <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" /> </a> </div> </td> <td class="content"> <section> <h2><a name="Commons_Imaging:_a_Pure-Java_Image_Library"></a>Commons Imaging: a Pure-Java Image Library</h2> <p> Apache Commons Imaging, previously known as Apache Commons Sanselan, is a library that reads and writes a variety of image formats, including fast parsing of image info (size, color space, ICC profile, etc.) and metadata. </p> <p> This library is pure Java. Compared to typical image I/O libraries in native code, it's more portable, and should be more reliable and more secure against corrupt/malicious images, yet still performs reasonably well. It's easier to use than ImageIO/JAI/java.awt.Toolkit (Sun/Java's image support), supports more formats (and supports them more correctly). It also provides easy access to metadata. </p> <p> Imaging was working and was used by a number of projects in production even before reaching its initial release as an Apache Commons component. </p> <p> This project is Open Source; free as in freedom and free as in beer. It is available under the ASF (Apache) License. This is a non-viral Open Source license. </p> <p> </p> <ul> <li><a href="whyimaging.html">Why Use Commons Imaging?</a></li> <li><a href="gettingstarted.html">Getting Started</a></li> </ul> </section> <section> <h2><a name="Documentation"></a>Documentation</h2> <p> A getting started <a href="gettingstarted.html">guide</a> is available together with various <a href="project-reports.html">project reports</a>. </p> <p> The Javadoc API documents are available online: </p> <ul> <li>The <a href="apidocs/index.html">latest API docs</a></li> <li>Older releases - see the <a href="history.html">Release History</a> page</li> </ul> <p> The <a href="scm.html">source repository</a> can be <a class="externalLink" href="https://gitbox.apache.org/repos/asf?p=commons-imaging.git">browsed</a>, or you can browse/contribute via <a class="externalLink" href="https://github.com/apache/commons-imaging">GitHub</a>. </p> </section> <section> <h2><a name="Release_Information"></a>Release Information</h2> <section> <h3><a name="Help_Needed.21"></a>Help Needed!</h3> If you want to help out you may: <ul> <li>Look through the <a class="externalLink" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20IMAGING%20AND%20resolution%20%3D%20Unresolved%20AND%20fixVersion%20%3D%20%22Patch%20Needed%22%20ORDER%20BY%20priority%20DESC">issues waiting for a patch</a></li> <li>Look through the <i>Needs Work</i> tags in the <a href="taglist.html">TagList report</a></li> <li>Contribute a patch</li> <li>Create a PR via <a class="externalLink" href="https://github.com/apache/commons-imaging">Github</a></li> </ul> Make sure to read through our <a class="externalLink" href="https://commons.apache.org/patches.html">guide lines for contributing patches</a> before you start coding. This will stream line the process of getting your contributions into the code. </section> <p> For information on previous releases see the <a href="history.html">Release History</a>, and to download previous releases see the <a class="externalLink" href="https://archive.apache.org/dist/commons/sanselan/">Commons Sanselan Archive</a>. </p> </section> <section> <h2><a name="Support"></a>Support</h2> <p> The <a href="mail-lists.html">commons mailing lists</a> act as the main support forum. The user list is suitable for most library usage queries. The dev list is intended for the development discussion. Please remember that the lists are shared between all commons components, so prefix your email by [imaging]. </p> <p> Bug reports and enhancements are also welcomed via the <a href="issue-tracking.html">JIRA</a> issue tracker. Please read the instructions carefully. </p> </section> </td> </tr> </table> </div> <div class="footer"> <p>Copyright © 2007-2024 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.</p> <div class="center">Apache Commons, Apache Commons Imaging, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> </div> </body> </html>