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 2020/05/13 09:43:54 UTC
svn commit: r1060426 [27/37] - in
/websites/staging/xmlgraphics/trunk/content: ./ batik/ fop/ fop/0.95/
fop/1.0/ fop/1.1/ fop/2.0/ fop/2.1/ fop/2.2/ fop/2.3/ fop/2.4/ fop/2.5/
fop/2.5/images/ fop/dev/ fop/dev/design/ fop/trunk/
Added: websites/staging/xmlgraphics/trunk/content/fop/2.5/output.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/2.5/output.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/2.5/output.html Wed May 13 09:43:51 2020
@@ -0,0 +1,1543 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>Apache(tm) FOP Output Formats</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="//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" />
+ <link href="/css/print.css" rel="stylesheet" type="text/css" media="print" />
+
+ <script src="//code.jquery.com/jquery.min.js"></script>
+ <script type="text/javascript" src="/js/jquery.stoc.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() {
+
+ });
+ })
+ $(function(){
+ $("#items").stoc({ search: "#content", stocTitle: "<h3>Page Contents</h3>" });
+ });
+ </script>
+
+
+
+
+
+ <style>
+ .highlight {color: red;}
+ </style>
+
+ </head>
+
+ <body>
+
+ <div id="banner">
+ </div>
+
+ <div id="navigation">
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<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<a class="headerlink" href="#apache-fop" title="Permanent link">¶</a></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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP">FOP Wiki</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<a class="headerlink" href="#resources" title="Permanent link">¶</a></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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project<a class="headerlink" href="#project" title="Permanent link">¶</a></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="versions">Versions<a class="headerlink" href="#versions" title="Permanent link">¶</a></h2>
+<ul>
+<li>
+<h2 id="fop-trunk-dev">FOP Trunk (dev)<a class="headerlink" href="#fop-trunk-dev" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop">Using Apache™ FOP<a class="headerlink" href="#using-apache-fop" title="Permanent link">¶</a></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<a class="headerlink" href="#features" title="Permanent link">¶</a></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>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/trunk/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-25">FOP 2.5<a class="headerlink" href="#fop-25" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.5/">FOP 2.5 Overview</a></li>
+<li><a href="/fop/2.5/releaseNotes_2.5.html">Release Notes</a></li>
+<li><a href="/fop/2.5/changes_2.5.html">Changes (2.5)</a></li>
+<li><a href="/fop/2.5/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.5/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-25">Using Apache FOP 2.5<a class="headerlink" href="#using-apache-fop-25" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.5/compiling.html">Build</a></li>
+<li><a href="/fop/2.5/configuration.html">Configure</a></li>
+<li><a href="/fop/2.5/running.html">Run</a></li>
+<li><a href="/fop/2.5/embedding.html">Embed</a></li>
+<li><a href="/fop/2.5/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.5/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features<a class="headerlink" href="#features_1" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.5/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.5/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.5/events.html">Events</a></li>
+<li><a href="/fop/2.5/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.5/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.5/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.5/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.5/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.5/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.5/output.html">Output Targets</a></li>
+<li><a href="/fop/2.5/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.5/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.5/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.5/whitespacemanagement.html">Whitespace Management</a> </li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-24">FOP 2.4<a class="headerlink" href="#fop-24" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.4/">FOP 2.4 Overview</a></li>
+<li><a href="/fop/2.4/releaseNotes_2.4.html">Release Notes</a></li>
+<li><a href="/fop/2.4/changes_2.4.html">Changes (2.4)</a></li>
+<li><a href="/fop/2.4/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.4/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-24">Using Apache FOP 2.4<a class="headerlink" href="#using-apache-fop-24" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.4/compiling.html">Build</a></li>
+<li><a href="/fop/2.4/configuration.html">Configure</a></li>
+<li><a href="/fop/2.4/running.html">Run</a></li>
+<li><a href="/fop/2.4/embedding.html">Embed</a></li>
+<li><a href="/fop/2.4/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.4/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features<a class="headerlink" href="#features_2" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.4/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.4/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.4/events.html">Events</a></li>
+<li><a href="/fop/2.4/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.4/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.4/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.4/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.4/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.4/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.4/output.html">Output Targets</a></li>
+<li><a href="/fop/2.4/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.4/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.4/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.4/whitespacemanagement.html">Whitespace Management</a> </li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-23">FOP 2.3<a class="headerlink" href="#fop-23" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.3/">FOP 2.3 Overview</a></li>
+<li><a href="/fop/2.3/releaseNotes_2.3.html">Release Notes</a></li>
+<li><a href="/fop/2.3/changes_2.3.html">Changes (2.3)</a></li>
+<li><a href="/fop/2.3/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.3/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-23">Using Apache FOP 2.3<a class="headerlink" href="#using-apache-fop-23" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.3/compiling.html">Build</a></li>
+<li><a href="/fop/2.3/configuration.html">Configure</a></li>
+<li><a href="/fop/2.3/running.html">Run</a></li>
+<li><a href="/fop/2.3/embedding.html">Embed</a></li>
+<li><a href="/fop/2.3/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.3/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_3">Features<a class="headerlink" href="#features_3" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.3/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.3/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.3/events.html">Events</a></li>
+<li><a href="/fop/2.3/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.3/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.3/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.3/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.3/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.3/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.3/output.html">Output Targets</a></li>
+<li><a href="/fop/2.3/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.3/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.3/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.3/whitespacemanagement.html">Whitespace Management</a> </li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-22">FOP 2.2<a class="headerlink" href="#fop-22" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.2/">FOP 2.2 Overview</a></li>
+<li><a href="/fop/2.2/releaseNotes_2.2.html">Release Notes</a></li>
+<li><a href="/fop/2.2/changes_2.2.html">Changes (2.2)</a></li>
+<li><a href="/fop/2.2/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.2/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-22">Using Apache FOP 2.2<a class="headerlink" href="#using-apache-fop-22" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.2/compiling.html">Build</a></li>
+<li><a href="/fop/2.2/configuration.html">Configure</a></li>
+<li><a href="/fop/2.2/running.html">Run</a></li>
+<li><a href="/fop/2.2/embedding.html">Embed</a></li>
+<li><a href="/fop/2.2/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.2/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_4">Features<a class="headerlink" href="#features_4" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.2/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.2/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.2/events.html">Events</a></li>
+<li><a href="/fop/2.2/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.2/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.2/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.2/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.2/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.2/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.2/output.html">Output Targets</a></li>
+<li><a href="/fop/2.2/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.2/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.2/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.2/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-21">FOP 2.1<a class="headerlink" href="#fop-21" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.1/">FOP 2.1 Overview</a></li>
+<li><a href="/fop/2.1/releaseNotes_2.1.html">Release Notes</a></li>
+<li><a href="/fop/2.1/changes_2.1.html">Changes (2.1)</a></li>
+<li><a href="/fop/2.1/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.1/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-21">Using Apache FOP 2.1<a class="headerlink" href="#using-apache-fop-21" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.1/compiling.html">Build</a></li>
+<li><a href="/fop/2.1/configuration.html">Configure</a></li>
+<li><a href="/fop/2.1/running.html">Run</a></li>
+<li><a href="/fop/2.1/embedding.html">Embed</a></li>
+<li><a href="/fop/2.1/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.1/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_5">Features<a class="headerlink" href="#features_5" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.1/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.1/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.1/events.html">Events</a></li>
+<li><a href="/fop/2.1/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.1/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.1/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.1/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.1/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.1/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.1/output.html">Output Targets</a></li>
+<li><a href="/fop/2.1/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.1/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.1/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.1/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-20">FOP 2.0<a class="headerlink" href="#fop-20" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/2.0/">FOP 2.0 Overview</a></li>
+<li><a href="/fop/2.0/releaseNotes_2.0.html">Release Notes</a></li>
+<li><a href="/fop/2.0/changes_2.0.html">Changes (2.0)</a></li>
+<li><a href="/fop/2.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-20">Using Apache FOP 2.0<a class="headerlink" href="#using-apache-fop-20" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.0/compiling.html">Build</a></li>
+<li><a href="/fop/2.0/configuration.html">Configure</a></li>
+<li><a href="/fop/2.0/running.html">Run</a></li>
+<li><a href="/fop/2.0/embedding.html">Embed</a></li>
+<li><a href="/fop/2.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_6">Features<a class="headerlink" href="#features_6" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/2.0/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.0/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.0/events.html">Events</a></li>
+<li><a href="/fop/2.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.0/output.html">Output Targets</a></li>
+<li><a href="/fop/2.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.0/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-11">FOP 1.1<a class="headerlink" href="#fop-11" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/1.1/">FOP 1.1 Overview</a></li>
+<li><a href="/fop/1.1/releaseNotes_1.1.html">Release Notes</a></li>
+<li><a href="/fop/1.1/changes_1.1.html">Changes (1.1)</a></li>
+<li><a href="/fop/1.1/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.1/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-11">Using Apache FOP 1.1<a class="headerlink" href="#using-apache-fop-11" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/1.1/compiling.html">Build</a></li>
+<li><a href="/fop/1.1/configuration.html">Configure</a></li>
+<li><a href="/fop/1.1/running.html">Run</a></li>
+<li><a href="/fop/1.1/embedding.html">Embed</a></li>
+<li><a href="/fop/1.1/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.1/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_7">Features<a class="headerlink" href="#features_7" title="Permanent link">¶</a></h3>
+<ul>
+<li><a href="/fop/1.1/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/1.1/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/1.1/events.html">Events</a></li>
+<li><a href="/fop/1.1/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.1/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.1/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.1/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.1/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.1/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.1/output.html">Output Targets</a></li>
+<li><a href="/fop/1.1/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.1/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.1/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-10">FOP 1.0<a class="headerlink" href="#fop-10" title="Permanent link">¶</a></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<a class="headerlink" href="#using-apache-fop-10" title="Permanent link">¶</a></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_8">Features<a class="headerlink" href="#features_8" title="Permanent link">¶</a></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="fop-development">FOP Development<a class="headerlink" href="#fop-development" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design<a class="headerlink" href="#design" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process<a class="headerlink" href="#core-process" title="Permanent link">¶</a></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<a class="headerlink" href="#miscellaneous" title="Permanent link">¶</a></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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/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<a class="headerlink" href="#develop" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FOP%20AND%20description%20~%20%22\%22[patch]\%22%22%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test<a class="headerlink" href="#test" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy<a class="headerlink" href="#deploy" title="Permanent link">¶</a></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="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FOP%20AND%20issuetype%20%3D%20Bug%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources<a class="headerlink" href="#resources_1" title="Permanent link">¶</a></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<a class="headerlink" href="#subpackages" title="Permanent link">¶</a></h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apache-xml-graphics">Apache™ XML Graphics<a class="headerlink" href="#apache-xml-graphics" title="Permanent link">¶</a></h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview<a class="headerlink" href="#project-overview" title="Permanent link">¶</a></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="https://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="https://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+<li><a href="https://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="/security.html">Apache XML Graphics Security</a></li>
+<li><a href="https://www.apache.org/security/">ASF Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects<a class="headerlink" href="#sub-projects" title="Permanent link">¶</a></h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h3 id="search-apache-xml-graphics">Search Apache XML Graphics<a class="headerlink" href="#search-apache-xml-graphics" title="Permanent link">¶</a></h3>
+<form name="search" id="search" action="https://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>
+
+<h3 id="apachecon-n-america">ApacheCon N. America<a class="headerlink" href="#apachecon-n-america" title="Permanent link">¶</a></h3>
+<p><a title="ApacheCon North America" href="https://www.apachecon.com"><img class="apachecon_logo" alt="ApacheCon North America" src="https://www.apachecon.com/images/landingpage/apachecon-logo.png" width="200" /></a><br /><br /></p>
+<ul>
+<li><strong><a href="https://www.apachecon.com/">ApacheCon NA</a></strong></li>
+</ul>
+<p>Hope to see you there!</p>
+<h3 id="apachecon-europe">ApacheCon Europe<a class="headerlink" href="#apachecon-europe" title="Permanent link">¶</a></h3>
+<p><a title="ApacheCon Europe" href="https://www.apachecon.com"><img class="apachecon_logo" alt="ApacheCon Europe" src="https://www.apachecon.com/images/landingpage/apachecon-logo.png" width="200" /></a><br /><br /></p>
+<ul>
+<li><strong><a href="https://www.apachecon.com/">ApacheCon Europe</a></strong></li>
+</ul>
+<p>Hope to see you there!</p>
+<p><a title="Apache Software Foundation" href="https://www.apache.org"><img id="asf_logo_url" alt="Apache Software Foundation " src="/images/asf_logo_url.png" width="200" /></a><br /><br /></p>
+<p><a title="Support the Apache Software Foundation" href="https://donate.apache.org/"><img id="asf_support_url" alt="Support the Apache Software Foundation " src="https://blogs.apache.org/foundation/mediaresource/d67ca611-a57c-462d-ac23-95063f81d175" width="200" /></a></p>
+<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').not('#search-apache-xml-graphics, #apachewzxhzdk3-xml-graphics, #sub-projects').append(' »');
+ }
+ $('#navigation > ul > li > ul > li ul').hide();
+ $('#project-overview').next().hide();
+ $('#versions').next().show();
+ 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(tm) FOP Output Formats</h1> -->
+
+
+
+ <div id="content" class="grid_16">
+ <div id="items">
+ </div>
+ <!-- <div id="breadcrumb"><a href="/">Home</a> » <a href="/fop/">Fop</a> » <a href="/fop/2.5/">2.5</a></div> -->
+ <div class="section-content"><style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="apache-fop-output-formats">Apache™ FOP Output Formats<a class="headerlink" href="#apache-fop-output-formats" title="Permanent link">¶</a></h1>
+<p>Apache™ FOP supports multiple output formats by using a different renderer for each format. The renderers do not all have the same set of capabilities, sometimes because of the output format itself, sometimes because some renderers get more development attention than others.</p>
+<h2 id="general">General Information<a class="headerlink" href="#general" title="Permanent link">¶</a></h2>
+<h3 id="general-fonts">Fonts<a class="headerlink" href="#general-fonts" title="Permanent link">¶</a></h3>
+<p>Most FOP renderers use a FOP-specific system for font registration. However, the Java2D/AWT and print renderers use the Java AWT package, which gets its font information from the operating system registration. This can result in several differences, including actually using different fonts, and having different font metrics for the same font. The net effect is that the layout of a given FO document can be quite different between renderers that do not use the same font information.</p>
+<p>Theoretically, there's some potential to make the output of the PDF/PS renderers match the output of the Java2D-based renderers. If FOP used the font metrics from its own font subsystem but still used Java2D for text painting in the Java2D-based renderers, this could probably be achieved. However, this approach hasn't been implemented, yet.</p>
+<p>With a work-around, it is possible to match the PDF/PS output in a Java2D-based renderer pretty closely. The clue is to use the <a href="intermediate.html">intermediate format</a>. The trick is to layout the document using FOP's own font subsystem but then render the document using Java2D. Here are the necessary steps (using the command-line):</p>
+<ol>
+<li>
+<p>Produce an IF file:</p>
+<ul>
+<li><code>fop -fo myfile.fo -at application/pdf myfile.at.xml</code></li>
+</ul>
+<p>Specifying "application/pdf" for the "<code>-at</code>" parameter causes FOP to use FOP's own font subsystem (which is used by the PDF renderer). Note that no PDF file is created in this step.</p>
+</li>
+<li>
+<p>Render to a PDF file:</p>
+<ul>
+<li><code>fop -atin myfile.at.xml -pdf myfile.pdf</code></li>
+</ul>
+</li>
+<li>
+<p>Render to a Java2D-based renderer:</p>
+<ul>
+<li>
+<p><code>fop -atin myfile.at.xml -print</code></p>
+</li>
+<li>
+<p><code>fop -atin myfile.at.xml -awt</code></p>
+</li>
+<li>
+<p><code>fop -atin myfile.at.xml -tiff myfile.tiff</code></p>
+</li>
+</ul>
+</li>
+</ol>
+<h3 id="general-direct-output">Output to a Printer or Other Device<a class="headerlink" href="#general-direct-output" title="Permanent link">¶</a></h3>
+<p>The most obvious way to print your document is to use the FOP <a href="#print">print renderer</a>, which uses the Java2D API (AWT). However, you can also send output from the Postscript renderer directly to a Postscript device, or output from the PCL renderer directly to a PCL device.</p>
+<p>Here are Windows command-line examples for Postscript and PCL:</p>
+<p><code>fop ... -ps \\computername\printer</code></p>
+<p><code>fop ... -pcl \\computername\printer</code></p>
+<p>Here is some Java code to accomplish the task in UNIX:</p>
+<div class="codehilite"><pre><span class="n">proc</span> <span class="o">=</span> <span class="n">Runtime</span><span class="o">.</span><span class="na">getRuntime</span><span class="o">().</span><span class="na">exec</span><span class="o">(</span><span class="s">"lp -d"</span> <span class="o">+</span> <span class="n">print_queue</span> <span class="o">+</span> <span class="s">" -o -dp -"</span><span class="o">);</span>
+<span class="n">out</span> <span class="o">=</span> <span class="n">proc</span><span class="o">.</span><span class="na">getOutputStream</span><span class="o">();</span>
+</pre></div>
+
+
+<p>Set the output MIME type to "<code>application/x-pcl</code>" (<code>MimeConstants.MIME_PCL</code>) and it happily sends the PCL to the UNIX printer queue.</p>
+<h2 id="pdf">PDF<a class="headerlink" href="#pdf" title="Permanent link">¶</a></h2>
+<p>PDF is the best supported output format. It is also the most accurate with text and layout. This creates a PDF document that is streamed out as each page is rendered. This means that the internal page index information is stored near the end of the document. The PDF version supported is 1.4. PDF versions are forwards/backwards compatible.</p>
+<p>Note that FOP does not currently support PDF/A-1a. Support for <a href="accessibility.html">Tagged PDF</a>, <a href="pdfa.html">PDF/A-1b</a> and <a href="pdfx.html">PDF/X</a> has recently been added, however.</p>
+<h3 id="pdf-fonts">Fonts<a class="headerlink" href="#pdf-fonts" title="Permanent link">¶</a></h3>
+<p>PDF has a set of fonts that are always available to all PDF viewers; to quote from the PDF Specification:</p>
+<p><em>"PDF prescribes a set of 14 standard fonts that can be used without prior definition. These include four faces each of three Latin text typefaces (Courier, Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf Dingbats). These fonts, or suitable substitute fonts with the same metrics, are guaranteed to be available in all PDF viewer applications."</em></p>
+<h3 id="pdf-postprocess">Post-processing<a class="headerlink" href="#pdf-postprocess" title="Permanent link">¶</a></h3>
+<p>FOP does not currently support several desirable PDF features: watermarks and signatures. One workaround is to use Adobe Acrobat (the full version, not the Reader) to process the file manually or with scripting that it supports.</p>
+<p>Another popular post-processing tool is <a href="http://itextpdf.com/">iText</a>, which has tools for adding security features, document properties, watermarks, and many other features to PDF files.
+<warning>Caveat: iText may swallow PDF bookmarks. But Jens Stavnstrup tells us in issue <a href="https://issues.apache.org/jira/browse/FOP-1100">FOP-1100</a> that this doesn't happen if you use iText's PDFStamper.</warning>
+Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now supports <a href="pdfencryption.html">PDF encryption</a>. However the principles for using iText for other PDF features are similar.)</p>
+<div class="codehilite"><pre><span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span> <span class="n">args</span><span class="o">[])</span> <span class="o">{</span>
+ <span class="k">try</span> <span class="o">{</span>
+ <span class="n">ByteArrayOutputStream</span> <span class="n">fopout</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ByteArrayOutputStream</span><span class="o">();</span>
+ <span class="n">FileOutputStream</span> <span class="n">outfile</span> <span class="o">=</span> <span class="k">new</span> <span class="n">FileOutputStream</span><span class="o">(</span><span class="n">args</span><span class="o">[</span><span class="mi">2</span><span class="o">]);</span>
+ <span class="n">FopFactory</span> <span class="n">fopFactory</span> <span class="o">=</span> <span class="n">FopFactory</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="s">"."</span><span class="o">).</span><span class="na">toURI</span><span class="o">());</span>
+ <span class="n">Fop</span> <span class="n">fop</span> <span class="o">=</span> <span class="n">fopFactory</span><span class="o">.</span><span class="na">newFop</span><span class="o">(</span><span class="n">MimeConstants</span><span class="o">.</span><span class="na">MIME_PDF</span><span class="o">,</span> <span class="n">fopout</span><span class="o">);</span>
+
+ <span class="n">Transformer</span> <span class="n">transformer</span> <span class="o">=</span> <span class="n">TransformerFactory</span><span class="o">.</span><span class="na">newInstance</span><span class="o">().</span><span class="na">newTransformer</span><span class="o">(</span>
+ <span class="k">new</span> <span class="nf">StreamSource</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="n">args</span><span class="o">[</span><span class="mi">1</span><span class="o">])));</span>
+ <span class="n">transformer</span><span class="o">.</span><span class="na">transform</span><span class="o">(</span><span class="k">new</span> <span class="n">StreamSource</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="n">args</span><span class="o">[</span><span class="mi">0</span><span class="o">])),</span>
+ <span class="k">new</span> <span class="nf">SAXResult</span><span class="o">(</span><span class="n">fop</span><span class="o">.</span><span class="na">getDefaultHandler</span><span class="o">()));</span>
+ <span class="n">PdfReader</span> <span class="n">reader</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PdfReader</span><span class="o">(</span><span class="n">fopout</span><span class="o">.</span><span class="na">toByteArray</span><span class="o">());</span>
+ <span class="kt">int</span> <span class="n">n</span> <span class="o">=</span> <span class="n">reader</span><span class="o">.</span><span class="na">getNumberOfPages</span><span class="o">();</span>
+ <span class="n">Document</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Document</span><span class="o">(</span><span class="n">reader</span><span class="o">.</span><span class="na">getPageSizeWithRotation</span><span class="o">(</span><span class="mi">1</span><span class="o">));</span>
+ <span class="n">PdfWriter</span> <span class="n">writer</span> <span class="o">=</span> <span class="n">PdfWriter</span><span class="o">.</span><span class="na">getInstance</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="n">outfile</span><span class="o">);</span>
+ <span class="n">writer</span><span class="o">.</span><span class="na">setEncryption</span><span class="o">(</span><span class="n">PdfWriter</span><span class="o">.</span><span class="na">STRENGTH40BITS</span><span class="o">,</span> <span class="s">"pdf"</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span>
+ <span class="n">PdfWriter</span><span class="o">.</span><span class="na">AllowCopy</span><span class="o">);</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">open</span><span class="o">();</span>
+ <span class="n">PdfContentByte</span> <span class="n">cb</span> <span class="o">=</span> <span class="n">writer</span><span class="o">.</span><span class="na">getDirectContent</span><span class="o">();</span>
+ <span class="n">PdfImportedPage</span> <span class="n">page</span><span class="o">;</span>
+ <span class="kt">int</span> <span class="n">rotation</span><span class="o">;</span>
+ <span class="kt">int</span> <span class="n">i</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span>
+ <span class="k">while</span> <span class="o">(</span><span class="n">i</span> <span class="o"><</span> <span class="n">n</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">i</span><span class="o">++;</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">setPageSize</span><span class="o">(</span><span class="n">reader</span><span class="o">.</span><span class="na">getPageSizeWithRotation</span><span class="o">(</span><span class="n">i</span><span class="o">));</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">newPage</span><span class="o">();</span>
+ <span class="n">page</span> <span class="o">=</span> <span class="n">writer</span><span class="o">.</span><span class="na">getImportedPage</span><span class="o">(</span><span class="n">reader</span><span class="o">,</span> <span class="n">i</span><span class="o">);</span>
+ <span class="n">rotation</span> <span class="o">=</span> <span class="n">reader</span><span class="o">.</span><span class="na">getPageRotation</span><span class="o">(</span><span class="n">i</span><span class="o">);</span>
+ <span class="k">if</span> <span class="o">(</span><span class="n">rotation</span> <span class="o">==</span> <span class="mi">90</span> <span class="o">||</span> <span class="n">rotation</span> <span class="o">==</span> <span class="mi">270</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">cb</span><span class="o">.</span><span class="na">addTemplate</span><span class="o">(</span><span class="n">page</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span> <span class="o">-</span><span class="mi">1</span><span class="n">f</span><span class="o">,</span> <span class="mi">1</span><span class="n">f</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span>
+ <span class="n">reader</span><span class="o">.</span><span class="na">getPageSizeWithRotation</span><span class="o">(</span><span class="n">i</span><span class="o">).</span><span class="na">height</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">cb</span><span class="o">.</span><span class="na">addTemplate</span><span class="o">(</span><span class="n">page</span><span class="o">,</span> <span class="mi">1</span><span class="n">f</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span> <span class="mi">1</span><span class="n">f</span><span class="o">,</span> <span class="mi">0</span><span class="o">,</span> <span class="mi">0</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Processed page "</span> <span class="o">+</span> <span class="n">i</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+ <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>Check the iText tutorial and documentation for setting access flags, password, encryption strength and other parameters.</p>
+<h3 id="pdf-watermark">Watermarks<a class="headerlink" href="#pdf-watermark" title="Permanent link">¶</a></h3>
+<p>In addition to the <a href="#pdf-postprocess">PDF Post-processing</a> options, consider the following workarounds:</p>
+<ul>
+<li>
+<p>Use a background image for the body region.</p>
+</li>
+<li>
+<p>(submitted by Trevor Campbell) Place an image in a region that overlaps the flowing text. For example, make region-before large enough to contain your image. Then include a block (if necessary, use an absolutely positioned block-container) containing the watermark image in the static-content for the region-before. Note that the image will be drawn on top of the normal content.</p>
+</li>
+</ul>
+<h3 id="pdf-extensions">Extensions<a class="headerlink" href="#pdf-extensions" title="Permanent link">¶</a></h3>
+<p>The PDF Renderer supports some PDF specific extensions which can be embedded into the input FO document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:</p>
+<div class="codehilite"><pre><span class="nt"><fo:root</span> <span class="na">xmlns:fo=</span><span class="s">"http://www.w3.org/1999/XSL/Format"</span>
+ <span class="na">xmlns:pdf=</span><span class="s">"http://xmlgraphics.apache.org/fop/extensions/pdf"</span><span class="nt">></span>
+</pre></div>
+
+
+<h4 id="pdf-embedded-file">Embedded Files<a class="headerlink" href="#pdf-embedded-file" title="Permanent link">¶</a></h4>
+<p>It is possible to attach/embed arbitrary files into a PDF file. You can give a name and a description of the file. Example:</p>
+<div class="codehilite"><pre><span class="nt"><fo:declarations></span>
+ <span class="nt"><pdf:embedded-file</span> <span class="na">filename=</span><span class="s">"image.jpg"</span> <span class="na">src=</span><span class="s">"url(file:///C:/Temp/myimage.jpg)"</span> <span class="na">description=</span><span class="s">"My image"</span><span class="nt">/></span>
+ <span class="nt"><pdf:embedded-file</span> <span class="na">src=</span><span class="s">"url(file:///C:/Temp/MyTextDoc.odt)"</span><span class="nt">/></span>
+<span class="nt"></fo:declarations></span>
+</pre></div>
+
+
+<p><code>pdf:embedded-file</code> must be a child of <code>fo:declarations</code>. The "src" property is used to reference the file that is to be embedded. This property uses the "uri-specification" datatype from the XSL-FO specification. The "filename" property is optional. If it is missing the filename is automatically set from the URI/IRI of the "src" property. An optional description can also be added to further describe the file attachment.</p>
+<p>It is also possible to reference an embedded file from an <code>fo:basic-link</code>. Use the special "embedded-file:" URI scheme with the filename as single argument after the URI scheme. Example:</p>
+<div class="codehilite"><pre><span class="nt"><fo:basic-link</span> <span class="na">external-destination=</span><span class="s">"url(embedded-file:image.jpg)"</span><span class="nt">></span>Attached Image<span class="nt"></fo:basic-link></span>
+</pre></div>
+
+
+<p>Note: Not all PDF Viewers (including some Acrobat Versions) will open the embedded file when clicking on the link. In that case, the user will have to open he attachment via the separate list of file attachments.</p>
+<h4 id="custom-document-properties">Custom Document Properties<a class="headerlink" href="#custom-document-properties" title="Permanent link">¶</a></h4>
+<p>In Adobe Reader (and possibly other PDF viewers), in the Document Properties window,
+there is a tab that shows custom properties that have been set on the document:<br />
+<img alt="PDF Custom Document Properties" src="images/pdf-custom-document-properties.png" /></p>
+<p>Such properties are stored in the PDF in the form of additional key/value pairs in the
+<em>Document Information Dictionary</em> (the Info dictionary). They can be set in the
+FO document using the <code>pdf:info</code> extension element as a child of <code>fo:declarations</code>:</p>
+<div class="codehilite"><pre><span class="nt"><fo:declarations></span>
+ <span class="nt"><pdf:info</span> <span class="na">xmlns:pdf=</span><span class="s">"http://xmlgraphics.apache.org/fop/extensions/pdf"</span><span class="nt">></span>
+ <span class="nt"><pdf:name</span> <span class="na">key=</span><span class="s">"MyCustomProperty"</span><span class="nt">></span>MyPropertyValue<span class="nt"></pdf:name></span>
+ <span class="nt"></pdf:info></span>
+<span class="nt"></fo:declarations></span>
+</pre></div>
+
+
+<p>Each custom property must be specified using the <code>pdf:name</code> element. Remember that the property name must be different to the reserved keywords, which are Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate and Trapped.</p>
+<h4 id="pdf-linearization">PDF Linearization<a class="headerlink" href="#pdf-linearization" title="Permanent link">¶</a></h4>
+<p>Linearization is helpful to allow viewing of a pdf over a slow connection. Needs to be enabled using fop.xconf:</p>
+<div class="codehilite"><pre><span class="nt"><fop</span> <span class="na">version=</span><span class="s">"1.0"</span><span class="nt">></span>
+ <span class="nt"><renderers></span>
+ <span class="nt"><renderer</span> <span class="na">mime=</span><span class="s">"application/pdf"</span><span class="nt">></span>
+ <span class="nt"><linearization></span>true<span class="nt"></linearization></span>
+ <span class="nt"></renderer></span>
+ <span class="nt"></renderers></span>
+<span class="nt"></fop></span>
+</pre></div>
+
+
+<h2 id="ps">PostScript<a class="headerlink" href="#ps" title="Permanent link">¶</a></h2>
+<p>The PostScript renderer has been brought up to a similar quality as the PDF renderer, but may still be missing certain features. Currently, the PostScript renderer generates PostScript Level 3 with most DSC comments. Actually, the only Level 3 features used are the FlateDecode and DCTDecode filter (the latter is used for 1:1 embedding of JPEG images), everything else is Level 2.</p>
+<h3 id="ps-configuration">Configuration<a class="headerlink" href="#ps-configuration" title="Permanent link">¶</a></h3>
+<p>The PostScript renderer configuration currently allows the following settings:</p>
+<div class="codehilite"><pre><span class="nt"><renderer</span> <span class="na">mime=</span><span class="s">"application/postscript"</span><span class="nt">></span>
+ <span class="nt"><auto-rotate-landscape></span>false<span class="nt"></auto-rotate-landscape></span>
+ <span class="nt"><language-level></span>3<span class="nt"></language-level></span>
+ <span class="nt"><optimize-resources></span>false<span class="nt"></optimize-resources></span>
+ <span class="nt"><safe-set-page-device></span>false<span class="nt"></safe-set-page-device></span>
+ <span class="nt"><dsc-compliant></span>true<span class="nt"></dsc-compliant></span>
+ <span class="nt"><rendering></span>quality<span class="nt"></rendering></span>
+ <span class="nt"><acrobat-downsample></span>true<span class="nt"></acrobat-downsample></span>
+<span class="nt"></renderer></span>
+</pre></div>
+
+
+<p>The default value for the "auto-rotate-landscape" setting is "false". Setting it to "true" will automatically rotate landscape pages and will mark them as landscape.</p>
+<p>The default value for the "language-level" setting is "3". This setting specifies the PostScript language level which should be used by FOP. Set this to "2" only if you don't have a Level 3 capable interpreter.</p>
+<p>The default value for the "optimize-resources" setting is "false". Setting it to "true" will produce the PostScript file in two steps. A temporary file will be written first which will then be processed to add only the fonts which were really used and images are added to the stream only once as PostScript forms. This will reduce file size but can potentially increase the memory needed in the interpreter to process.</p>
+<p>The default value for the "safe-set-page-device" setting is "false". Setting it to "true" will cause the renderer to invoke a postscript macro which guards against the possibility of invalid/unsupported postscript key/values being issued to the implementing postscript page device.</p>
+<p>The default value for the "dsc-compliant" setting is "true". Setting it to "false" will break DSC compliance by minimizing the number of setpagedevice calls in the postscript document output. This feature may be useful when unwanted blank pages are experienced in your postscript output. This problem is caused by the particular postscript implementation issuing unwanted postscript subsystem initgraphics/erasepage calls on each setpagedevice call.</p>
+<p>The default value for the "rendering" setting is "quality". Setting it to "size" optimizes rendering for smaller file sizes which can involve minor compromises in rendering quality. For example, solid borders are then painted as plain rectangles instead of the elaborate painting instructions required for mixed-color borders.</p>
+<p>The default value for the "acrobat-downsample" setting is "false". Setting it to "true" can involve minor compromises in rendering quality to allow compatibility with Adobe Acrobat.</p>
+<h3 id="ps-limitations">Limitations<a class="headerlink" href="#ps-limitations" title="Permanent link">¶</a></h3>
+<ul>
+<li>
+<p>No image transparency is available.</p>
+</li>
+<li>
+<p>PPD support is still missing.</p>
+</li>
+</ul>
+<h2 id="pcl">PCL<a class="headerlink" href="#pcl" title="Permanent link">¶</a></h2>
+<p>This format is for the Hewlett-Packard PCL printers and other printers supporting PCL. It should produce output as close to identical as possible to the printed output of the PDFRenderer within the limitations of the renderer, and output device.</p>
+<p>The output created by the PCLRenderer is generic PCL 5, HP GL/2 and PJL. This should allow any device fully supporting PCL 5 to be able to print the output generated by the PCLRenderer. PJL is used to control the print job and switch to the PCL language. PCL 5 is used for text, raster graphics and rectangular fill graphics. HP GL/2 is used for more complex painting operations. Certain painting operations are done off-screen and rendered to PCL as bitmaps because of limitations in PCL 5.</p>
+<p>Truetype fonts can be embedded, other font formats will be rendered as bitmaps.</p>
+<h3 id="pcl-references">References<a class="headerlink" href="#pcl-references" title="Permanent link">¶</a></h3>
+<ul>
+<li>
+<p><a href="http://en.wikipedia.org/wiki/Printer_Control_Language">WikiPedia entry on PCL</a></p>
+</li>
+<li>
+<p><a href="http://www.hp.com/ctg/Manual/bpl13210.pdf">Technical reference documents on PCL from Hewlett-Packard</a></p>
+</li>
+</ul>
+<h3 id="pcl-limitations">Limitations<a class="headerlink" href="#pcl-limitations" title="Permanent link">¶</a></h3>
+<ul>
+<li>
+<p>Text or graphics outside the left or top of the printable area are not rendered properly. This is a limitation of PCL, not FOP. In general, things that should print to the left of the printable area are shifted to the right so that they start at the left edge of the printable area.</p>
+</li>
+<li>
+<p>The Helvetica and Times fonts are not well supported among PCL printers so Helvetica is mapped to Arial and Times is mapped to Times New. This is done in the PCLRenderer, no changes are required in the FO's. The metrics and appearance for Helvetica/Arial and Times/Times New are nearly identical, so this has not been a problem so far.</p>
+</li>
+<li>
+<p>For the non-symbol fonts, the ISO 8859-1 symbol set is used (PCL set "0N").</p>
+</li>
+<li>
+<p>All fonts available to the Java2D subsystem are usable. The texts are painted as bitmap much like the Windows PCL drivers do.</p>
+</li>
+<li>
+<p>Multibyte characters are not supported.</p>
+</li>
+<li>
+<p>Monochrome output is the default, color needs to be enabled in config. PCL5c color extensions will only be implemented on demand. By default color and grayscale images are converted to monochrome bitmaps (1-bit). Dithering only occurs if the JAI image library is available.</p>
+</li>
+<li>
+<p>Images are scaled up to the next resolution level supported by PCL (75, 100, 150, 200, 300, 600 dpi). For color and grayscale images an even higher PCL resolution is selected to give the dithering algorithm a chance to improve the bitmap quality.</p>
+</li>
+<li>
+<p>Currently, there's no support for clipping and image transparency, largely because PCL 5 has certain limitations.</p>
+</li>
+</ul>
+<h3 id="pcl-configuration">Configuration<a class="headerlink" href="#pcl-configuration" title="Permanent link">¶</a></h3>
+<p>The PCL renderer configuration currently allows the following settings:</p>
+<div class="codehilite"><pre><span class="nt"><renderer</span> <span class="na">mime=</span><span class="s">"application/x-pcl"</span><span class="nt">></span>
+ <span class="nt"><rendering></span>quality<span class="nt"></rendering></span>
+ <span class="nt"><text-rendering></span>bitmap<span class="nt"></text-rendering></span>
+ <span class="nt"><disable-pjl></span>false<span class="nt"></disable-pjl></span>
+ <span class="nt"><images</span> <span class="na">mode=</span><span class="s">"color"</span><span class="nt">/></span>
+<span class="nt"></renderer></span>
+</pre></div>
+
+
+<p>The default value for the "rendering" setting is "speed" which causes borders to be painted as plain rectangles. In this mode, no special borders (dotted, dashed etc.) are available. If you want support for all border modes, set the value to "quality" as indicated above. This will cause the borders to be painted as bitmaps.</p>
+<p>The default value for the "text-rendering" setting is "auto" which paints the base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. If the mix of painting methods results in unwelcome output, you can set this to "bitmap" which causes all text to be rendered as bitmaps.</p>
+<p>The default value for the "disable-pjl" setting is "false". This means that the PCL renderer usually generates PJL commands before and after the document in order to switch a printer into PCL language. PJL commands can be disabled if you set this value to "true".</p>
+<p>The default value for "image" mode is monochrome output, use "mode" equals "color" to enable color output.</p>
+<p>You can control the output resolution for the PCL using the "target resolution" setting on the FOUserAgent. The actual value will be rounded up to the next supported PCL resolution. Currently, only 300 and 600 dpi are supported which should be enough for most use cases. Note that this setting directly affects the size of the output file and the print quality.</p>
+<h3 id="pcl-extensions">Extensions<a class="headerlink" href="#pcl-extensions" title="Permanent link">¶</a></h3>
+<p>The PCL Renderer supports some PCL specific extensions which can be embedded into the input FO document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:</p>
+<div class="codehilite"><pre><span class="nt"><fo:root</span> <span class="na">xmlns:fo=</span><span class="s">"http://www.w3.org/1999/XSL/Format"</span>
+ <span class="na">xmlns:pcl=</span><span class="s">"http://xmlgraphics.apache.org/fop/extensions/pcl"</span><span class="nt">></span>
+</pre></div>
+
+
+<h4 id="pcl-page-source">Page Source (Tray selection)<a class="headerlink" href="#pcl-page-source" title="Permanent link">¶</a></h4>
+<p>The page-source extension attribute on fo:simple-page-master allows to select the paper tray the sheet for a particular simple-page-master is to be taken from. Example:</p>
+<div class="codehilite"><pre><span class="nt"><fo:layout-master-set></span>
+ <span class="nt"><fo:simple-page-master</span> <span class="na">master-name=</span><span class="s">"simple"</span> <span class="na">pcl:paper-source=</span><span class="s">"2"</span><span class="nt">></span>
+ ...
+ <span class="nt"></fo:simple-page-master></span>
+<span class="nt"></fo:layout-master-set></span>
+</pre></div>
+
+
+<p>Note: the tray number is a positive integer and the value depends on the target printer. Not all PCL printers support the same paper trays. Usually, "1" is the default tray, "2" is the manual paper feed, "3" is the manual envelope feed, "4" is the "lower" tray and "7" is "auto-select". Consult the technical reference for your printer for all available values.</p>
+<h4 id="pcl-output-bin">Output Bin<a class="headerlink" href="#pcl-output-bin" title="Permanent link">¶</a></h4>
+<p>The <code>output-bin</code> extension attribute on fo:simple-page-master allows to select the output bin into which the printed output should be fed. Example:</p>
+<div class="codehilite"><pre><span class="nt"><fo:layout-master-set></span>
+ <span class="nt"><fo:simple-page-master</span> <span class="na">master-name=</span><span class="s">"simple"</span> <span class="na">pcl:output-bin=</span><span class="s">"2"</span><span class="nt">></span>
+ ...
+ <span class="nt"></fo:simple-page-master></span>
+<span class="nt"></fo:layout-master-set></span>
+</pre></div>
+
+
+<p>Note: the output bin number is a positive integer and the value depends on the target printer. Not all PCL printers support the same output bins. Usually, "1" is the upper output bin, "2" is the lower (rear) output bin. Consult the technical reference for your printer for all available values.</p>
+<h4 id="pcl-duplex-mode">Page Duplex Mode<a class="headerlink" href="#pcl-duplex-mode" title="Permanent link">¶</a></h4>
+<p>The duplex-mode extension attribute on fo:simple-page-master allows to select the duplex mode to be used for a particular simple-page-master. Example:</p>
+<div class="codehilite"><pre><span class="nt"><fo:layout-master-set></span>
+ <span class="nt"><fo:simple-page-master</span> <span class="na">master-name=</span><span class="s">"simple"</span> <span class="na">pcl:duplex-mode=</span><span class="s">"0"</span><span class="nt">></span>
+ ...
+ <span class="nt"></fo:simple-page-master></span>
+<span class="nt"></fo:layout-master-set></span>
+</pre></div>
+
+
+<p>Note: the duplex is a positive integer and the value depends on the target printer. Not all PCL printers support duplexing. Usually, "0" is simplex, "1" is duplex (long-edge binding), "2" is duplex (short-edge binding). Consult the technical reference for your printer for all available values.</p>
+<h2 id="afp">AFP<a class="headerlink" href="#afp" title="Permanent link">¶</a></h2>
+<p>The FOP AFP Renderer deals with creating documents conforming to the IBM AFP document architecture also refered to as MO:DCA (Mixed Object Document Content Architecture).</p>
+<p>The mapping of XSL-FO elements to the major MO:DCA structures is as follows:</p>
+<table class="table">
+<thead>
+<tr>
+<th>XSL-FO element</th>
+<th>MO:DCA-P object</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>fo:root</td>
+<td>Document</td>
+</tr>
+<tr>
+<td>fo:page-sequence</td>
+<td>Page Group</td>
+</tr>
+<tr>
+<td>fo:simple-page-master</td>
+<td>Page</td>
+</tr>
+</tbody>
+</table>
+<p>FOP creates exactly one Document per Printfile with an optional Resource Group at the beginning. FOP does not create document indices.</p>
+<h3 id="afp-references">References<a class="headerlink" href="#afp-references" title="Permanent link">¶</a></h3>
+<ul>
+<li>
+<p><a href="http://en.wikipedia.org/wiki/Advanced_Function_Presentation">AFP (Advanced Function Presentation)</a></p>
+</li>
+<li>
+<p><a href="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/AFPResources">AFP Resources on the FOP WIKI</a></p>
+</li>
+<li>
+<p><a href="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/AFPOutput">Technical notes on AFP output in FOP</a></p>
+</li>
+</ul>
+<h3 id="afp-limitations">Limitations<a class="headerlink" href="#afp-limitations" title="Permanent link">¶</a></h3>
+<p>This list is most likely badly incomplete.</p>
+<ul>
+<li>
+<p>Clipping of text and graphics is not supported.</p>
+</li>
+<li>
+<p>TrueType, IBM outline, raster fonts and to a limited extend the original fonts built into FOP are supported.</p>
+</li>
+</ul>
+<h3 id="afp-compatibility">Deployment in older environments<a class="headerlink" href="#afp-compatibility" title="Permanent link">¶</a></h3>
+<p>There are still a big number of older (or limited) MO:DCA/IPDS environments in production out there. AFP has grown in functionality over time and not every environment supports the latest features. We're trying to make AFP output work in as many environments as possible. However, to make AFP output work on older environments it is recommended to set to configuration to 1 bit per pixel (see below on how to do this). In this case, all images are converted to bi-level images using IOCA function set 10 (FS10) and are enclosed in page-segments since some implementation cannot deal with IOCA objects directly. If a higher number of bits per pixel is configured, FOP has to switch to at least FS11 which may not work everywhere.</p>
+<h3 id="afp-configuration">Configuration<a class="headerlink" href="#afp-configuration" title="Permanent link">¶</a></h3>
+<h4 id="afp-font-config">Fonts<a class="headerlink" href="#afp-font-config" title="Permanent link">¶</a></h4>
+<p>The AFP Renderer requires special configuration particularly related to fonts. AFP Render configuration is done through the normal FOP configuration file. The MIME type for the AFP Renderer is application/x-afp which means the AFP Renderer section in the FOP configuration file looks like:</p>
+<div class="codehilite"><pre><span class="nt"><renderer</span> <span class="na">mime=</span><span class="s">"application/x-afp"</span><span class="nt">></span>
+ <span class="c"><!-- AFP Renderer --></span>
+ ...
+<span class="nt"></renderer></span>
+</pre></div>
+
+
+<p>There are 5 font configuration variants supported:</p>
+<ol>
+<li>
+<p>TrueType fonts</p>
+</li>
+<li>
+<p>IBM Raster fonts</p>
+</li>
+<li>
+<p>IBM Outline fonts</p>
+</li>
+<li>
+<p>IBM CID-keyed (Type 0) fonts</p>
+</li>
+<li>
+<p>FOP built-in Base14 fonts</p>
+</li>
+</ol>
+<p>TrueType font configuration looks like:</p>
+<div class="codehilite"><pre><span class="nt"><font</span> <span class="na">kerning=</span><span class="s">"yes"</span> <span class="na">embed-url=</span><span class="s">"fonts/Uvb_____.TTF"</span> <span class="na">name=</span><span class="s">"Univers"</span><span class="nt">></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Univers"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+</pre></div>
+
+
+<p>A typical raster font configuration looks like:</p>
+<div class="codehilite"><pre><span class="c"><!-- This is an example of mapping actual IBM raster fonts / code pages to a FOP font --></span>
+<span class="nt"><font></span>
+<span class="c"><!-- The afp-font element defines the IBM code page, the matching Java encoding and the</span>
+<span class="c"> base URI for the font --></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"raster"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">base-uri=</span><span class="s">"fonts/ibm/"</span><span class="nt">></span>
+ <span class="c"><!-- For a raster font a separate element for each font size is required providing</span>
+<span class="c"> the font size and the corresponding IBM Character set name --></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"7"</span> <span class="na">characterset=</span><span class="s">"C0N20070"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"8"</span> <span class="na">characterset=</span><span class="s">"C0N20080"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"10"</span> <span class="na">characterset=</span><span class="s">"C0N20000"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"11"</span> <span class="na">characterset=</span><span class="s">"C0N200A0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"12"</span> <span class="na">characterset=</span><span class="s">"C0N200B0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"14"</span> <span class="na">characterset=</span><span class="s">"C0N200D0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"16"</span> <span class="na">characterset=</span><span class="s">"C0N200F0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"18"</span> <span class="na">characterset=</span><span class="s">"C0N200H0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"20"</span> <span class="na">characterset=</span><span class="s">"C0N200J0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"24"</span> <span class="na">characterset=</span><span class="s">"C0N200N0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"30"</span> <span class="na">characterset=</span><span class="s">"C0N200T0"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"36"</span> <span class="na">characterset=</span><span class="s">"C0N200Z0"</span><span class="nt">/></span>
+ <span class="nt"></afp-font></span>
+ <span class="c"><!-- These are the usual FOP font triplets as they apply to this font --></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"serif"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Times"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Times-Roman"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"TimesNewRoman"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+</pre></div>
+
+
+<p>An outline font configuration is simpler as the individual font size entries are not required. However, the characterset definition is now required within the afp-font element.</p>
+<div class="codehilite"><pre><span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZH200 "</span>
+ <span class="na">base-uri=</span><span class="s">"file:/fonts/ibm"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"sans-serif"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Helvetica"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+</pre></div>
+
+
+<p>If "base-uri" is missing or a relative URI, the fonts are resolved relative to the font base URI specified in the configuration (or on the FopFactory).</p>
+<p><note>Previously, the location of the font files was given by the "path" attribute. This is still supported for the time being, but you should move to using the more flexible "base-uri" attribute so you can profit from the power of URI resolvers.</note></p>
+<p>A CID-keyed font (Type 0, double-byte outline font) configuration is much the same as an outline font. However, the characterset definition is now required within the afp-font element.</p>
+<div class="codehilite"><pre><span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"CIDKeyed"</span> <span class="na">characterset=</span><span class="s">"CZJHMNU"</span>
+ <span class="na">codepage=</span><span class="s">"T1120000"</span> <span class="na">encoding=</span><span class="s">"UnicodeBigUnmarked"</span>
+ <span class="na">base-uri=</span><span class="s">"file:/fonts/ibm"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"J-Heisei Mincho"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span> <span class="nt">/></span>
+<span class="nt"></font></span>
+</pre></div>
+
+
+<p>Note that the value of the encoding attribute in the example is the double-byte encoding 'UnicodeBigUnmarked' (UTF-16BE).</p>
+<p>Experimentation has shown that the font metrics for the FOP built-in Base14 fonts are actually very similar to some of the IBM outline and raster fonts. In cases were the IBM font files are not available the base-uri attribute in the afp-font element can be replaced by a base14-font attribute giving the name of the matching Base14 font. In this case the AFP Renderer will take the font metrics from the built-in font.</p>
+<div class="codehilite"><pre><span class="c"><!-- The following are examples of defining outline fonts based on FOP built-in</span>
+<span class="c"> font metrics for the Adobe Base14 fonts --></span>
+<span class="c"><!-- sans-serif fonts based on Helvetica --></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZH200 "</span>
+ <span class="na">base14-font=</span><span class="s">"Helvetica"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"sans-serif"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Helvetica"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZH300 "</span>
+ <span class="na">base14-font=</span><span class="s">"HelveticaOblique"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"sans-serif"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Helvetica"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZH400 "</span>
+ <span class="na">base14-font=</span><span class="s">"HelveticaBold"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"sans-serif"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Helvetica"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZH500 "</span>
+ <span class="na">base14-font=</span><span class="s">"HelveticaBoldOblique"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"sans-serif"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Helvetica"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"any"</span> <span class="na">style=</span><span class="s">"italic"</span> <span class="na">weight=</span><span class="s">"bold"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+
+<span class="c"><!-- serif fonts based on Times Roman --></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"outline"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span> <span class="na">characterset=</span><span class="s">"CZN200 "</span>
+ <span class="na">base14-font=</span><span class="s">"TimesRoman"</span> <span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"serif"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Times"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Times-Roman"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+
+<span class="c"><!-- The following are examples of defining raster fonts based on FOP built-in</span>
+<span class="c"> font metrics for the Adobe Base14 fonts --></span>
+<span class="c"><!-- monospaced fonts based on Courier --></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"raster"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span><span class="nt">></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"7"</span> <span class="na">characterset=</span><span class="s">"C0420070"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"8"</span> <span class="na">characterset=</span><span class="s">"C0420080"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"10"</span> <span class="na">characterset=</span><span class="s">"C0420000"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"12"</span> <span class="na">characterset=</span><span class="s">"C04200B0"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"14"</span> <span class="na">characterset=</span><span class="s">"C04200D0"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"20"</span> <span class="na">characterset=</span><span class="s">"C04200J0"</span> <span class="na">base14-font=</span><span class="s">"Courier"</span><span class="nt">/></span>
+ <span class="nt"></afp-font></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"monospace"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+ <span class="nt"><font-triplet</span> <span class="na">name=</span><span class="s">"Courier"</span> <span class="na">style=</span><span class="s">"normal"</span> <span class="na">weight=</span><span class="s">"normal"</span><span class="nt">/></span>
+<span class="nt"></font></span>
+<span class="nt"><font></span>
+ <span class="nt"><afp-font</span> <span class="na">type=</span><span class="s">"raster"</span> <span class="na">codepage=</span><span class="s">"T1V10500"</span> <span class="na">encoding=</span><span class="s">"Cp500"</span><span class="nt">></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"7"</span> <span class="na">characterset=</span><span class="s">"C0440070"</span> <span class="na">base14-font=</span><span class="s">"CourierBold"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"8"</span> <span class="na">characterset=</span><span class="s">"C0440080"</span> <span class="na">base14-font=</span><span class="s">"CourierBold"</span><span class="nt">/></span>
+ <span class="nt"><afp-raster-font</span> <span class="na">size=</span><span class="s">"10"</span> <span class="na">characterset=</span><span class="s">"C0440000"</span> <span class="na">base14-font=</span><span class="s">"CourierBold"</span><span class="nt">/></span>
[... 421 lines stripped ...]
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org