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/10/23 06:23:34 UTC
svn commit: r835841 [9/10] - in /websites/staging/xmlgraphics/trunk/content:
./ batik/ fop/ fop/1.1/ fop/1.1/images/ fop/trunk/
Added: websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfa.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfa.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfa.html Tue Oct 23 04:23:32 2012
@@ -0,0 +1,418 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>Apache&trade; FOP: PDF/A (ISO 19005)</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/profile.css" rel="stylesheet" type="text/css" />
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css" />
+
+ <script src="http://code.jquery.com/jquery.min.js"></script>
+ <script>
+ $(document).ready(function(){
+ $('ul#navigation a').each(function() {
+ if (this.href === window.location.href)
+ { $(this). attr('id', 'forefront');}
+ });
+ $('ul#navigation a#forefront').each(function() {
+
+ });
+ })
+ </script>
+
+
+
+
+
+ <style>
+ .highlight {color: red;}
+ </style>
+
+ </head>
+
+ <body>
+
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <p><a href="/"><img alt="Apache XML Graphics Project Logo" src="/images/apache-xml-graphics.gif" title="Apache XML Graphics Project" /></a></p>
+<h1 id="apache-fop">Apache FOP</h1>
+<ul>
+<li><a href="/fop/">FOP Home</a></li>
+<li><a href="/fop/download.html">Download</a></li>
+<li><a href="/fop/quickstartguide.html">Quick Start Guide</a></li>
+<li><a href="/fop/compliance.html">Compliance</a></li>
+<li><a href="/fop/gethelp.html">Getting Help</a></li>
+<li><a href="/fop/faq.html">FAQs</a></li>
+<li><a href="/fop/maillist.html">Mailing Lists</a></li>
+<li><a href="/fop/license.html">License</a></li>
+<li>
+<h2 id="resources">Resources</h2>
+<ul>
+<li><a href="/fop/fo.html">XSL-FO</a></li>
+<li><a href="/fop/examples.html">Examples</a></li>
+<li><a href="/fop/bugs.html">Bugs</a></li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project</h2>
+<ul>
+<li><a href="/fop/news.html">News</a></li>
+<li><a href="/fop/team.html">Who We Are</a></li>
+<li><a href="/fop/status.html">Status</a></li>
+<li><a href="/fop/knownissues.html">Known Issues</a></li>
+<li><a href="/fop/changes.html">Changes</a></li>
+</ul>
+</li>
+<li>
+<h2 id="branches">Branches</h2>
+<ul>
+<li>
+<h2 id="apachewzxhzdk6-fop-trunk-dev">Apache™ FOP Trunk (dev)</h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apachewzxhzdk7-fop">Using Apache™ FOP</h3>
+<ul>
+<li><a href="/fop/trunk/compiling.html">Build</a></li>
+<li><a href="/fop/trunk/configuration.html">Configure</a></li>
+<li><a href="/fop/trunk/running.html">Run</a></li>
+<li><a href="/fop/trunk/embedding.html">Embed</a></li>
+<li><a href="/fop/trunk/servlets.html">Servlets</a></li>
+<li><a href="/fop/trunk/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features">Features</h3>
+<ul>
+<li><a href="/fop/trunk/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/trunk/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/trunk/events.html">Events</a></li>
+<li><a href="/fop/trunk/extensions.html">Extensions</a></li>
+<li><a href="/fop/trunk/fonts.html">Fonts</a></li>
+<li><a href="/fop/trunk/graphics.html">Graphics</a></li>
+<li><a href="/fop/trunk/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/trunk/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/trunk/metadata.html">Metadata</a></li>
+<li><a href="/fop/trunk/output.html">Output Targets</a></li>
+<li><a href="/fop/trunk/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/trunk/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/trunk/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk5-fop-10">Apache™ FOP 1.0</h2>
+<ul>
+<li><a href="/fop/1.0/">FOP 1.0 Overview</a></li>
+<li><a href="/fop/1.0/releaseNotes_1.0.html">Release Notes</a></li>
+<li><a href="/fop/1.0/changes_1.0.html">Changes (1.0)</a></li>
+<li><a href="/fop/1.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-10">Using Apache FOP 1.0</h3>
+<ul>
+<li><a href="/fop/1.0/compiling.html">Build</a></li>
+<li><a href="/fop/1.0/configuration.html">Configure</a></li>
+<li><a href="/fop/1.0/running.html">Run</a></li>
+<li><a href="/fop/1.0/embedding.html">Embed</a></li>
+<li><a href="/fop/1.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features</h3>
+<ul>
+<li><a href="/fop/1.0/output.html">Output Targets</a></li>
+<li><a href="/fop/1.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/1.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.0/events.html">Events</a></li>
+<li><a href="/fop/1.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.0/accessibility.html">Accessibility</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk4-fop-095">Apache™ FOP 0.95</h2>
+<ul>
+<li><a href="/fop/0.95/">FOP 0.95 Overview</a></li>
+<li><a href="/fop/0.95/releaseNotes_0.95.html">Release Notes</a></li>
+<li><a href="/fop/0.95/changes_0.95.html">Changes (0.95)</a></li>
+<li><a href="/fop/0.95/changes_0.95beta.html">Changes (0.95beta)</a></li>
+<li><a href="/fop/0.95/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/0.95/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-095">Using Apache FOP 0.95</h3>
+<ul>
+<li><a href="/fop/0.95/compiling.html">Build</a></li>
+<li><a href="/fop/0.95/configuration.html">Configure</a></li>
+<li><a href="/fop/0.95/running.html">Run</a></li>
+<li><a href="/fop/0.95/embedding.html">Embed</a></li>
+<li><a href="/fop/0.95/servlets.html">Servlets</a></li>
+<li><a href="/fop/0.95/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features</h3>
+<ul>
+<li><a href="/fop/0.95/output.html">Output Targets</a></li>
+<li><a href="/fop/0.95/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/0.95/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/0.95/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/0.95/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/0.95/graphics.html">Graphics</a></li>
+<li><a href="/fop/0.95/fonts.html">Fonts</a></li>
+<li><a href="/fop/0.95/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/0.95/extensions.html">Extensions</a></li>
+<li><a href="/fop/0.95/metadata.html">Metadata</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h1 id="apachewzxhzdk3-fop-development">Apache™ FOP Development</h1>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design</h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process</h2>
+<ul>
+<li><a href="/fop/dev/design/startup.html">Startup</a></li>
+<li><a href="/fop/dev/design/parsing.html">XML Parsing</a></li>
+<li><a href="/fop/dev/design/fotree.html">FO Tree</a></li>
+<li><a href="/fop/dev/design/properties.html">Properties</a></li>
+<li><a href="/fop/dev/design/layout.html">Layout</a></li>
+<li><a href="/fop/dev/design/breakpos.html">Break Possibility</a></li>
+<li><a href="/fop/dev/design/areas.html">Area Tree</a></li>
+<li><a href="/fop/dev/design/renderers.html">Renderers</a></li>
+</ul>
+</li>
+<li>
+<h2 id="miscellaneous">Miscellaneous</h2>
+<ul>
+<li><a href="/fop/dev/design/images.html">Images</a></li>
+<li><a href="/fop/dev/design/pdf-library.html">PDF Library</a></li>
+<li><a href="/fop/dev/design/svg.html">SVG</a></li>
+<li><a href="/fop/dev/design/embedding.html">Embedding</a></li>
+<li><a href="/fop/dev/design/extending.html">Extending</a></li>
+<li><a href="/fop/dev/design/optimise.html">Optimisations</a></li>
+<li><a href="/fop/dev/design/useragent.html">User Agent</a></li>
+</ul>
+</li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FOPProjectPages">Unresolved (Wiki)</a></li>
+<li><a href="/fop/dev/svg.html">SVG</a></li>
+<li><a href="/fop/dev/extensions.html">Extensions</a></li>
+<li>
+<h2 id="develop">Develop</h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;namedcmd=Fop+all&amp;newqueryname=fop+patch+queue&amp;tofooter=1&amp;order=Reuse+same+sort+as+last+time">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test</h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy</h2>
+<ul>
+<li><a href="/fop/dev/doc.html">Doc Mgmt</a></li>
+<li><a href="/fop/dev/release.html">Release</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bug_severity%2Cpriority%20DESC">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources</h2>
+<ul>
+<li><a href="/fop/dev/faq.html">FAQs</a></li>
+<li><a href="/fop/dev/tools.html">Tools</a></li>
+<li><a href="http://svn.apache.org/viewvc/xmlgraphics/fop">ViewVC</a></li>
+</ul>
+</li>
+<li>
+<h2 id="subpackages">SubPackages</h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apachewzxhzdk2-xml-graphics">Apache™ XML Graphics</h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview</h2>
+<ul>
+<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>
+<li><a href="http://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects</h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h2 id="search-apache-xml-graphics">Search Apache XML Graphics</h2>
+<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" />
+ <input type="submit" id="submit" value="Search" />
+</form>
+
+<script>
+$(document).ready(function () {
+Â Â Â Â $('#navigation :header').click(function () {
+Â Â Â Â Â Â Â Â var text = $(this).siblings('ul');
+Â Â Â Â Â Â Â Â if (text.is(':hidden')) {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideDown('200');
+Â Â Â Â Â Â Â Â } else {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideUp('200');
+Â Â Â Â Â Â Â Â }
+Â Â Â Â });
+Â Â Â Â if ($('#navigation :header').siblings('ul')) {
+ $('#navigation :header').append(' »');
+Â Â Â Â }
+ $('#navigation > ul > li ul').hide();
+ var str=location.href.toLowerCase();
+ $("#navigation li a").each(function() {
+ if (str.indexOf(this.href.toLowerCase()) > -1) {
+ $(this).parents().slideDown('200');
+ $("li.highlight").removeClass("highlight");
+ $(this).parent().addClass("highlight");
+ }
+ });
+})
+</script>
+ </div>
+
+ <div id="bannertext" style="border-bottom: 2px dashed #666666; height: 70px;">
+ <a href="/fop/"><img src="/images/apache-fop-logo.jpg" alt="The Apache FOP Project" width="120" height="65" style="float:left; margin-right: 15px;" /></a>
+ <h2>The Apache™ FOP Project</h2>
+ </div><!-- <h1>Apache&trade; FOP: PDF/A (ISO 19005)</h1> -->
+
+
+
+ <div id="content" class="grid_16">
+ <!-- <div id="breadcrumb"><a href="/">Home</a> » <a href="/fop/">Fop</a> » <a href="/fop/1.1/">1.1</a></div> -->
+ <div class="section-content"><p><version>$Revision: 1298724 $</version><authors><person email="jeremias@apache.org" name="Jeremias Märki"></person></authors></p>
+<h1 id="overview">Overview</h1>
+<p>PDF/A is a standard which turns PDF into an "electronic document file format for long-term preservation". PDF/A-1 is the first part of the standard and is documented in <a href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=38920&ICS1=37&ICS2=100&ICS3=99">ISO 19005-1:2005(E)</a> . Work on PDF/A-2 is in progress at <a href="http://www.aiim.org/standards.asp?ID=25013">AIIM</a> .</p>
+<p>Design documentation on PDF/A can be found on FOP's Wiki on the <a href="http://wiki.apache.org/xmlgraphics-fop/PDFA1ConformanceNotes">PDFA1ConformanceNotes</a> page.</p>
+<h1 id="status">Implementation Status</h1>
+<p><strong>PDF/A-1b</strong> is implemented to the degree that FOP supports the creation of the elements described in ISO 19005-1.</p>
+<p>Tests have been performed against jHove and Adobe Acrobat 7.0.7 (Preflight function). FOP does not validate completely against Apago's PDF Appraiser. Reasons unknown due to lack of a full license to get a detailed error protocol.</p>
+<p><strong>PDF/A-1a</strong> is based on PDF-A-1b and adds accessibility features (such as Tagged PDF). This format is available within the limitation described on the <a href="accessibility.html">Accessibility page</a> .</p>
+<h1 id="command-line">Usage (command line)</h1>
+<p>To activate PDF/A-1b from the command-line, specify "-pdfprofile PDF/A-1b" as a parameter. If there is a violation of one of the validation rules for PDF/A, an error message is presented and the processing stops.</p>
+<p>PDF/A-1a is enabled by specifying "-pdfprofile PDF/A-1a".</p>
+<h1 id="embedded">Usage (embedded)</h1>
+<p>When FOP is embedded in another Java application you can set a special option on the renderer options in the user agent to activate the PDF/A-1b profile. Here's an example:</p>
+<p class=".">userAgent.getRendererOptions().put("pdf-a-mode", "PDF/A-1b");
+Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
+</p>
+<p>For PDF/A-1a, just use the string "PDF/A-1a" instead of "PDF/A-1b".</p>
+<h1 id="rules">PDF/A in Action</h1>
+<p>There are a number of things that must be looked after if you activate a PDF/A profile. If you receive a PDFConformanceException, have a look at the following list (not necessarily comprehensive):</p>
+<ul>
+<li>
+<p>Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) you need to obtain a license for them and embed them like any other font.</p>
+</li>
+<li>
+<p>Don't use PDF encryption. PDF/A doesn't allow it.</p>
+</li>
+<li>
+<p>Don't use CMYK images without an ICC color profile. PDF/A doesn't allow mixing color spaces and FOP currently only properly supports the sRGB color space. Please note that FOP embeds a standard sRGB ICC profile (sRGB IEC61966-2.1) as the primary output intent for the PDF if no other output intent has been specified in the configuration.</p>
+</li>
+<li>
+<p>Don't use non-RGB colors in SVG images. Same issue as with CMYK images.</p>
+</li>
+<li>
+<p>Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF is deprecated since PDF 1.4 and prohibited by PDF/A.</p>
+</li>
+<li>
+<p>PDF is forced to version 1.4 if PDF/A-1 is activated.</p>
+</li>
+<li>
+<p>No filter must be specified explicitely for metadata objects. Metadata must be embedded in clear text so non-PDF-aware applications can extract the XMP metadata.
+There are additional requirements if you want to enabled PDF/A-1a (Tagged PDF). This is particularly the specification of the natural language and alternative descriptions for images. Please refer to the <a href="accessibility.html">Accessibility page</a> for details.</p>
+</li>
+</ul>
+<h1 id="profile-compatibility">PDF profile compatibility</h1>
+<p>The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" (or "PDF/A-1a") are compatible and can both be activated at the same time.</p>
+<h1 id="interoperability">Interoperability</h1>
+<p>There has been some confusion about the namespace for the PDF/A indicator in the XMP metadata. At least three variants have been seen in the wild:</p>
+<table>
+<thead>
+<tr>
+<th>http://www.aiim.org/pdfa/ns/id.html</th>
+<th><strong>obsolete</strong> , from an early draft of ISO-19005-1, used by Adobe Acrobat 7.x</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>http://www.aiim.org/pdfa/ns/id/</td>
+<td><strong>correct</strong> , found in the technical corrigendum 1 of ISO 19005-1:2005</td>
+</tr>
+</tbody>
+</table>
+<p>If you get an error validating a PDF/A file in Adobe Acrobat 7.x it doesn't mean that FOP did something wrong. It's Acrobat that is at fault. This is fixed in Adobe Acrobat 8.x which uses the correct namespace as described in the technical corrigendum 1.</p></div>
+ </div>
+
+ <div class="clear"></div>
+
+ <div id="footer">
+ <div class="copyright">
+ <div style="float:left; padding: 7px;">
+ <a title="Apache Software Foundation" href="http://www.apache.org"><img id="asf-feather-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100" /></a>
+ </div>
+ <p>
+ Copyright © 2012 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, Apache FOP, Apache Batik, 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/fop/1.1/pdfencryption.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfencryption.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfencryption.html Tue Oct 23 04:23:32 2012
@@ -0,0 +1,496 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>Apache&trade; FOP: PDF encryption.</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/profile.css" rel="stylesheet" type="text/css" />
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css" />
+
+ <script src="http://code.jquery.com/jquery.min.js"></script>
+ <script>
+ $(document).ready(function(){
+ $('ul#navigation a').each(function() {
+ if (this.href === window.location.href)
+ { $(this). attr('id', 'forefront');}
+ });
+ $('ul#navigation a#forefront').each(function() {
+
+ });
+ })
+ </script>
+
+
+
+
+
+ <style>
+ .highlight {color: red;}
+ </style>
+
+ </head>
+
+ <body>
+
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <p><a href="/"><img alt="Apache XML Graphics Project Logo" src="/images/apache-xml-graphics.gif" title="Apache XML Graphics Project" /></a></p>
+<h1 id="apache-fop">Apache FOP</h1>
+<ul>
+<li><a href="/fop/">FOP Home</a></li>
+<li><a href="/fop/download.html">Download</a></li>
+<li><a href="/fop/quickstartguide.html">Quick Start Guide</a></li>
+<li><a href="/fop/compliance.html">Compliance</a></li>
+<li><a href="/fop/gethelp.html">Getting Help</a></li>
+<li><a href="/fop/faq.html">FAQs</a></li>
+<li><a href="/fop/maillist.html">Mailing Lists</a></li>
+<li><a href="/fop/license.html">License</a></li>
+<li>
+<h2 id="resources">Resources</h2>
+<ul>
+<li><a href="/fop/fo.html">XSL-FO</a></li>
+<li><a href="/fop/examples.html">Examples</a></li>
+<li><a href="/fop/bugs.html">Bugs</a></li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project</h2>
+<ul>
+<li><a href="/fop/news.html">News</a></li>
+<li><a href="/fop/team.html">Who We Are</a></li>
+<li><a href="/fop/status.html">Status</a></li>
+<li><a href="/fop/knownissues.html">Known Issues</a></li>
+<li><a href="/fop/changes.html">Changes</a></li>
+</ul>
+</li>
+<li>
+<h2 id="branches">Branches</h2>
+<ul>
+<li>
+<h2 id="apachewzxhzdk6-fop-trunk-dev">Apache™ FOP Trunk (dev)</h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apachewzxhzdk7-fop">Using Apache™ FOP</h3>
+<ul>
+<li><a href="/fop/trunk/compiling.html">Build</a></li>
+<li><a href="/fop/trunk/configuration.html">Configure</a></li>
+<li><a href="/fop/trunk/running.html">Run</a></li>
+<li><a href="/fop/trunk/embedding.html">Embed</a></li>
+<li><a href="/fop/trunk/servlets.html">Servlets</a></li>
+<li><a href="/fop/trunk/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features">Features</h3>
+<ul>
+<li><a href="/fop/trunk/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/trunk/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/trunk/events.html">Events</a></li>
+<li><a href="/fop/trunk/extensions.html">Extensions</a></li>
+<li><a href="/fop/trunk/fonts.html">Fonts</a></li>
+<li><a href="/fop/trunk/graphics.html">Graphics</a></li>
+<li><a href="/fop/trunk/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/trunk/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/trunk/metadata.html">Metadata</a></li>
+<li><a href="/fop/trunk/output.html">Output Targets</a></li>
+<li><a href="/fop/trunk/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/trunk/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/trunk/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk5-fop-10">Apache™ FOP 1.0</h2>
+<ul>
+<li><a href="/fop/1.0/">FOP 1.0 Overview</a></li>
+<li><a href="/fop/1.0/releaseNotes_1.0.html">Release Notes</a></li>
+<li><a href="/fop/1.0/changes_1.0.html">Changes (1.0)</a></li>
+<li><a href="/fop/1.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-10">Using Apache FOP 1.0</h3>
+<ul>
+<li><a href="/fop/1.0/compiling.html">Build</a></li>
+<li><a href="/fop/1.0/configuration.html">Configure</a></li>
+<li><a href="/fop/1.0/running.html">Run</a></li>
+<li><a href="/fop/1.0/embedding.html">Embed</a></li>
+<li><a href="/fop/1.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features</h3>
+<ul>
+<li><a href="/fop/1.0/output.html">Output Targets</a></li>
+<li><a href="/fop/1.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/1.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.0/events.html">Events</a></li>
+<li><a href="/fop/1.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.0/accessibility.html">Accessibility</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk4-fop-095">Apache™ FOP 0.95</h2>
+<ul>
+<li><a href="/fop/0.95/">FOP 0.95 Overview</a></li>
+<li><a href="/fop/0.95/releaseNotes_0.95.html">Release Notes</a></li>
+<li><a href="/fop/0.95/changes_0.95.html">Changes (0.95)</a></li>
+<li><a href="/fop/0.95/changes_0.95beta.html">Changes (0.95beta)</a></li>
+<li><a href="/fop/0.95/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/0.95/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-095">Using Apache FOP 0.95</h3>
+<ul>
+<li><a href="/fop/0.95/compiling.html">Build</a></li>
+<li><a href="/fop/0.95/configuration.html">Configure</a></li>
+<li><a href="/fop/0.95/running.html">Run</a></li>
+<li><a href="/fop/0.95/embedding.html">Embed</a></li>
+<li><a href="/fop/0.95/servlets.html">Servlets</a></li>
+<li><a href="/fop/0.95/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features</h3>
+<ul>
+<li><a href="/fop/0.95/output.html">Output Targets</a></li>
+<li><a href="/fop/0.95/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/0.95/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/0.95/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/0.95/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/0.95/graphics.html">Graphics</a></li>
+<li><a href="/fop/0.95/fonts.html">Fonts</a></li>
+<li><a href="/fop/0.95/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/0.95/extensions.html">Extensions</a></li>
+<li><a href="/fop/0.95/metadata.html">Metadata</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h1 id="apachewzxhzdk3-fop-development">Apache™ FOP Development</h1>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design</h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process</h2>
+<ul>
+<li><a href="/fop/dev/design/startup.html">Startup</a></li>
+<li><a href="/fop/dev/design/parsing.html">XML Parsing</a></li>
+<li><a href="/fop/dev/design/fotree.html">FO Tree</a></li>
+<li><a href="/fop/dev/design/properties.html">Properties</a></li>
+<li><a href="/fop/dev/design/layout.html">Layout</a></li>
+<li><a href="/fop/dev/design/breakpos.html">Break Possibility</a></li>
+<li><a href="/fop/dev/design/areas.html">Area Tree</a></li>
+<li><a href="/fop/dev/design/renderers.html">Renderers</a></li>
+</ul>
+</li>
+<li>
+<h2 id="miscellaneous">Miscellaneous</h2>
+<ul>
+<li><a href="/fop/dev/design/images.html">Images</a></li>
+<li><a href="/fop/dev/design/pdf-library.html">PDF Library</a></li>
+<li><a href="/fop/dev/design/svg.html">SVG</a></li>
+<li><a href="/fop/dev/design/embedding.html">Embedding</a></li>
+<li><a href="/fop/dev/design/extending.html">Extending</a></li>
+<li><a href="/fop/dev/design/optimise.html">Optimisations</a></li>
+<li><a href="/fop/dev/design/useragent.html">User Agent</a></li>
+</ul>
+</li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FOPProjectPages">Unresolved (Wiki)</a></li>
+<li><a href="/fop/dev/svg.html">SVG</a></li>
+<li><a href="/fop/dev/extensions.html">Extensions</a></li>
+<li>
+<h2 id="develop">Develop</h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;namedcmd=Fop+all&amp;newqueryname=fop+patch+queue&amp;tofooter=1&amp;order=Reuse+same+sort+as+last+time">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test</h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy</h2>
+<ul>
+<li><a href="/fop/dev/doc.html">Doc Mgmt</a></li>
+<li><a href="/fop/dev/release.html">Release</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bug_severity%2Cpriority%20DESC">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources</h2>
+<ul>
+<li><a href="/fop/dev/faq.html">FAQs</a></li>
+<li><a href="/fop/dev/tools.html">Tools</a></li>
+<li><a href="http://svn.apache.org/viewvc/xmlgraphics/fop">ViewVC</a></li>
+</ul>
+</li>
+<li>
+<h2 id="subpackages">SubPackages</h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apachewzxhzdk2-xml-graphics">Apache™ XML Graphics</h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview</h2>
+<ul>
+<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>
+<li><a href="http://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects</h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h2 id="search-apache-xml-graphics">Search Apache XML Graphics</h2>
+<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" />
+ <input type="submit" id="submit" value="Search" />
+</form>
+
+<script>
+$(document).ready(function () {
+Â Â Â Â $('#navigation :header').click(function () {
+Â Â Â Â Â Â Â Â var text = $(this).siblings('ul');
+Â Â Â Â Â Â Â Â if (text.is(':hidden')) {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideDown('200');
+Â Â Â Â Â Â Â Â } else {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideUp('200');
+Â Â Â Â Â Â Â Â }
+Â Â Â Â });
+Â Â Â Â if ($('#navigation :header').siblings('ul')) {
+ $('#navigation :header').append(' »');
+Â Â Â Â }
+ $('#navigation > ul > li ul').hide();
+ var str=location.href.toLowerCase();
+ $("#navigation li a").each(function() {
+ if (str.indexOf(this.href.toLowerCase()) > -1) {
+ $(this).parents().slideDown('200');
+ $("li.highlight").removeClass("highlight");
+ $(this).parent().addClass("highlight");
+ }
+ });
+})
+</script>
+ </div>
+
+ <div id="bannertext" style="border-bottom: 2px dashed #666666; height: 70px;">
+ <a href="/fop/"><img src="/images/apache-fop-logo.jpg" alt="The Apache FOP Project" width="120" height="65" style="float:left; margin-right: 15px;" /></a>
+ <h2>The Apache™ FOP Project</h2>
+ </div><!-- <h1>Apache&trade; FOP: PDF encryption.</h1> -->
+
+
+
+ <div id="content" class="grid_16">
+ <!-- <div id="breadcrumb"><a href="/">Home</a> » <a href="/fop/">Fop</a> » <a href="/fop/1.1/">1.1</a></div> -->
+ <div class="section-content"><p><version>$Revision: 1298724 $</version><authors><person email="pietsch@apache.org" name="J.Pietschmann"></person><person email="jeremias@apache.org" name="Jeremias Märki"></person></authors></p>
+<h1 id="Overview">Overview</h1>
+<p>Apache™ FOP supports encryption of PDF output, thanks to Patrick C. Lankswert. This feature is commonly used to prevent unauthorized viewing, printing, editing, copying text from the document and doing annotations. It is also possible to ask the user for a password in order to view the contents. Note that there already exist third party applications which can decrypt an encrypted PDF without effort and allow the aforementioned operations, therefore the degree of protection is limited.</p>
+<p>For further information about features and restrictions regarding PDF encryption, look at the documentation coming with Adobe Acrobat or the technical documentation on the Adobe web site.</p>
+<h1 id="usage-command-line-usage28commandline29">Usage (command line) # {#Usage+%28command+line%29}</h1>
+<p>Encryption is enabled by supplying any of the encryption related options.</p>
+<p>An owner password is set with the <code>-o</code> option. This password is actually used as encryption key. Many tools for PDF processing ask for this password to disregard any restriction imposed on the PDF document.</p>
+<p>If no owner password has been supplied but FOP was asked to apply some restrictions, a random password is used. In this case it is obviously impossiible to disregard restrictions in PDF processing tools.</p>
+<p>A user password, supplied with the <code>-u</code> option, will cause the PDF display software to ask the reader for this password in order to view the contents of the document. If no user password was supplied, viewing the content is not restricted.</p>
+<p>Further restrictions can be imposed by using the <code>-noprint</code> , <code>-nocopy</code> , <code>-noedit</code> and <code>-noannotations</code> options, which disable printing, copying text, editing in Adobe Acrobat and making annotations, respectively.</p>
+<h1 id="usage-embedded-usage28embedded29">Usage (embedded) # {#Usage+%28embedded%29}</h1>
+<p>When FOP is embedded in another Java application you need to set an options map on the renderer. These are the supported options:</p>
+<table>
+<thead>
+<tr>
+<th>Option</th>
+<th>Description</th>
+<th>Values</th>
+<th>Default</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>ownerPassword</td>
+<td>The owner password</td>
+<td>String</td>
+<td></td>
+</tr>
+<tr>
+<td>userPassword</td>
+<td>The user password</td>
+<td>String</td>
+<td></td>
+</tr>
+<tr>
+<td>allowPrint</td>
+<td>Allows/disallows printing of the PDF</td>
+<td>"TRUE" or "FALSE"</td>
+<td>"TRUE"</td>
+</tr>
+<tr>
+<td>allowCopyContent</td>
+<td>Allows/disallows copy/paste of content</td>
+<td>"TRUE" or "FALSE"</td>
+<td>"TRUE"</td>
+</tr>
+<tr>
+<td>allowEditContent</td>
+<td>Allows/disallows editing of content</td>
+<td>"TRUE" or "FALSE"</td>
+<td>"TRUE"</td>
+</tr>
+<tr>
+<td>allowEditAnnotations</td>
+<td>Allows/disallows editing of annotations</td>
+<td>"TRUE" or "FALSE"</td>
+<td>"TRUE"</td>
+</tr>
+<tr>
+<td>Encryption is enabled as soon as one of these options is set.</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td>An example to enable PDF encryption in Java code:</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+</tbody>
+</table>
+<p>import org.apache.fop.pdf.PDFEncryptionParams;</p>
+<p class="."></p>
+<p class=".">FOUserAgent userAgent = fopFactory.newFOUserAgent();
+useragent.getRendererOptions().put("encryption-params", new PDFEncryptionParams(
+ null, "password", false, false, true, true));
+Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
+</p>
+<ol>
+<li>
+<p>userPassword: String, may be null</p>
+</li>
+<li>
+<p>ownerPassword: String, may be null</p>
+</li>
+<li>
+<p>allowPrint: true if printing is allowed</p>
+</li>
+<li>
+<p>allowCopyContent: true if copying content is allowed</p>
+</li>
+<li>
+<p>allowEditContent: true if editing content is allowed</p>
+</li>
+<li>
+<p>allowEditAnnotations: true if editing annotations is allowed</p>
+</li>
+</ol>
+<p>Alternatively, you can set each value separately in the Map provided by FOUserAgent.getRendererOptions() by using the following keys:</p>
+<ol>
+<li>
+<p>user-password: String</p>
+</li>
+<li>
+<p>owner-password: String</p>
+</li>
+<li>
+<p>noprint: Boolean or "true"/"false"</p>
+</li>
+<li>
+<p>nocopy: Boolean or "true"/"false"</p>
+</li>
+<li>
+<p>noedit: Boolean or "true"/"false"</p>
+</li>
+<li>
+<p>noannotations: Boolean or "true"/"false"</p>
+</li>
+</ol>
+<h1 id="Environment">Environment</h1>
+<p>In order to use PDF encryption, FOP has to be compiled with cryptography support. Currently, only <a href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html">JCE</a> is supported. JCE is part of JDK 1.4. For earlier JDKs, it can be installed separately. The build process automatically detects JCE presence and installs PDF encryption support if possible, otherwise a stub is compiled in.</p>
+<p>Cryptography support must also be present at run time. In particular, a provider for the RC4 cipher is needed. Unfortunately, the sample JCE provider in Sun's JDK 1.4 does <strong>not</strong> provide RC4. If you get a message saying
+"Cannot find any provider supporting RC4"
+then you don't have the needed infrastructure.</p>
+<p>There are several commercial and a few Open Source packages which provide RC4. A pure Java implementation is produced by <a href="http://www.bouncycastle.org/">The Legion of the Bouncy Castle</a> . <a href="http://www.mozilla.org/projects/security/pki/jss/">Mozilla JSS</a> is an interface to a native implementation.</p>
+<h1 id="install_crypto">Installing a crypto provider</h1>
+<p>The pure Java implementation from <a href="http://www.bouncycastle.org/">Bouncy Castle</a> is easy to install.</p>
+<ol>
+<li>
+<p>Download the binary distribution for your JDK version.</p>
+</li>
+<li>
+<p>Unpack the distribution. Add the jar file to your classpath. A convenient way to use the jar on Linux is to simply drop it into the FOP lib directory, it will be automatically picked up by <code>fop.sh</code> .</p>
+</li>
+<li>
+<p>Open the <code>java.security</code> file and add<br></br> <code>security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider</code> ,<br></br>preferably at the end of the block defining the other crypto providers. For JDK 1.4 this is detailed on <a href="http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html#InstallProvider">Sun's web site</a> .</p>
+</li>
+</ol>
+<p>If you have any experience with Mozilla JSS or any other cryptography provider, please post it to the fop-user list.</p></div>
+ </div>
+
+ <div class="clear"></div>
+
+ <div id="footer">
+ <div class="copyright">
+ <div style="float:left; padding: 7px;">
+ <a title="Apache Software Foundation" href="http://www.apache.org"><img id="asf-feather-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100" /></a>
+ </div>
+ <p>
+ Copyright © 2012 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, Apache FOP, Apache Batik, 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/fop/1.1/pdfx.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfx.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/1.1/pdfx.html Tue Oct 23 04:23:32 2012
@@ -0,0 +1,396 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>Apache&trade; FOP: PDF/X (ISO 15930)</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/profile.css" rel="stylesheet" type="text/css" />
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css" />
+
+ <script src="http://code.jquery.com/jquery.min.js"></script>
+ <script>
+ $(document).ready(function(){
+ $('ul#navigation a').each(function() {
+ if (this.href === window.location.href)
+ { $(this). attr('id', 'forefront');}
+ });
+ $('ul#navigation a#forefront').each(function() {
+
+ });
+ })
+ </script>
+
+
+
+
+
+ <style>
+ .highlight {color: red;}
+ </style>
+
+ </head>
+
+ <body>
+
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <p><a href="/"><img alt="Apache XML Graphics Project Logo" src="/images/apache-xml-graphics.gif" title="Apache XML Graphics Project" /></a></p>
+<h1 id="apache-fop">Apache FOP</h1>
+<ul>
+<li><a href="/fop/">FOP Home</a></li>
+<li><a href="/fop/download.html">Download</a></li>
+<li><a href="/fop/quickstartguide.html">Quick Start Guide</a></li>
+<li><a href="/fop/compliance.html">Compliance</a></li>
+<li><a href="/fop/gethelp.html">Getting Help</a></li>
+<li><a href="/fop/faq.html">FAQs</a></li>
+<li><a href="/fop/maillist.html">Mailing Lists</a></li>
+<li><a href="/fop/license.html">License</a></li>
+<li>
+<h2 id="resources">Resources</h2>
+<ul>
+<li><a href="/fop/fo.html">XSL-FO</a></li>
+<li><a href="/fop/examples.html">Examples</a></li>
+<li><a href="/fop/bugs.html">Bugs</a></li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project</h2>
+<ul>
+<li><a href="/fop/news.html">News</a></li>
+<li><a href="/fop/team.html">Who We Are</a></li>
+<li><a href="/fop/status.html">Status</a></li>
+<li><a href="/fop/knownissues.html">Known Issues</a></li>
+<li><a href="/fop/changes.html">Changes</a></li>
+</ul>
+</li>
+<li>
+<h2 id="branches">Branches</h2>
+<ul>
+<li>
+<h2 id="apachewzxhzdk6-fop-trunk-dev">Apache™ FOP Trunk (dev)</h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apachewzxhzdk7-fop">Using Apache™ FOP</h3>
+<ul>
+<li><a href="/fop/trunk/compiling.html">Build</a></li>
+<li><a href="/fop/trunk/configuration.html">Configure</a></li>
+<li><a href="/fop/trunk/running.html">Run</a></li>
+<li><a href="/fop/trunk/embedding.html">Embed</a></li>
+<li><a href="/fop/trunk/servlets.html">Servlets</a></li>
+<li><a href="/fop/trunk/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features">Features</h3>
+<ul>
+<li><a href="/fop/trunk/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/trunk/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/trunk/events.html">Events</a></li>
+<li><a href="/fop/trunk/extensions.html">Extensions</a></li>
+<li><a href="/fop/trunk/fonts.html">Fonts</a></li>
+<li><a href="/fop/trunk/graphics.html">Graphics</a></li>
+<li><a href="/fop/trunk/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/trunk/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/trunk/metadata.html">Metadata</a></li>
+<li><a href="/fop/trunk/output.html">Output Targets</a></li>
+<li><a href="/fop/trunk/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/trunk/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/trunk/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk5-fop-10">Apache™ FOP 1.0</h2>
+<ul>
+<li><a href="/fop/1.0/">FOP 1.0 Overview</a></li>
+<li><a href="/fop/1.0/releaseNotes_1.0.html">Release Notes</a></li>
+<li><a href="/fop/1.0/changes_1.0.html">Changes (1.0)</a></li>
+<li><a href="/fop/1.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-10">Using Apache FOP 1.0</h3>
+<ul>
+<li><a href="/fop/1.0/compiling.html">Build</a></li>
+<li><a href="/fop/1.0/configuration.html">Configure</a></li>
+<li><a href="/fop/1.0/running.html">Run</a></li>
+<li><a href="/fop/1.0/embedding.html">Embed</a></li>
+<li><a href="/fop/1.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features</h3>
+<ul>
+<li><a href="/fop/1.0/output.html">Output Targets</a></li>
+<li><a href="/fop/1.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/1.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.0/events.html">Events</a></li>
+<li><a href="/fop/1.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.0/accessibility.html">Accessibility</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk4-fop-095">Apache™ FOP 0.95</h2>
+<ul>
+<li><a href="/fop/0.95/">FOP 0.95 Overview</a></li>
+<li><a href="/fop/0.95/releaseNotes_0.95.html">Release Notes</a></li>
+<li><a href="/fop/0.95/changes_0.95.html">Changes (0.95)</a></li>
+<li><a href="/fop/0.95/changes_0.95beta.html">Changes (0.95beta)</a></li>
+<li><a href="/fop/0.95/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/0.95/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-095">Using Apache FOP 0.95</h3>
+<ul>
+<li><a href="/fop/0.95/compiling.html">Build</a></li>
+<li><a href="/fop/0.95/configuration.html">Configure</a></li>
+<li><a href="/fop/0.95/running.html">Run</a></li>
+<li><a href="/fop/0.95/embedding.html">Embed</a></li>
+<li><a href="/fop/0.95/servlets.html">Servlets</a></li>
+<li><a href="/fop/0.95/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features</h3>
+<ul>
+<li><a href="/fop/0.95/output.html">Output Targets</a></li>
+<li><a href="/fop/0.95/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/0.95/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/0.95/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/0.95/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/0.95/graphics.html">Graphics</a></li>
+<li><a href="/fop/0.95/fonts.html">Fonts</a></li>
+<li><a href="/fop/0.95/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/0.95/extensions.html">Extensions</a></li>
+<li><a href="/fop/0.95/metadata.html">Metadata</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h1 id="apachewzxhzdk3-fop-development">Apache™ FOP Development</h1>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design</h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process</h2>
+<ul>
+<li><a href="/fop/dev/design/startup.html">Startup</a></li>
+<li><a href="/fop/dev/design/parsing.html">XML Parsing</a></li>
+<li><a href="/fop/dev/design/fotree.html">FO Tree</a></li>
+<li><a href="/fop/dev/design/properties.html">Properties</a></li>
+<li><a href="/fop/dev/design/layout.html">Layout</a></li>
+<li><a href="/fop/dev/design/breakpos.html">Break Possibility</a></li>
+<li><a href="/fop/dev/design/areas.html">Area Tree</a></li>
+<li><a href="/fop/dev/design/renderers.html">Renderers</a></li>
+</ul>
+</li>
+<li>
+<h2 id="miscellaneous">Miscellaneous</h2>
+<ul>
+<li><a href="/fop/dev/design/images.html">Images</a></li>
+<li><a href="/fop/dev/design/pdf-library.html">PDF Library</a></li>
+<li><a href="/fop/dev/design/svg.html">SVG</a></li>
+<li><a href="/fop/dev/design/embedding.html">Embedding</a></li>
+<li><a href="/fop/dev/design/extending.html">Extending</a></li>
+<li><a href="/fop/dev/design/optimise.html">Optimisations</a></li>
+<li><a href="/fop/dev/design/useragent.html">User Agent</a></li>
+</ul>
+</li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FOPProjectPages">Unresolved (Wiki)</a></li>
+<li><a href="/fop/dev/svg.html">SVG</a></li>
+<li><a href="/fop/dev/extensions.html">Extensions</a></li>
+<li>
+<h2 id="develop">Develop</h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;namedcmd=Fop+all&amp;newqueryname=fop+patch+queue&amp;tofooter=1&amp;order=Reuse+same+sort+as+last+time">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test</h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy</h2>
+<ul>
+<li><a href="/fop/dev/doc.html">Doc Mgmt</a></li>
+<li><a href="/fop/dev/release.html">Release</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bug_severity%2Cpriority%20DESC">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources</h2>
+<ul>
+<li><a href="/fop/dev/faq.html">FAQs</a></li>
+<li><a href="/fop/dev/tools.html">Tools</a></li>
+<li><a href="http://svn.apache.org/viewvc/xmlgraphics/fop">ViewVC</a></li>
+</ul>
+</li>
+<li>
+<h2 id="subpackages">SubPackages</h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apachewzxhzdk2-xml-graphics">Apache™ XML Graphics</h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview</h2>
+<ul>
+<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>
+<li><a href="http://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects</h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h2 id="search-apache-xml-graphics">Search Apache XML Graphics</h2>
+<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" />
+ <input type="submit" id="submit" value="Search" />
+</form>
+
+<script>
+$(document).ready(function () {
+Â Â Â Â $('#navigation :header').click(function () {
+Â Â Â Â Â Â Â Â var text = $(this).siblings('ul');
+Â Â Â Â Â Â Â Â if (text.is(':hidden')) {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideDown('200');
+Â Â Â Â Â Â Â Â } else {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideUp('200');
+Â Â Â Â Â Â Â Â }
+Â Â Â Â });
+Â Â Â Â if ($('#navigation :header').siblings('ul')) {
+ $('#navigation :header').append(' »');
+Â Â Â Â }
+ $('#navigation > ul > li ul').hide();
+ var str=location.href.toLowerCase();
+ $("#navigation li a").each(function() {
+ if (str.indexOf(this.href.toLowerCase()) > -1) {
+ $(this).parents().slideDown('200');
+ $("li.highlight").removeClass("highlight");
+ $(this).parent().addClass("highlight");
+ }
+ });
+})
+</script>
+ </div>
+
+ <div id="bannertext" style="border-bottom: 2px dashed #666666; height: 70px;">
+ <a href="/fop/"><img src="/images/apache-fop-logo.jpg" alt="The Apache FOP Project" width="120" height="65" style="float:left; margin-right: 15px;" /></a>
+ <h2>The Apache™ FOP Project</h2>
+ </div><!-- <h1>Apache&trade; FOP: PDF/X (ISO 15930)</h1> -->
+
+
+
+ <div id="content" class="grid_16">
+ <!-- <div id="breadcrumb"><a href="/">Home</a> » <a href="/fop/">Fop</a> » <a href="/fop/1.1/">1.1</a></div> -->
+ <div class="section-content"><p><version>$Revision: 1298724 $</version><authors><person email="jeremias@apache.org" name="Jeremias Märki"></person></authors></p>
+<h1 id="overview">Overview</h1>
+<p><warning>Support for PDF/X is available beginning with Apache™ FOP version 0.93. This feature is new and may not be 100% complete, yet. Feedback is welcome.</warning>
+PDF/X is a standard which faciliates prepress digital data exchange using PDF. Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X profiles. PDF/X-3:2003 is documented in <a href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=39940&ICS1=37&ICS2=100&ICS3=99">ISO 15930-6:2003(E)</a> . More info on PDF/X can be found on the <a href="http://www.pdfx.info/">PDF/X info site</a> .</p>
+<h1 id="status">Implementation Status</h1>
+<p><strong>PDF/X-3:2003</strong> is implemented to the degree that FOP supports the creation of the elements described in ISO 15930-6.</p>
+<p>An important restriction of the current implementation is that all normal RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color space (XSL-FO and SVG both use sRGB as their default color space). There's no conversion to a CMYK color space. Although sRGB is a calibrated color space, its color space has a different size than a CMYK color space which makes the conversion a lossy conversion and can lead to unwanted results. Although the use of the calibrated sRGB has been promoted for years, print shops usually prefer to convert an sRGB PDF to CMYK prior to production. Until there's full CMYK support in FOP you will have to work closely with your print service provider to make sure you get the intended result.</p>
+<p>Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function). Note that there are bugs in Adobe Acrobat which cause false alarms if both PDF/A-1b and PDF/X-3:2003 are activated at the same time.</p>
+<h1 id="command-line">Usage (command line)</h1>
+<p>To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" as a parameter. If there is a violation of one of the validation rules for PDF/X, an error message is presented and the processing stops.</p>
+<h1 id="embedded">Usage (embedded)</h1>
+<p>When FOP is embedded in another Java application you can set a special option on the renderer options in the user agent to activate the PDF/A-1b profile. Here's an example:</p>
+<p class=".">FOUserAgent userAgent = fopFactory.newFOUserAgent();
+userAgent.getRendererOptions().put("pdf-x-mode", "PDF/X-3:2003");
+Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, userAgent);
+</p>
+<h1 id="rules">PDF/X in Action</h1>
+<p>There are a number of things that must be looked after if you activate a PDF/X profile. If you receive a PDFConformanceException, have a look at the following list (not necessarily comprehensive):</p>
+<ul>
+<li>
+<p>Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) you need to obtain a license for them and embed them like any other font.</p>
+</li>
+<li>
+<p>Don't use PDF encryption. PDF/X doesn't allow it.</p>
+</li>
+<li>
+<p>Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing color spaces and FOP currently only properly supports the sRGB color space. However, you will need to specify an <a href="configuration.html#pdf-renderer">output device profile</a> (usually a CMYK profile) in the configuration. sRGB won't work here since it's a display device profile, not an output device profile.</p>
+</li>
+<li>
+<p>Don't use non-RGB colors in SVG images. Same issue as with CMYK images.</p>
+</li>
+<li>
+<p>Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003.</p>
+</li>
+<li>
+<p>PDF is forced to version 1.4 if PDF/X-3:2003 is activated.</p>
+</li>
+</ul>
+<h1 id="profile-compatibility">PDF profile compatibility</h1>
+<p>The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be activated at the same time.</p></div>
+ </div>
+
+ <div class="clear"></div>
+
+ <div id="footer">
+ <div class="copyright">
+ <div style="float:left; padding: 7px;">
+ <a title="Apache Software Foundation" href="http://www.apache.org"><img id="asf-feather-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100" /></a>
+ </div>
+ <p>
+ Copyright © 2012 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, Apache FOP, Apache Batik, 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/fop/1.1/releaseNotes_1.0.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/1.1/releaseNotes_1.0.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/1.1/releaseNotes_1.0.html Tue Oct 23 04:23:32 2012
@@ -0,0 +1,400 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>Release Notes for Apache FOP 1.0</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/profile.css" rel="stylesheet" type="text/css" />
+ <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css" />
+
+ <script src="http://code.jquery.com/jquery.min.js"></script>
+ <script>
+ $(document).ready(function(){
+ $('ul#navigation a').each(function() {
+ if (this.href === window.location.href)
+ { $(this). attr('id', 'forefront');}
+ });
+ $('ul#navigation a#forefront').each(function() {
+
+ });
+ })
+ </script>
+
+
+
+
+
+ <style>
+ .highlight {color: red;}
+ </style>
+
+ </head>
+
+ <body>
+
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <p><a href="/"><img alt="Apache XML Graphics Project Logo" src="/images/apache-xml-graphics.gif" title="Apache XML Graphics Project" /></a></p>
+<h1 id="apache-fop">Apache FOP</h1>
+<ul>
+<li><a href="/fop/">FOP Home</a></li>
+<li><a href="/fop/download.html">Download</a></li>
+<li><a href="/fop/quickstartguide.html">Quick Start Guide</a></li>
+<li><a href="/fop/compliance.html">Compliance</a></li>
+<li><a href="/fop/gethelp.html">Getting Help</a></li>
+<li><a href="/fop/faq.html">FAQs</a></li>
+<li><a href="/fop/maillist.html">Mailing Lists</a></li>
+<li><a href="/fop/license.html">License</a></li>
+<li>
+<h2 id="resources">Resources</h2>
+<ul>
+<li><a href="/fop/fo.html">XSL-FO</a></li>
+<li><a href="/fop/examples.html">Examples</a></li>
+<li><a href="/fop/bugs.html">Bugs</a></li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project</h2>
+<ul>
+<li><a href="/fop/news.html">News</a></li>
+<li><a href="/fop/team.html">Who We Are</a></li>
+<li><a href="/fop/status.html">Status</a></li>
+<li><a href="/fop/knownissues.html">Known Issues</a></li>
+<li><a href="/fop/changes.html">Changes</a></li>
+</ul>
+</li>
+<li>
+<h2 id="branches">Branches</h2>
+<ul>
+<li>
+<h2 id="apachewzxhzdk6-fop-trunk-dev">Apache™ FOP Trunk (dev)</h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apachewzxhzdk7-fop">Using Apache™ FOP</h3>
+<ul>
+<li><a href="/fop/trunk/compiling.html">Build</a></li>
+<li><a href="/fop/trunk/configuration.html">Configure</a></li>
+<li><a href="/fop/trunk/running.html">Run</a></li>
+<li><a href="/fop/trunk/embedding.html">Embed</a></li>
+<li><a href="/fop/trunk/servlets.html">Servlets</a></li>
+<li><a href="/fop/trunk/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features">Features</h3>
+<ul>
+<li><a href="/fop/trunk/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/trunk/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/trunk/events.html">Events</a></li>
+<li><a href="/fop/trunk/extensions.html">Extensions</a></li>
+<li><a href="/fop/trunk/fonts.html">Fonts</a></li>
+<li><a href="/fop/trunk/graphics.html">Graphics</a></li>
+<li><a href="/fop/trunk/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/trunk/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/trunk/metadata.html">Metadata</a></li>
+<li><a href="/fop/trunk/output.html">Output Targets</a></li>
+<li><a href="/fop/trunk/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/trunk/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/trunk/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk5-fop-10">Apache™ FOP 1.0</h2>
+<ul>
+<li><a href="/fop/1.0/">FOP 1.0 Overview</a></li>
+<li><a href="/fop/1.0/releaseNotes_1.0.html">Release Notes</a></li>
+<li><a href="/fop/1.0/changes_1.0.html">Changes (1.0)</a></li>
+<li><a href="/fop/1.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-10">Using Apache FOP 1.0</h3>
+<ul>
+<li><a href="/fop/1.0/compiling.html">Build</a></li>
+<li><a href="/fop/1.0/configuration.html">Configure</a></li>
+<li><a href="/fop/1.0/running.html">Run</a></li>
+<li><a href="/fop/1.0/embedding.html">Embed</a></li>
+<li><a href="/fop/1.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features</h3>
+<ul>
+<li><a href="/fop/1.0/output.html">Output Targets</a></li>
+<li><a href="/fop/1.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/1.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.0/events.html">Events</a></li>
+<li><a href="/fop/1.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.0/accessibility.html">Accessibility</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="apachewzxhzdk4-fop-095">Apache™ FOP 0.95</h2>
+<ul>
+<li><a href="/fop/0.95/">FOP 0.95 Overview</a></li>
+<li><a href="/fop/0.95/releaseNotes_0.95.html">Release Notes</a></li>
+<li><a href="/fop/0.95/changes_0.95.html">Changes (0.95)</a></li>
+<li><a href="/fop/0.95/changes_0.95beta.html">Changes (0.95beta)</a></li>
+<li><a href="/fop/0.95/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/0.95/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-095">Using Apache FOP 0.95</h3>
+<ul>
+<li><a href="/fop/0.95/compiling.html">Build</a></li>
+<li><a href="/fop/0.95/configuration.html">Configure</a></li>
+<li><a href="/fop/0.95/running.html">Run</a></li>
+<li><a href="/fop/0.95/embedding.html">Embed</a></li>
+<li><a href="/fop/0.95/servlets.html">Servlets</a></li>
+<li><a href="/fop/0.95/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features</h3>
+<ul>
+<li><a href="/fop/0.95/output.html">Output Targets</a></li>
+<li><a href="/fop/0.95/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/0.95/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/0.95/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/0.95/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/0.95/graphics.html">Graphics</a></li>
+<li><a href="/fop/0.95/fonts.html">Fonts</a></li>
+<li><a href="/fop/0.95/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/0.95/extensions.html">Extensions</a></li>
+<li><a href="/fop/0.95/metadata.html">Metadata</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h1 id="apachewzxhzdk3-fop-development">Apache™ FOP Development</h1>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design</h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process</h2>
+<ul>
+<li><a href="/fop/dev/design/startup.html">Startup</a></li>
+<li><a href="/fop/dev/design/parsing.html">XML Parsing</a></li>
+<li><a href="/fop/dev/design/fotree.html">FO Tree</a></li>
+<li><a href="/fop/dev/design/properties.html">Properties</a></li>
+<li><a href="/fop/dev/design/layout.html">Layout</a></li>
+<li><a href="/fop/dev/design/breakpos.html">Break Possibility</a></li>
+<li><a href="/fop/dev/design/areas.html">Area Tree</a></li>
+<li><a href="/fop/dev/design/renderers.html">Renderers</a></li>
+</ul>
+</li>
+<li>
+<h2 id="miscellaneous">Miscellaneous</h2>
+<ul>
+<li><a href="/fop/dev/design/images.html">Images</a></li>
+<li><a href="/fop/dev/design/pdf-library.html">PDF Library</a></li>
+<li><a href="/fop/dev/design/svg.html">SVG</a></li>
+<li><a href="/fop/dev/design/embedding.html">Embedding</a></li>
+<li><a href="/fop/dev/design/extending.html">Extending</a></li>
+<li><a href="/fop/dev/design/optimise.html">Optimisations</a></li>
+<li><a href="/fop/dev/design/useragent.html">User Agent</a></li>
+</ul>
+</li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FOPProjectPages">Unresolved (Wiki)</a></li>
+<li><a href="/fop/dev/svg.html">SVG</a></li>
+<li><a href="/fop/dev/extensions.html">Extensions</a></li>
+<li>
+<h2 id="develop">Develop</h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;namedcmd=Fop+all&amp;newqueryname=fop+patch+queue&amp;tofooter=1&amp;order=Reuse+same+sort+as+last+time">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test</h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy</h2>
+<ul>
+<li><a href="/fop/dev/doc.html">Doc Mgmt</a></li>
+<li><a href="/fop/dev/release.html">Release</a></li>
+<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bug_severity%2Cpriority%20DESC">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources</h2>
+<ul>
+<li><a href="/fop/dev/faq.html">FAQs</a></li>
+<li><a href="/fop/dev/tools.html">Tools</a></li>
+<li><a href="http://svn.apache.org/viewvc/xmlgraphics/fop">ViewVC</a></li>
+</ul>
+</li>
+<li>
+<h2 id="subpackages">SubPackages</h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apachewzxhzdk2-xml-graphics">Apache™ XML Graphics</h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview</h2>
+<ul>
+<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>
+<li><a href="http://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects</h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h2 id="search-apache-xml-graphics">Search Apache XML Graphics</h2>
+<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" />
+ <input type="submit" id="submit" value="Search" />
+</form>
+
+<script>
+$(document).ready(function () {
+Â Â Â Â $('#navigation :header').click(function () {
+Â Â Â Â Â Â Â Â var text = $(this).siblings('ul');
+Â Â Â Â Â Â Â Â if (text.is(':hidden')) {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideDown('200');
+Â Â Â Â Â Â Â Â } else {
+Â Â Â Â Â Â Â Â Â Â Â Â text.slideUp('200');
+Â Â Â Â Â Â Â Â }
+Â Â Â Â });
+Â Â Â Â if ($('#navigation :header').siblings('ul')) {
+ $('#navigation :header').append(' »');
+Â Â Â Â }
+ $('#navigation > ul > li ul').hide();
+ var str=location.href.toLowerCase();
+ $("#navigation li a").each(function() {
+ if (str.indexOf(this.href.toLowerCase()) > -1) {
+ $(this).parents().slideDown('200');
+ $("li.highlight").removeClass("highlight");
+ $(this).parent().addClass("highlight");
+ }
+ });
+})
+</script>
+ </div>
+
+ <div id="bannertext" style="border-bottom: 2px dashed #666666; height: 70px;">
+ <a href="/fop/"><img src="/images/apache-fop-logo.jpg" alt="The Apache FOP Project" width="120" height="65" style="float:left; margin-right: 15px;" /></a>
+ <h2>The Apache™ FOP Project</h2>
+ </div><!-- <h1>Release Notes for Apache FOP 1.0</h1> -->
+
+
+
+ <div id="content" class="grid_16">
+ <!-- <div id="breadcrumb"><a href="/">Home</a> » <a href="/fop/">Fop</a> » <a href="/fop/1.1/">1.1</a></div> -->
+ <div class="section-content"><h1 id="version_1.0">Major Changes in Version 1.0</h1>
+<p>This is not a complete list of changes, just some of the more important ones. A full list of changes in this release <a href="changes_1.0.html">is available</a> .</p>
+<h2 id="changes-to-the-code-base-changestothecodebase">Changes to the Code Base ## {#Changes+to+the+Code+Base}</h2>
+<ul>
+<li>
+<p><icon alt="fix" src="../images/fix.jpg"></icon>Fixed memory leak in property cache (not cleaning stale PropertyCache$CacheEntry instances). Committed by JM.</p>
+</li>
+<li>
+<p><icon alt="update" src="../images/update.jpg"></icon>Changed FONode.addCharacters() parameter to closer match the signature of the standard SAX characters() event (reduces confusion and computations). <em>!! Implementors of extensions that subclass FONode directly, and offer an implementation for addCharacters() should take care to make similar modifications in their code !!</em> Committed by AD.</p>
+</li>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>Added an event handling framework which allows to get better feedback from within FOP with the ability to customize problem management. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="changes-to-the-font-subsystem-changestothefontsubsystem">Changes to the Font Subsystem ## {#Changes+to+the+Font+Subsystem}</h2>
+<ul>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>Add support for font substitution. Committed by AC.</p>
+</li>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>Added support for addressing all glyphs available in a Type 1 font, not just the ones in the font's primary encoding. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="changes-to-the-layout-engine-changestothelayoutengine">Changes to the Layout Engine ## {#Changes+to+the+Layout+Engine}</h2>
+<ul>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>Added limited support for pages of different inline-progression-dimensions within a page-sequence. Committed by VH.</p>
+</li>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>Added minimal support for integer keep values on the various keep properties on block-level FOs. For now, all integer values are treated the same (i.e. without strength distinction). Using integers allows to avoid overflows that can happen when "always" is used extensively. Committed by JM.</p>
+</li>
+</ul>
+<h2 id="changes-to-renderers-output-formats-changestorenderers28outputformats29">Changes to Renderers (Output Formats) ## {#Changes+to+Renderers+%28Output+Formats%29}</h2>
+<ul>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>AFP Output: An AFPGraphics2D implementation which provides the ability to use Batik to drive the production of AFP Graphics (GOCA) output from SVG. Committed by AC.</p>
+</li>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>AFP Output: Resource group leveling, external streaming, and de-duplication of images and graphics using IncludeObject and ResourceGroup. Committed by AC.</p>
+</li>
+<li>
+<p><icon alt="add" src="../images/add.jpg"></icon>AFP Output: Native image embedding support (e.g. JPEG, GIF, TIFF) using ObjectContainer and a MOD:CA Registry implementation. Committed by AC.</p>
+</li>
+</ul></div>
+ </div>
+
+ <div class="clear"></div>
+
+ <div id="footer">
+ <div class="copyright">
+ <div style="float:left; padding: 7px;">
+ <a title="Apache Software Foundation" href="http://www.apache.org"><img id="asf-feather-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100" /></a>
+ </div>
+ <p>
+ Copyright © 2012 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, Apache FOP, Apache Batik, 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