commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dam...@apache.org
Subject svn commit: r1364723 - in /commons/proper/imaging/trunk/src/site: site.xml xdoc/index.xml xdoc/justification.xml xdoc/whyimaging.xml
Date Mon, 23 Jul 2012 17:21:16 GMT
Author: damjan
Date: Mon Jul 23 17:21:15 2012
New Revision: 1364723

URL: http://svn.apache.org/viewvc?rev=1364723&view=rev
Log:
Update some website pages, and fix broken links.


Added:
    commons/proper/imaging/trunk/src/site/xdoc/whyimaging.xml
      - copied, changed from r1364499, commons/proper/imaging/trunk/src/site/xdoc/justification.xml
Removed:
    commons/proper/imaging/trunk/src/site/xdoc/justification.xml
Modified:
    commons/proper/imaging/trunk/src/site/site.xml
    commons/proper/imaging/trunk/src/site/xdoc/index.xml

Modified: commons/proper/imaging/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/commons/proper/imaging/trunk/src/site/site.xml?rev=1364723&r1=1364722&r2=1364723&view=diff
==============================================================================
--- commons/proper/imaging/trunk/src/site/site.xml (original)
+++ commons/proper/imaging/trunk/src/site/site.xml Mon Jul 23 17:21:15 2012
@@ -38,7 +38,6 @@
       <item name="Sample Usage"            href="/sampleusage.html"/>
       <item name="Format Support"          href="/formatsupport.html"/>
       <item name="Status &amp; History"    href="/history.html"/>
-      <item name="Justification"           href="/justification.html"/>
       <item name="References"              href="/references.html"/>
       <item name="Sample Images"           href="/sampleimages.html"/>
       <item name="To Do"                   href="/todo.html"/>

Modified: commons/proper/imaging/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/commons/proper/imaging/trunk/src/site/xdoc/index.xml?rev=1364723&r1=1364722&r2=1364723&view=diff
==============================================================================
--- commons/proper/imaging/trunk/src/site/xdoc/index.xml (original)
+++ commons/proper/imaging/trunk/src/site/xdoc/index.xml Mon Jul 23 17:21:15 2012
@@ -40,7 +40,7 @@
   more formats (and supports them more correctly). It also provides easy access to metadata.
 </p>
 <p>
-  Although not yet version 1.0, sanselan is working and is used by a number of projects in
production.
+  Imaging was working and was used by a number of projects in production even before version
1.0.
 </p>
 <p>
   This project is Open Source; free as in freedom and free as in beer.

Copied: commons/proper/imaging/trunk/src/site/xdoc/whyimaging.xml (from r1364499, commons/proper/imaging/trunk/src/site/xdoc/justification.xml)
URL: http://svn.apache.org/viewvc/commons/proper/imaging/trunk/src/site/xdoc/whyimaging.xml?p2=commons/proper/imaging/trunk/src/site/xdoc/whyimaging.xml&p1=commons/proper/imaging/trunk/src/site/xdoc/justification.xml&r1=1364499&r2=1364723&rev=1364723&view=diff
==============================================================================
--- commons/proper/imaging/trunk/src/site/xdoc/justification.xml (original)
+++ commons/proper/imaging/trunk/src/site/xdoc/whyimaging.xml Mon Jul 23 17:21:15 2012
@@ -22,60 +22,60 @@ limitations under the License.
  </properties>
 <body>
 <!-- ================================================== -->
-<section name="Justification">
+<section name="Why use Commons Imaging?">
 
 <p>
     Why another image library? There are so many already.
 </p>
 
 <p>
-    Apache Commons Imaging is Pure Java. Consequently it's slow, but perfectly portable.
+    Apache Commons Imaging is written in 100% pure Java. It will run on any JVM, and any
platform, without modification.
 </p>
 
 <p>
-    It is designed to be very easy to use. See the Sample Usage section.
+    There are no dependencies. Commons Imaging only requires Java 1.5 or later.
 </p>
 
 <p>
-    This library supports some variations and encodings missed by all or most other libaries.
+    It is designed to be very easy to use. It has a simple, clean interface. Most operations
are a single Imaging method call. See the <a href="sampleusage.html">Sample Usage</a>
section.
 </p>
 
 <p>
