You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlgraphics.apache.org by bu...@apache.org on 2012/04/15 07:51:33 UTC
svn commit: r813022 - in /websites/staging/xmlgraphics/trunk/content: ./
commons/ commons/bugs.html commons/changes.html commons/download.html
commons/image-loader.html commons/index.html commons/postscript.html
Author: buildbot
Date: Sun Apr 15 05:51:31 2012
New Revision: 813022
Log:
Staging update by buildbot for xmlgraphics
Added:
websites/staging/xmlgraphics/trunk/content/commons/
websites/staging/xmlgraphics/trunk/content/commons/bugs.html
websites/staging/xmlgraphics/trunk/content/commons/changes.html
websites/staging/xmlgraphics/trunk/content/commons/download.html
websites/staging/xmlgraphics/trunk/content/commons/image-loader.html
websites/staging/xmlgraphics/trunk/content/commons/index.html
websites/staging/xmlgraphics/trunk/content/commons/postscript.html
Modified:
websites/staging/xmlgraphics/trunk/content/ (props changed)
Propchange: websites/staging/xmlgraphics/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sun Apr 15 05:51:31 2012
@@ -1 +1 @@
-1326257
+1326258
Added: websites/staging/xmlgraphics/trunk/content/commons/bugs.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/bugs.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/bugs.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,101 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Apache⢠XML Graphics Commons: Bugs and Other Trackable Issues</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>Apache⢠XML Graphics Commons: Bugs and Other Trackable Issues</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><p><version>$Revision: 911792 $</version></p>
+<p>Information on this page applies to enhancement requests and other trackable issues as well as bugs.</p>
+<h1 id="issues_existing">Reported Issues</h1>
+<p>A list of unresolved reported bugs can be found at <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=XMLGraphicsCommons&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=">XML Graphics Commons Open Bugs (Bugzilla)</a> . If you have an interest in an issue already reported, please consider the following:</p>
+<ul>
+<li>
+<p>If you have insight that may help developers solve an existing problem, please add comments and/or file attachments to the existing issue.</p>
+</li>
+<li>
+<p>If you would like to track the status of the issue, consider adding your email address to the list of "CC" recipients, so that you will receive an email as changes are made to the issue.</p>
+</li>
+</ul>
+<h1 id="issues_new">Unreported Issues (Reporting New Issues)</h1>
+<p>User reports of bugs and requests for enhancements are extremely important parts of XML Graphics Commons development, and we appreciate the time you take to help us track these issues down.</p>
+<ul>
+<li>
+<p>Review the <a href="http://issues.apache.org/bugzilla/page.cgi?id=bug-writing.html">Apache Bug Writing Guidelines</a> before submitting your report.</p>
+</li>
+<li>
+<p>Enter a new issue report at the <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=XMLGraphicsCommons">XML Graphics Commons issue database (Bugzilla)</a> . You will be asked to login to an existing Bugzilla account or to create a new one. When entering the bug report, please make your description complete and concise. If appropriate, attach a minimal fo file to your report which demonstrates the problem.</p>
+</li>
+<li>
+<p>After submission, a copy of your bug report will be automatically sent to the <a href="http://xmlgraphics.apache.org/mail.html#xmlgraphics-general">XML Graphics General discussion list</a> .</p>
+</li>
+</ul></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/xmlgraphics/trunk/content/commons/changes.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/changes.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/changes.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,393 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>History of Changes</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>History of Changes</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><p><a href="changes.rss"></a> </p>
+<h1 id="introduction">Introduction and explanation of symbols</h1>
+<p>Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types:<icon alt="add" src="images/add.jpg"></icon>=add,<icon alt="fix" src="images/fix.jpg"></icon>=fix,<icon alt="remove" src="images/remove.jpg"></icon>=remove,<icon alt="update" src="images/update.jpg"></icon>=update</p>
+<h1 id="version_Trunk">Version Trunk (n/a)</h1>
+<h2 id="Code_Trunk">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Support rdf:resource attributes in XMP. Committed by GA. Thanks to Brian Carlson. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=50497">50497</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Should never use Error to report runtime errors. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47174">47174</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Ensure that throwables have meaningful messages. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47175">47175</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Support for T.4 Group 3 1D encoding. Committed by PH. Thanks to JM and Mehdi Houshmand. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51911">51911</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed a bug formatting ISO 8601 dates with negative two-digit time zones. Committed by JM. Thanks to Florian Barbera Vila Bollain. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51039">51039</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Allow to override priority when registering an ImageWriter on the ImageWriterRegistry. Committed by JM. Thanks to Joshua Marquart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49696">49696</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fix for TIFFs which report zero as their resolution. This resulted in an exception. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="remove" src="images/remove.jpg"></icon>Removed dependency on com.sun classes to achieve compatibility with Apache Harmony, OpenJDK and possibly other JVMs. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="remove" src="images/remove.jpg"></icon>Removal of the deprecated <code>TextHandler.drawString(String, float, float)</code> method. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>Minor build improvements to eliminate warning and parameterize junit formatting. Eliminate (5) deprecation warnings. Committed by GA.</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>Various code style fixes Committed by JM. Thanks to Glenn Adams. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49703">49703</a> .</p>
+</li>
+</ul>
+<h2 id="contributors_Trunk">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Glenn Adams (GA), Jeremias Märki (JM), (PH).</p>
+<p>This is a list of other contributors:<br></br>Brian Carlson, Florian Barbera Vila Bollain, Glenn Adams, JM and Mehdi Houshmand, Joshua Marquart, Sebastian Bazley.</p>
+<h1 id="version_1.4">Version 1.4 (7 July 2010)</h1>
+<h2 id="Code_1.4">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added getter and setter for enabling/disabling comments in PSGenerator. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49250">49250</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Small optimization which only generates code for a clipping area if an element is not fully inside the clipping area. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49056">49056</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added option to enable/disable the generation of compact vs. verbose PostScript code. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added shorthands for many PostScript commands to get more compact PostScript files. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added code for supporting the AdobeStandardCyrillic encoding. Committed by JM. Thanks to Andrey Koltunov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48395">48395</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added interface for Color Conversions. Committed by CB. Thanks to Peter Hancock. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48237">48237</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added support for configurable additional penalties for preloader, loader and converter plug-ins in the ImageImplRegistry (in addition to the hard-coded penalties). Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Enabled native encoding of CMYK images for PostScript output. Committed by JM. Thanks to Venkat Reddy. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48264">48264</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Support loading of ICC Profiles from PNG and JPEG when used through ImageIO. Committed by MB.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added 60 seconds expiration for invalid URIs in the image cache to recover from temporarily unavailable images. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added TexturePaint support for PSGraphics2D (PostScript tiling patterns). Committed by JM. Thanks to JiÅÃ Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46583">46583</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>XMP framework: Added support for the structure property shorthand form and for specifying simple property values as attributes on rdf:Description elements. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added RefinedImageFlavor to the image loading framework for better refinement of image flavors. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Two properties didn't get copied in copy constructor of PSState. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49364">49364</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for detecting multi-strip CCITT-encoded TIFFs. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: Properly handle file URLs where URL.getHost() is an empty string. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: Clip area got lost while cloning GraphicContext. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Switched from linear RGB to sRGB for the fallback color model, in order to avoid trouble with some images (CMYK TIFF, for example). Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: reset graphic state when a page is finished in PostScript. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: glyph names starting with âuâ but not in the âofficialâ glyph list could cause a StringIndexOutOfBoundsException because they were parsed as u1234-like unicode values. Committed by VH.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: Streams were not closed in Service class. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Catching IllegalArgumentException in XMPSerializer when the Transformer implementation in use doesn't support the INDENT key. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Added the ability to assign a string value for a key in a postscript dictionary. Committed by AC. Thanks to JiÅÃ Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46292">46292</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Made loading images via Image I/O more robust: A PNG with a zero resolution should fall back to the default resolution. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45789">45789</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>JPEGPreloader: Fixed interpretation of JPEG resolution when "dots per centimeter" is specified. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45835">45835</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: Added missing start/endPrefixMapping() calls when serializing XMP packets. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>Optimization for PostScript state handling in (E)PSDocumentGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49339">49339</a> .</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>PS output: Using shorthand procedures for rectangles instead of the generic shape processor. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49338">49338</a> .</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>Moved method disableClipping from AbstractPSDocumentGraphics2D to PSGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49337">49337</a> .</p>
+</li>
+</ul>
+<h2 id="contributors_1.4">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Adrian Cumiskey (AC), Chris Bowditch (CB), Jeremias Märki (JM), Max Berger (MB), Vincent Hennebert (VH).</p>
+<p>This is a list of other contributors:<br></br>Andrey Koltunov, Calixte Denizet, JiÅà Kunhart, Julien Aymé, Peter Hancock, Venkat Reddy.</p>
+<h1 id="version_1.3.1">Version 1.3.1 (11 June 2008)</h1>
+<h2 id="Code_1.3.1">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added fallbacks for Type 1 fonts which don't have the normal "one", "two" etc. glyphs, but actually only provide "oneoldstyle", "twooldstyle" etc. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added an image loader for XML Graphics Commons' internal TIFF codec. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added image processing hints to ignore an optionally embedded color profile in JPEG images. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Made file URLs with a host (as happens when using UNC paths) work when loading images. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44902">44902</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for classpath resources: the code doesn't just check the system class loader anymore. Committed by MB.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for a potential multi-threading issue concerning the use of the java.text package. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for extracting ICC color profiles from JPEG images. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed two cases of unclosed input streams in image loader code. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for unhandled NumberFormatException in Glpyhs when a unknown glyph name starting with "u" is found. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for ImageEncodingHelper which produced false results if an image's sample model used BGR instead of RGB. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed behaviour for the cases where a corrupt PNG image is encountered. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for EOFException when pre-loading very small PNG images (file size < 88 bytes). Committed by JM.</p>
+</li>
+</ul>
+<h2 id="contributors_1.3.1">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Jeremias Märki (JM), Max Berger (MB).</p>
+<h1 id="version_1.3">Version 1.3 (07 Feb 2008)</h1>
+<h2 id="Code_1.3">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Image Loading: Support for passing in SAXSource instance. Committed by JM. Thanks to Adam Strzelecki. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44466">44466</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>The package org.apache.xmlgraphics.image.loader was added. It contains a general image loading framework for various image formats (bitmap & vector). Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>XMP: Added support for structured properties. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>PostScript: Added classes for "BoundingBox" DSC comments. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added support for classpath resources (find files in JAR files in the classpath using their MIME type) Committed by JM. Thanks to Max Berger. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42980">42980</a> .</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Application of the patch in Bugzilla 43069: New Macro safe-set-page-device which guards against the possibility of invalid/unsupported postscript key/values being issued to the implementing postscript page device Committed by CB. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43069">43069</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for ISO 8601 date formatting with negative time zones in the XMP package. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix for XMP serialization: arrays with only one entry were serialized as simple property which could lead to information loss for merge operations. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>PostScript: Fixed %%EOF checking for nested documents. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>PostScript: Improved robustness of DSC parsing (multi-line comments with no value on the first line don't cause crashes anymore, fallback for unparsable DSC comments). Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed a possible NPE in the TIFF codec (in the TIFFImage constructor). Committed by JM. Thanks to Sergey Orlov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43120">43120</a> .</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>Support for Java 1.3 has been dropped. Java 1.4 or later is required now. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="update" src="images/update.jpg"></icon>PostScript: Improved PSImageUtils by introducing the ImageEncoder interface and allowing for streams instead of byte arrays for data transfer which can lower memory consumption. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="contributors_1.3">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Chris Bowditch (CB), Jeremias Märki (JM).</p>
+<p>This is a list of other contributors:<br></br>Adam Strzelecki, Adrian Cumiskey, Max Berger, Sergey Orlov.</p>
+<h1 id="version_1.2">Version 1.2 (21 July 2007)</h1>
+<h2 id="Code_1.2">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added support for CMYK and GRAY color spaces for PSGenerator (moved there from PSGraphics2D). Committed by JM. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42507">42507</a> .</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed literal text string escaping in PSGenerator. Some characters were not properly escaped. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Fixed the PDF/A namespace according to ISO-19005-1:2005/Cor.1:2007 and deprecated the use of the draft PDF/A namespace used by Adobe Acrobat 7.x. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="contributors_1.2">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Jeremias Märki (JM).</p>
+<p>This is a list of other contributors:<br></br>Adrian Cumiskey.</p>
+<h1 id="version_1.1">Version 1.1 (22 Dec 2006)</h1>
+<h2 id="Code_1.1">Changes to the Code Base</h2>
+<ul>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Added the start of an XMP metadata framework. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>ImageWriter abstraction now supports writing multi-page formats like TIFF. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>ImageWriter implementation for TIFF output using Image I/O API. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="add" src="images/add.jpg"></icon>Default implementation for AbstractGraphics2D.drawText(ACI, float, float) so PSGraphics2D supports painting text using the AttributedCharacterIterator. Committed by JM. Thanks to Max Berger.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Various fixes and improvements in the ImageWriter abstraction. Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="fix" src="images/fix.jpg"></icon>Bugfix: The generation of the PostScript setdash command was assuming that only integer values can be used but that isn't the case. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="contributors_1.1">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Jeremias Märki (JM).</p>
+<p>This is a list of other contributors:<br></br>Max Berger.</p>
+<h1 id="version_1.0">Version 1.0 (17 Apr 2006)</h1>
+<h2 id="Code_1.0">Changes to the Code Base</h2>
+<ul>
+<li><icon alt="add" src="images/add.jpg"></icon>Initial release with several components from Batik and FOP: Image codecs, Image writer abstraction, I/O classes, Java2D helpers, PostScript library with Graphics2D implementation. Committed by JM.</li>
+</ul>
+<h2 id="contributors_1.0">Contributors to this release</h2>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br></br>Jeremias Märki (JM).</p>
+<h1 id="all-committers">All Committers</h1>
+<p>This is a list of all people who have ever participated as committers on this project.</p>
+<ul>
+<li>
+<p>Glenn Adams (GA)</p>
+</li>
+<li>
+<p>Max Berger (MB)</p>
+</li>
+<li>
+<p>Chris Bowditch (CB)</p>
+</li>
+<li>
+<p>Adrian Cumiskey (AC)</p>
+</li>
+<li>
+<p>Christian Geisert (CG)</p>
+</li>
+<li>
+<p>Vincent Hennebert (VH)</p>
+</li>
+<li>
+<p>Clay Leeds (CL)</p>
+</li>
+<li>
+<p>Jeremias Märki (JM)</p>
+</li>
+<li>
+<p>Cameron McCormack (CM)</p>
+</li>
+<li>
+<p>Simon Pepping (SP)</p>
+</li>
+<li>
+<p>Volunteer needed (open)</p>
+</li>
+</ul></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/xmlgraphics/trunk/content/commons/download.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/download.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/download.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,98 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Download Apache⢠XML Graphics Commons</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>Download Apache⢠XML Graphics Commons</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><h1 id="release">Download a Release</h1>
+<p>Source ("-src") and binary ("-bin") distributions can be downloaded from a <a href="http://www.apache.org/dyn/closer.cgi/xmlgraphics/commons">Apache⢠XML Graphics Commons Distribution Mirror</a> .</p>
+<h1 id="svn">Download from Subversion</h1>
+<p>The latest source code is available directly from the Subversion repository:</p>
+<table>
+<thead>
+<tr>
+<th>Trunk</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Repository URL</td>
+</tr>
+<tr>
+<td>Web view</td>
+</tr>
+<tr>
+<td>Committers need to replace " <code>http</code> " with " <code>https</code> " and then log in so they can gain write access!</td>
+</tr>
+</tbody>
+</table></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/xmlgraphics/trunk/content/commons/image-loader.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/image-loader.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/image-loader.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,210 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Apache⢠XML Graphics Commons: Image Loader Framework</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>Apache⢠XML Graphics Commons: Image Loader Framework</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><h1 id="overview">Overview</h1>
+<p>Apache⢠XML Graphics Commons contains a unified framework for loading and processing images (bitmap and vector). The package name is <code>org.apache.xmlgraphics.image.loader</code> . Key features:</p>
+<ul>
+<li>
+<p>Unified basic API for all supported image types.</p>
+</li>
+<li>
+<p>Image "Preloading": It allows automatic detection on the image content type and can extract the intrinsic size (in pixels and length units) of the image without loading the whole image into memory in most cases. <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> uses this as it only needs the size of the image to do the layout. The image is only fully read at the rendering stage.</p>
+</li>
+<li>
+<p>Image conversion facility: Images can be converted into different representations depending on the needs of the consumer.</p>
+</li>
+<li>
+<p>Supported formats: All bitmap formats for which there are codecs for the ImageIO API (like JPEG, PNG, GIF etc.), EPS, EMF. These formats are bundled. Other formats such as SVG and WMF are available through plug-ins hosted elsewhere.</p>
+</li>
+<li>
+<p>Supported in-memory representations:</p>
+<ul>
+<li>
+<p>RenderedImage/BufferedImage</p>
+</li>
+<li>
+<p>raw/undecoded (JPEG, EPS, CCITT group 3/4)</p>
+</li>
+<li>
+<p>Java2D (Images painted through Graphics2D)</p>
+</li>
+<li>
+<p>XML DOM (for SVG, MathML etc.)</p>
+</li>
+<li>
+<p>Additional representations can be added as necessary.</p>
+</li>
+</ul>
+</li>
+<li>
+<p>Custom image loaders and converters can be dynamically plugged in. Automatic plug-in detection through the application classpath.</p>
+</li>
+<li>
+<p>An image cache speeds up the processing for images that are requested multiple times.</p>
+</li>
+</ul>
+<h1 id="tutorial">Tutorial</h1>
+<h2 id="manager-setup">Setting up the manager</h2>
+<p>Before we can start to work with the package we need to set up the <code>ImageManager</code> . It provides convenience methods to load and convert images and holds the image cache.</p>
+<p>The <code>ImageManager</code> needs an <code>ImageContext</code> . This interface provides the <code>ImageManager</code> with important context and configuration data. Currently this is only the source resolution. The <code>ImageManager</code> and <code>ImageContext</code> are intended to be shared within an application.</p>
+<p>import org.apache.xmlgraphics.image.loader.ImageContext;
+import org.apache.xmlgraphics.image.loader.ImageManager;
+import org.apache.xmlgraphics.image.loader.impl.DefaultImageContext;</p>
+<p>[..]</p>
+<p>ImageManager imageManager = new ImageManager(new DefaultImageContext());
+ In this example, <code>DefaultImageContext</code> is used. You may need to write your own implementation of <code>ImageContext</code> for your use case.</p>
+<h2 id="preloading">Preloading an image</h2>
+<p>In order to load an image, it needs to be "preloaded" first, i.e. the image content type is detected and the intrinsic size of the image is determined. The result of this process is an <code>ImageInfo</code> instance which contains the URI, MIME type and intrinsic size. In most cases, this is done without loading the whole image (see SPI section below for information on exceptions to this rule).</p>
+<p>Preloading is normally done through the <code>ImageManager</code> 's <code>getImageInfo()</code> method. For this operation an <code>ImageSessionContext</code> needs to be provided. It is responsible for supplying JAXP <code>Source</code> objects, URI resolution and providing other information needed for the image operations. In simple cases you can simply use <code>DefaultImageSessionContext</code> , but often you will want to write your own implementation of <code>ImageSessionContext</code> . In that case, it's recommended to subclass <code>AbstractImageSessionContext</code> which lets you avoid rewriting a lot of code for providing <code>Source</code> objects.</p>
+<p>import org.apache.xmlgraphics.image.loader.ImageInfo;
+import org.apache.xmlgraphics.image.loader.ImageSessionContext;
+import org.apache.xmlgraphics.image.loader.impl.DefaultImageSessionContext;</p>
+<p>[..]
+ ImageSessionContext sessionContext = new DefaultImageSessionContext(
+ imageManager.getImageContext(), null);</p>
+<p>ImageInfo info = imageManager.getImageInfo(uri, sessionContext);</p>
+<h2 id="loading">Loading an image</h2>
+<p>Once the image is "preloaded", it can be fully loaded in the form/flavor that is needed by the consuming application. The required flavor is indicated through the <code>ImageFlavor</code> class. If you want the image as a bitmap image in memory, you could request an <code>ImageFlavor.RENDERED_IMAGE</code> . Again, the <code>ImageSessionContext</code> will be needed.</p>
+<p>import org.apache.xmlgraphics.image.loader.Image;
+import org.apache.xmlgraphics.image.loader.ImageFlavor;</p>
+<p>[..]
+ Image img = this.imageManager.getImage(
+ info, ImageFlavor.RENDERED_IMAGE, sessionContext);</p>
+<p>ImageRendered imageRend = (ImageRendered)img;
+ RenderedImage ri = imageRend.getRenderedImage();
+ //...and do anything with the RenderedImage</p>
+<p>In this example above, we simply acquire the image as a RenderedImage instance. If the original image was a vector graphic image (SVG, WMF etc.), it's automatically converted to a bitmap image. Note: The resolution of the created image is controlled by the target resolution returned by the <code>ImageSessionContext</code> .</p>
+<p>Of course, the framework can only provide images in the formats, it has image loaders or image converters for. An example: It is possible to load EPS images, but they can only be provided in raw form. In order to provide it as a bitmap image, a PostScript interpreter would be needed to interpret the PostScript code. This interpreter would be integrated using an <code>ImageConverter</code> implementation (see SPI section below). If the requested form of the image cannot be provided you will get an <code>ImageException</code> on which you'll have to react as needed.</p>
+<p>In <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> , each renderer supports a different set of image flavors that can be embedded in the target format. For example: The PDF renderer can deal with Java2D image, bitmaps, XML, native JPEG and CCITT images. The PCL renderer, however, can only consume bitmap images. So, if you can accept more than one flavor, the package allows you to specify all of them in an ordered list (the first in the list is the preferred format). The package will then try to return the best representation possible. Here's a code example:</p>
+<p>import org.apache.xmlgraphics.image.loader.Image;
+import org.apache.xmlgraphics.image.loader.ImageFlavor;</p>
+<p>[..]
+ final ImageFlavor[] flavors = new ImageFlavor[]
+ {ImageFlavor.GRAPHICS2D,
+ ImageFlavor.BUFFERED_IMAGE,
+ ImageFlavor.RENDERED_IMAGE};</p>
+<p>Image img = manager.getImage(
+ info, flavors, sessionContext);</p>
+<p>if (img instanceof ImageGraphics2D) {
+ //handle Java2D/Graphics2D image
+ } else if (img instanceof ImageRendered) {
+ //handle BufferedImage and RenderedImage
+ //(BufferedImage is a subclass of RenderedImage)
+ } else {
+ throw new IllegalStateException("Unexpected flavor");
+ }
+ While each <code>BufferedImage</code> is also a <code>RenderedImage</code> , it can be more efficient to also specify <code>ImageFlavor.BUFFERED_IMAGE</code> in the flavor array.</p>
+<h1 id="tipsntricks">Tips & Tricks</h1>
+<p>If you are loading bitmap images and you get an error like <code>"Cannot load image (no suitable loader/converter combination available) for
+ myimage.tif (image/tiff)</code> , you maybe be missing the necessary ImageIO codec to decode the image. A number of well-written codecs can be found in <a href="https://jai-imageio.dev.java.net/">JAI Image I/O Tools Project</a> . Just download the distribution and add the JAR to the classpath. ImageIO will automatically pick up the new codecs and they will subsequently be available to the image framework.</p>
+<h1 id="spi">Service Provider Interface (SPI, Plug-ins)</h1>
+<p>The whole image framework is designed to be highly extensible. There are various extension points where new functionality can be added. The three main SPI interfaces are:</p>
+<ul>
+<li>
+<p><code>ImagePreloader</code> : detects the content type and preloads an image</p>
+</li>
+<li>
+<p><code>ImageLoader</code> and <code>ImageLoaderFactory</code> : loads images</p>
+</li>
+<li>
+<p><code>ImageConverter</code> : converts images from one representation into another</p>
+</li>
+</ul>
+<p>If you plan to write an implementation of one of the above interfaces, please also take a look at the existing implementations for reference.</p>
+<p>Throughout the SPI, you'll find a <code>Map</code> parameter (hints) in the most important methods. That's a way to supply additional information to the implementation by the caller. For example, the source and target resolutions from the image (session) context is stored in the hints. The implementation should not rely on the presence of specialized information and should always have sensible defaults to rely on in this case.</p>
+<h2 id="ImagePreloader">ImagePreloader</h2>
+<p>The first task is identifying whether the implementation supports the given image. If the image is loaded using an ImageInputStream it is important to always reset the stream position to the beginning of the file at the end of the <code>preloadImage()</code> method, because all registered preloaders are check in turn until one implementation signals that it supports the format. In that case, it has to extract only the minimal information from the image necessary to identify the image's intrinsic size. For most formats, this is doable without loading the whole image into memory.</p>
+<p>However, for some formats (like MathML or WMF), loading the whole image at preloading time is hard to avoid since the image's size can only be determined that way. In such a case, the <code>ImagePreloader</code> implementations shall pass the loaded document to the respective <code>ImageLoader</code> through the custom objects that can be attached to the <code>ImageInfo</code> object. If the preloader loads the whole document, it shall close the given <code>Source</code> object (calling <code>ImageUtil.closeQuietly(Source)</code> ).</p>
+<p>The priority the implementation reports is used to sort all registered implementations. This is to fine-tune the inner workings and to optimize performance since some formats are usually used more frequently than others.
+Normally, if you implement an <code>ImagePreloader</code> you will also need to implement the respective <code>ImageLoader/ImageLoaderFactory</code> , or vice versa.</p>
+<h2 id="ImageLoader">ImageLoader and ImageLoaderFactory</h2>
+<p>The factory interface has been created to allow checking if some library that an implementation depends on is really in the classpath so it can report back that the <code>ImageLoader</code> is not funtional. The factory also reports what kind of image formats it supports and which image flavors it can return. There can be a complex relationship between the two. It is recommmended, however, to write smaller implementations rather than big, almighty ones.</p>
+<p>The usage penalty is used when constructing image conversion pipelines. There can be multiple ways to provide an image in one of the supported flavors and this value helps to make the best decision.</p>
+<p>While the factory basically just provides information and creates new <code>ImageLoader</code> instances, the image loaders are doing the actual leg work of decoding the images. The image flavor returned by the loader must match the flavor that is returned by <code>getTargetFlavor()</code> .</p>
+<h2 id="ImageConverter">ImageConverter</h2>
+<p>The image converter is responsible to transform one image representation into another. Bundled implementations support these conversions: Java2D to bitmap, bitmap to Java2D and RenderedImage to "raw" PNG. Ideas for additional image converters could be: PDF to Java2D, EPS to Java2D or MathML to SVG or Java2D.</p>
+<p>Each ImageConverter comes with a usage penalty which is used when constructing conversion pipelines so the pipeline with the least penalty value can be chosen. This is necessary as the consuming application my support multiple image flavors and there can be multiple ways to convert an image in one of the requested image flavors. Internally, <a href="http://en.wikipedia.org/wiki/Dijkstra%27s_algorithm">Dijkstra's shortest path algorithm</a> is used to find the best path using the penalties as "way lengths".</p>
+<h1 id="customization">Customization</h1>
+<h2 id="source-reuse">Disabling Source Re-use</h2>
+<p>By default, the Source object being used during the pre-loading stage is re-used when the image is fully loaded later (assuming an ImageSessionContext is used that descends from AbstractImageSessionContext). That means that a stream is only opened once and the image loading framework tries to re-wind the stream when it has to re-read portions of the stream when loading the complete image.</p>
+<p>In some situations, this behavior may be undesired. Therefore, it can be disabled through a system property ( <code>org.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext.no-source-reuse</code> ). Set it to "true" and that feature will be disabled.</p>
+<h2 id="plugin-penalties">Adjusting plug-in penalties</h2>
+<p>Every image loader plug-in has a hard-coded usage penalty that influences which solution is chosen if there are multiple possibilities to load an image. Sometimes, though, these penalties need to be tweaked. The <code>ImageImplRegistry</code> (reachable through <code>ImageManager.getRegistry()</code> ) supports storing additional penalty values. An example:
+ImageImplRegistry registry = imageManager.getRegistry();
+registry.setAdditionalPenalty(
+ "org.apache.xmlgraphics.image.loader.impl.ImageLoaderRawCCITTFax",
+ Penalty.toPenalty(10000));
+This increases the penalty for the raw CCITT loader significantly so it will only be used if no other solutions exist. You can also set <code>Penalty.INFINITE_PENALTY</code> to disable the plug-in altogether. Negative penalties are possible to promote a plug-in but a negative penalty sum will be treated as zero penalty in most cases.</p></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/xmlgraphics/trunk/content/commons/index.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/index.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/index.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,167 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Apache⢠XML Graphics Commons</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>Apache⢠XML Graphics Commons</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><h1 id="Overview">Overview</h1>
+<p>Apache⢠XML Graphics Commons is a library that consists of several reusable components used by <a href="http://xmlgraphics.apache.org/batik/">Apache Batik</a> and <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> . Many of these components can easily be used separately outside the domains of SVG and XSL-FO. You will find components such as a PDF library, an RTF library, Graphics2D implementations that let you generate PDF & PostScript files, and much more.</p>
+<p>The Apache⢠XML Graphics Commons project is part of the <a href="http://www.apache.org">Apacheâ¢</a> Software Foundation, which is a wider community of users and developers of open source projects.</p>
+<p>In the Wiki, we have a <a href="http://wiki.apache.org/xmlgraphics/XmlGraphicsCommonComponents">Roadmap for Apache XML Graphics Commons</a> . This roadmap is the place to describe new ideas for the project.</p>
+<h1 id="features">Features</h1>
+<p>Components which have been ported from <a href="http://xmlgraphics.apache.org/batik/">Apache Batik</a> and <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> include:</p>
+<table>
+<thead>
+<tr>
+<th>Description</th>
+<th>Package</th>
+<th>Provenance</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Image codecs for PNG and TIFF</td>
+<td>org.apache.xmlgraphics.image.codec</td>
+<td>Batik</td>
+</tr>
+<tr>
+<td>Bitmap image writer abstraction with implementation for the above codecs and for the Image I/O API.</td>
+<td>org.apache.xmlgraphics.image.writer</td>
+<td>Batik</td>
+</tr>
+<tr>
+<td>Java2D helper classes</td>
+<td>org.apache.xmlgraphics.image.rendered and org.apache.xmlgraphics.java2d</td>
+<td>Batik</td>
+</tr>
+<tr>
+<td>Image loader framework (format detection, conversion and unified handling for bitmap and vector images).</td>
+<td>org.apache.xmlgraphics.image.loader</td>
+<td>new</td>
+</tr>
+<tr>
+<td>Graphics2D implementation that produces PostScript and EPS</td>
+<td>org.apache.xmlgraphics.java2d.ps</td>
+<td>FOP</td>
+</tr>
+<tr>
+<td>Helper classes for PostScript code production</td>
+<td>org.apache.xmlgraphics.ps</td>
+<td>FOP</td>
+</tr>
+<tr>
+<td>Parser/Processor for DSC-compliant PostScript files (DSC = <a href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">Document Structuring Conventions</a> )</td>
+<td>org.apache.xmlgraphics.ps.dsc</td>
+<td>new</td>
+</tr>
+<tr>
+<td><a href="http://www.adobe.com/products/xmp/index.html">XMP metadata</a> framework</td>
+<td>org.apache.xmlgraphics.xmp</td>
+<td>new</td>
+</tr>
+<tr>
+<td>Various I/O classes, encoders and decoders for various formats</td>
+<td>org.apache.xmlgraphics.util.io</td>
+<td>Batik/FOP</td>
+</tr>
+</tbody>
+</table>
+<h1 id="News">News</h1>
+<p>RSS Feed: <a href="subproject-news-feed.rss"></a> </p>
+<h2 id="news-2010-07-07">7 Jul 2010: Version 1.4 Released</h2>
+<p><item date="2010-07-07" title="Version 1.4 Released">
+This release adds the option to generate smaller PostScript files, support for the AdobeStandardCyrillic encoding, RefinedImageFlavor, TexturePaint support for PSGraphics2D (PostScript tiling patterns), improvements to the XMP framework, optimization for PostScript state handling in (E)PSDocumentGraphics2D, and more. In addition it contains a number of bug fixes. For details, please see the <a href="changes.html#version_1.4">Changes</a> page.</p>
+<p>We are pleased to note that many new features were contributed from outside the team of committers. Such broader interest ensures the healthy further development of the project.
+</item></p>
+<h2 id="news-2008-06-11">11 Jun 2008: Version 1.3.1 Released</h2>
+<p><item date="2008-06-11" title="Version 1.3.1 Released">
+This release is mostly a bugfix release for the image loading framework that has been introduced in version 1.3. For details, please see the <a href="changes.html#version_1.3.1">Changes</a> page.
+</item></p>
+<h2 id="news-2008-03-07">7 Mar 2008: Version 1.3 Released</h2>
+<p><item date="2008-03-07" title="Version 1.3 Released">
+The most important addition in this release is an image loading framework which supports all sorts of different image formats (bitmap and vector) and is highly extensible.</p>
+<p>Besides that there were a larger number of smaller additions and bugfixes.</p>
+<p>Support for Java 1.3 has been dropped. Java 1.4 or later is required now.
+</item></p>
+<h2 id="news-2007-07-21">21 Jul 2007: Version 1.2 Released</h2>
+<p><item date="2007-07-21" title="Version 1.2 Released">
+This release mainly adds support for CMYK and GRAY color spaces for PSGenerator. For details about other fixes, please see the <a href="changes.html#version_1.2">Changes</a> page.
+</item></p>
+<h2 id="news-2006-12-22">22 Dec 2006: Version 1.1 Released</h2>
+<p><item date="2006-12-22" title="Version 1.1 Released">
+This release adds an XMP metadata framework and brings improvements for the ImageWriter package plus some minor fixes mainly in the PostScript area.
+</item></p>
+<h2 id="news-2006-04-17">17 Apr 2006: Version 1.0 Released</h2>
+<p><item date="2006-04-17" title="Version 1.0 Released">
+This is the first release of Apache XML Graphics Commons. There are currently no known issues with the code.
+</item></p></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/xmlgraphics/trunk/content/commons/postscript.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/postscript.html (added)
+++ websites/staging/xmlgraphics/trunk/content/commons/postscript.html Sun Apr 15 05:51:31 2012
@@ -0,0 +1,131 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Tools for Adobe PostScript</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+-->
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css">
+
+ </style>
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <h1 id="xml-graphics">XML Graphics</h1>
+<ul>
+<li><a href="/">Overview</a></li>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+</ul>
+<h1 id="subprojects">Subprojects</h1>
+<ul>
+<li><a href="/batik/">Batik</a></li>
+<li><a href="/fop/">FOP</a></li>
+<li><a href="/commons/">Commons</a></li>
+</ul>
+<form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query" /><br />
+ <input type="submit" id="submit" value="Search" />
+</form>
+ </div>
+
+ <div id="bannertext">
+ <a href="/"><img src="/images/apache-xml-graphics.gif" alt="The Apache XML Graphics Project" width="220" heigh="51" /></a>
+ <h1>Tools for Adobe PostScript</h1>
+ </div>
+ <p><a href="/">Home</a> » <a href="/commons/">Commons</a></p>
+ </div>
+ <div id="content" class="grid_16"><div class="section-content"><h1 id="overview">Overview</h1>
+<p>Apache⢠XML Graphics Commons contains various tools for writing and processing Adobe PostScript files. This includes:</p>
+<ul>
+<li>
+<p>A PostScript generator class which helps writing PostScript files from scratch.</p>
+</li>
+<li>
+<p>Two Graphics2D implementations, one for plain PostScript and one for writing Encapsulated PostScript (EPS).</p>
+</li>
+<li>
+<p>A DSC-parser/processor: Parse, post-process and change DSC-compliant PostScript files.
+We don't currently include a PostScript interpreter though we would love to have one. A Java-based PostScript interpreter to keep an eye on is the one from the <a href="http://foray.sourceforge.net">FOray project</a> .</p>
+</li>
+</ul>
+<h1 id="generator">The PostScript generator</h1>
+<p>The "PSGenerator" class can help writing PostScript files. It deals with things like escaping, saving/tracking/restoring graphics state, writing DSC comments and tracking of DSC resources.</p>
+<p>You will rarely interact with the PS generator itself, as it is probably more interesting to generate a PostScript file using Java2D which is described in the following section.</p>
+<h1 id="java2d">Java2D: Graphics2D implementation for generating PostScript and EPS</h1>
+<p>We provide two classes (PSDocumentGraphics2D and EPSDocumentGraphics2D) which you can use to generated complete PostScript files using normal Java2D means. The difference between the two classes is that the EPS variant creates a fully compliant Encapsulated PostScript file while the PS variant simply creates a normal DSC-compliant level 2 PostScript file. It depends on your requirement which variant you choose. The PS variant is mostly for printing purposes while the EPS variant is better suited for inclusion in other documents.</p>
+<h2 id="creating-eps">Creating an EPS file</h2>
+<p>Creating an EPS file using the Graphics2D implementation is easy. Instantiate EPSDocumentGraphics2D, set a GraphicContext and set up the output document. Here's an example:</p>
+<p>import org.apache.xmlgraphics.java2d.ps.EPSDocumentGraphics2D;</p>
+<p>[..]</p>
+<p>EPSDocumentGraphics2D g2d = new EPSDocumentGraphics2D(false);
+g2d.setGraphicContext(new org.apache.xmlgraphics.java2d.GraphicContext());</p>
+<p>//Set up the document size
+g2d.setupDocument(out, 400, 200); //400pt x 200pt
+//out is the OutputStream to write the EPS to</p>
+<p>g2d.drawRect(10, 10, 50, 50); //paint a rectangle using normal Java2D calls</p>
+<p>g2d.finish(); //Wrap up and finalize the EPS file</p>
+<p>A complete example for generating an EPS files can be found in the <a href="http://svn.apache.org/viewvc/xmlgraphics/commons/trunk/examples/java/java2d/ps/">"examples" directory</a> in the distribution.</p>
+<h1 id="dsc">DSC parser/processor</h1>
+<p>Many PostScript files use special comments to structure a document. This allows manipulation of PostScript files without interpreting them. These special comments are defined in the <a href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">Document Structuring Conventions</a> . The code in Commons is designed to work with DSC 3.0. For details on how DSC is used, please take a look at the DSC specification.</p>
+<p>The DSC support in Commons was primarily developed to implement resource optimization features in <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> 's PostScript output support. Resources like images which are used repeatedly in a document should not be written to the PostScript file each time it is used. Instead it is written once at the beginning of the file as a PostScript form. The form is then called whenever the image needs painting.</p>
+<p>But the DSC parser could potentially be used for other purposes. The most obvious is extracting a subset of pages from a DSC-compliant file. Assume you want to print only page 45 to 57 of a particular document. There's an example that demonstrates exactly this. Check out the "examples" directory in the distribution. Other potential use cases for the DSC parser are:</p>
+<ul>
+<li>
+<p>Patching PostScript files, for example, adding OMR marks for automatic packaging</p>
+</li>
+<li>
+<p><a href="http://en.wikipedia.org/wiki/Imposition">Imposition</a> (2-up, n-up, rotation, etc.)</p>
+</li>
+<li>
+<p>EPS graphic extraction</p>
+</li>
+<li>
+<p>Inspecting the page count</p>
+</li>
+<li>
+<p>etc. etc.</p>
+</li>
+</ul>
+<p>The DSC parser (DSCParser) was designed as a pull parser, i.e. you fetch new events from the parser inspecting them and acting on them as they are found. If you prefer to work with a push parser, you can pass the DSCParser a DSCHandler implementation and the parser will send you all the events.</p>
+<p>The best example to understand how to use the DSC parser is the PageExtractor class that implements the page extraction functionality mentioned above.
+The DSC parser is not considered feature-complete. The basic infrastructure is there but, for example, not all DSC comments are available as concrete Java classes. If you need to extend the DSC parser for your own use cases, please send us your patches.</p></div></div>
+ <div class="clear"></div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif"/ width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache, Apache XML Graphics, the Apache feather logo, and the Apache XML Graphics logos are
+ trademarks of <a href="http://www.apache.org">The Apache Software Foundation</a>. All other
+ marks mentioned may be trademarks or registered trademarks of their respective owners.
+ <br />
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org