-    Most other libraries offer little or incomplete support for ICC Profiles.
-    Commons Imaging can extract and (simply) parse embedded ICC Profiles.
-    Moreover, it applies the ICC profile by default, coverting read images to sRGB.
-    This means images are color-corrected by default.
-    see: <a href="http://en.wikipedia.org/wiki/International_Color_Consortium">http://en.wikipedia.org/wiki/International_Color_Consortium</a>,
-    <a href="http://en.wikipedia.org/wiki/SRGB">http://en.wikipedia.org/wiki/SRGB</a>
+    Commons Imaging aims to be transparent. There are no hidden buffers to dispose, no native
memory to free, no background threads.
 </p>
 
 <p>
-    Commons Imaging also lets you read in image info (ie. width, height or colorspace) and
metadata without
-    "reading" the entire image. It presents image info and metadata in a format-neutral manner.
+    It reads and writes a wide variety of image formats, and supports some variations and
encodings missed by all or most other libaries. See the <a href="formatsupport.html">Format
Support</a> list.
+</p>
+
+<p>
+    Commons Imaging does more than read and write images. Reading image info (image size,
colorspace, bit depth, etc.) and metadata is easy, and does not require reading the image
pixels.
+    It presents image info and metadata in a format-neutral manner.
     It also gives easy, structured access to format-specific info.
 </p>
 
 <p>
-    This library was written with an eye to correctness and code clarity rather than efficiency.
-    Hopefully it is easy to use, easy to extend and can be used to explore images + image
formats,
-    rather than just read images for display.
+    It supports reading and writing a variety of metadata in a structured way, including
EXIF metadata.
 </p>
 
 <p>
-    This library is Free Software/Open Source. It is available under the 
-    <a href="../license.html">Apache Software License</a>.
+    Most other libraries offer little or incomplete support for ICC Profiles.
+    Commons Imaging can extract and (simply) parse embedded ICC Profiles.
+    Moreover, it applies the ICC profile by default, coverting read images to sRGB.
+    This means images are color-corrected by default.
+    see: <a href="http://en.wikipedia.org/wiki/International_Color_Consortium">http://en.wikipedia.org/wiki/International_Color_Consortium</a>,
+    <a href="http://en.wikipedia.org/wiki/sRGB">http://en.wikipedia.org/wiki/sRGB</a>
+</p>
+
+<p>
+    Was written with an eye to correctness and code clarity, but also good performance.
+    Hopefully it is easy to use, easy to extend and can be used to explore images + image
formats,
+    rather than just read images for display.
 </p>
 
 <p>
-    Ultimately, other libraries didn't quite fill my requirements, though there are many
good ones out there.
-    What could be interesting is to get a free, portable, feature complete library that ISN'T
pure Java
-    - ie. one that uses JNI, at least for JPEG, anyhow. The obvious solution would be a JNI
wrapper
-    around libtiff, libjpeg, libpng, libgif/libungif, etc. imageloader uses this approach,
but
-    is unfinished.
-    see: <a href="http://www.libtiff.org/">http://www.libtiff.org/</a>, 
-         <a href="http://en.wikipedia.org/wiki/Libjpeg">http://en.wikipedia.org/wiki/Libjpeg</a>,
-         <a href="http://www.libpng.org/">http://www.libpng.org/</a>,
-         <a href="http://sourceforge.net/projects/libungif/">http://sourceforge.net/projects/libungif/</a>
+    It is Free Software/Open Source. It is available under the 
+    <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License</a>.
 </p>
 
 <p>
@@ -83,11 +83,11 @@ limitations under the License.
 </p>
 
 <p>
-    Commons Imaging aims to be transparent. There are no hidden buffers to dispose, no blocking
calls, no native memory to free.
+    It is network-friendly. Commons Imaging will only read the data it needs, and caches
what is read so that it isn't too heavy on the network.
 </p>
 
 <p>
-    The ColorConversions class offers methods to convert between the following color spaces:
CIE-L*CH�, CIE-L*ab, CIE-L*uv,
+    The ColorConversions class offers methods to convert between the following color spaces:
CIE-L*CH°, CIE-L*ab, CIE-L*uv,
     CMY, CMYK, HSL, HSV, Hunter-Lab, RGB, XYZ and Yxy (algorithms courtesy of EasyRGB's).
     see: <a href="http://www.easyrgb.com/">http://www.easyrgb.com/</a>
 </p>



Mime
View raw message