You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlgraphics.apache.org by sp...@apache.org on 2011/08/23 15:51:42 UTC
svn commit: r1160690 [35/39] - in /xmlgraphics/site/deploy/fop: ./ 0.95/
1.0/ dev/ dev/design/ dev/svg/ skin/images/ trunk/
Modified: xmlgraphics/site/deploy/fop/trunk/output.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/output.html?rev=1160690&r1=1160689&r2=1160690&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/output.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/output.html Tue Aug 23 13:51:33 2011
@@ -11,7 +11,7 @@
<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
<link type="text/css" href="../skin/profile.css" rel="stylesheet">
<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
-<link rel="shortcut icon" href="../">
+<link rel="shortcut icon" href="../favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
@@ -92,7 +92,7 @@ document.write("Last Published: " + docu
|breadtrail
+-->
<div class="breadtrail">
-<a href="http://www.apache.org/">apache.org</a> > <a href="http://xml.apache.org/">XML Federation</a> > <a href="http://xmlgraphics.apache.org/">xmlgraphics.apache.org</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+<a href="http://www.apache.org/">The Apache Software Foundation</a> > <a href="http://xmlgraphics.apache.org/">Apache XML Graphics Project</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|start Menu, mainarea
@@ -176,7 +176,9 @@ document.write("Last Published: " + docu
<!--+
|alternative credits
+-->
-<div id="credit2"></div>
+<div id="credit2">
+<a href="http://www.apachecon.com/"><img border="0" title="ApacheCon NA 2011" alt="ApacheCon NA 2011 - logo" src="http://apache.org/ads/ApacheCon/2011-na-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
</div>
<!--+
|end Menu
@@ -298,6 +300,9 @@ document.write("Last Published: " + docu
<a href="#afp-image-config">Images</a>
</li>
<li>
+<a href="#afp-goca-config">GOCA (Vector Graphics)</a>
+</li>
+<li>
<a href="#afp-shading-config">Shading</a>
</li>
<li>
@@ -674,6 +679,7 @@ out = proc.getOutputStream();</pre>
<optimize-resources>false</optimize-resources>
<safe-set-page-device>false</safe-set-page-device>
<dsc-compliant>true</dsc-compliant>
+ <rendering>quality</rendering>
</renderer></pre>
<p>
The default value for the "auto-rotate-landscape" setting is "false". Setting it
@@ -706,7 +712,13 @@ out = proc.getOutputStream();</pre>
the particular postscript implementation issuing unwanted postscript subsystem
initgraphics/erasepage calls on each setpagedevice call.
</p>
-<a name="N1013A"></a><a name="ps-limitations"></a>
+<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>
+<a name="N1013D"></a><a name="ps-limitations"></a>
<h3 class="underlined_5">Limitations</h3>
<ul>
@@ -721,7 +733,7 @@ out = proc.getOutputStream();</pre>
</ul>
</div>
-<a name="N10151"></a><a name="pcl"></a>
+<a name="N10154"></a><a name="pcl"></a>
<h2 class="underlined_10">PCL</h2>
<div class="section">
<p>
@@ -739,7 +751,7 @@ out = proc.getOutputStream();</pre>
painting operations. Certain painting operations are done off-screen and
rendered to PCL as bitmaps because of limitations in PCL 5.
</p>
-<a name="N1015D"></a><a name="pcl-references"></a>
+<a name="N10160"></a><a name="pcl-references"></a>
<h3 class="underlined_5">References</h3>
<ul>
@@ -752,7 +764,7 @@ out = proc.getOutputStream();</pre>
</li>
</ul>
-<a name="N10171"></a><a name="pcl-limitations"></a>
+<a name="N10174"></a><a name="pcl-limitations"></a>
<h3 class="underlined_5">Limitations</h3>
<ul>
@@ -800,7 +812,7 @@ out = proc.getOutputStream();</pre>
</li>
</ul>
-<a name="N10193"></a><a name="pcl-configuration"></a>
+<a name="N10196"></a><a name="pcl-configuration"></a>
<h3 class="underlined_5">Configuration</h3>
<p>
The PCL renderer configuration currently allows the following settings:
@@ -836,7 +848,7 @@ out = proc.getOutputStream();</pre>
should be enough for most use cases. Note that this setting directly affects
the size of the output file and the print quality.
</p>
-<a name="N101AD"></a><a name="pcl-extensions"></a>
+<a name="N101B0"></a><a name="pcl-extensions"></a>
<h3 class="underlined_5">Extensions</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
@@ -845,7 +857,7 @@ out = proc.getOutputStream();</pre>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
xmlns:pcl="http://xmlgraphics.apache.org/fop/extensions/pcl">
</pre>
-<a name="N101BA"></a><a name="pcl-page-source"></a>
+<a name="N101BD"></a><a name="pcl-page-source"></a>
<h4>Page Source (Tray selection)</h4>
<p>
The page-source extension attribute on fo:simple-page-master allows to
@@ -870,7 +882,7 @@ out = proc.getOutputStream();</pre>
"7" is "auto-select".
Consult the technical reference for your printer for all available values.
</p>
-<a name="N101CB"></a><a name="pcl-output-bin"></a>
+<a name="N101CE"></a><a name="pcl-output-bin"></a>
<h4>Output Bin</h4>
<p>
The <span class="codefrag">output-bin</span> extension attribute on fo:simple-page-master allows to
@@ -891,7 +903,7 @@ out = proc.getOutputStream();</pre>
"2" is the lower (rear) output bin.
Consult the technical reference for your printer for all available values.
</p>
-<a name="N101DF"></a><a name="pcl-duplex-mode"></a>
+<a name="N101E2"></a><a name="pcl-duplex-mode"></a>
<h4>Page Duplex Mode</h4>
<p>
The duplex-mode extension attribute on fo:simple-page-master allows to
@@ -917,7 +929,7 @@ out = proc.getOutputStream();</pre>
</p>
</div>
-<a name="N101F2"></a><a name="afp"></a>
+<a name="N101F5"></a><a name="afp"></a>
<h2 class="underlined_10">AFP</h2>
<div class="section">
<p>
@@ -962,7 +974,7 @@ out = proc.getOutputStream();</pre>
FOP creates exactly one Document per Printfile with an optional Resource Group at the
beginning. FOP does not create document indices.
</p>
-<a name="N10238"></a><a name="afp-references"></a>
+<a name="N1023B"></a><a name="afp-references"></a>
<h3 class="underlined_5">References</h3>
<ul>
@@ -979,7 +991,7 @@ out = proc.getOutputStream();</pre>
</li>
</ul>
-<a name="N10251"></a><a name="afp-limitations"></a>
+<a name="N10254"></a><a name="afp-limitations"></a>
<h3 class="underlined_5">Limitations</h3>
<p>This list is most likely badly incomplete.</p>
<ul>
@@ -994,7 +1006,7 @@ out = proc.getOutputStream();</pre>
</li>
</ul>
-<a name="N10264"></a><a name="afp-compatibility"></a>
+<a name="N10267"></a><a name="afp-compatibility"></a>
<h3 class="underlined_5">Deployment in older environments</h3>
<p>
There are still a big number of older (or limited) MO:DCA/IPDS environments in production
@@ -1007,9 +1019,9 @@ out = proc.getOutputStream();</pre>
If a higher number of bits per pixel is configured, FOP has to switch to at least FS11
which may not work everywhere.
</p>
-<a name="N1026E"></a><a name="afp-configuration"></a>
+<a name="N10271"></a><a name="afp-configuration"></a>
<h3 class="underlined_5">Configuration</h3>
-<a name="N10274"></a><a name="afp-font-config"></a>
+<a name="N10277"></a><a name="afp-font-config"></a>
<h4>Fonts</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
@@ -1170,13 +1182,13 @@ Note that the value of the encoding attr
<a href="fonts.html#embedding"><span class="codefrag">referenced-fonts</span> section of the configuration file</a>.
However, the default fonts shown above will not be embedded.
</p>
-<a name="N102C2"></a><a name="afp-renderer-resolution-config"></a>
+<a name="N102C5"></a><a name="afp-renderer-resolution-config"></a>
<h4>Output Resolution</h4>
<p>By default the AFP Renderer creates output with a resolution of 240 dpi.
This can be overridden by the <renderer-resolution/> configuration element. Example:</p>
<pre class="code">
<renderer-resolution>240</renderer-resolution></pre>
-<a name="N102D0"></a><a name="afp-image-config"></a>
+<a name="N102D3"></a><a name="afp-image-config"></a>
<h4>Images</h4>
<p>By default the AFP Renderer converts all images to 8 bit grey level.
This can be overridden by the <images/> configuration element. Example:</p>
@@ -1215,7 +1227,29 @@ Note that the value of the encoding attr
</p>
<pre class="code">
<images mode="b+w" bits-per-pixel="1" dithering-quality="maximum"/></pre>
-<a name="N10306"></a><a name="afp-shading-config"></a>
+<a name="N10309"></a><a name="afp-goca-config"></a>
+<h4>GOCA (Vector Graphics)</h4>
+<p>
+ Not all AFP implementations support GOCA. Some also have bugs related to GOCA. Therefore,
+ it is desirable to have some control over the generation of GOCA graphics.
+ </p>
+<p>
+ GOCA is enabled by default. You can disable GOCA entirely in which case the AFP support
+ falls back to generating bitmaps for vector graphics. Example:
+ </p>
+<pre class="code">
+ <goca enabled="false"/></pre>
+<p>
+ Some AFP implementations have trouble rendering text in GOCA. You can instruct the AFP
+ support to render text as shapes (i.e. use vector graphics to paint text). Example:
+ </p>
+<pre class="code">
+ <goca enabled="true" text="shapes"/></pre>
+<p>
+ If you disable GOCA or let text render as shapes, the size of the generated AFP usually
+ increases considerably.
+ </p>
+<a name="N10324"></a><a name="afp-shading-config"></a>
<h4>Shading</h4>
<p>
By default, filled rectangles are painted using their given color using a PTOCA I-axis rule
@@ -1228,7 +1262,7 @@ Note that the value of the encoding attr
<pre class="code">
<shading>dithered</shading>
</pre>
-<a name="N10314"></a><a name="afp-resource-group-file"></a>
+<a name="N10332"></a><a name="afp-resource-group-file"></a>
<h4>Resource Group File</h4>
<p>By default the AFP Renderer will place all data resource objects such as images within
the document of the main output datastream. An external resource group file where document resources
@@ -1240,7 +1274,7 @@ Note that the value of the encoding attr
<div class="label">Note</div>
<div class="content">Be careful when using this option not to overwrite existing resource files from previous rendering runs.</div>
</div>
-<a name="N10325"></a><a name="afp-resource-level-defaults"></a>
+<a name="N10343"></a><a name="afp-resource-level-defaults"></a>
<h4>Resource Level Defaults</h4>
<p>
By default, bitmap image objects (or page segments derived from them) are put in the
@@ -1259,7 +1293,7 @@ Note that the value of the encoding attr
for the attributes are "inline" and "print-file". In the future,
additional possibilities may be added.
</p>
-<a name="N1033E"></a><a name="afp-extensions"></a>
+<a name="N1035C"></a><a name="afp-extensions"></a>
<h3 class="underlined_5">Extensions</h3>
<p>The AFP Renderer supports some AFP 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>
@@ -1267,7 +1301,7 @@ Note that the value of the encoding attr
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
xmlns:afp="http://xmlgraphics.apache.org/fop/extensions/afp">
</pre>
-<a name="N1034B"></a><a name="afp-page-overlay"></a>
+<a name="N10369"></a><a name="afp-page-overlay"></a>
<h4>Page Overlay (IPO) Extension</h4>
<p>The include-page-overlay extension element allows to define on a per simple-page-master basis a page overlay resource. Example:</p>
<pre class="code">
@@ -1281,7 +1315,7 @@ Note that the value of the encoding attr
<p>The mandatory name attribute must refer to an 8 character (space padded) resource name that
must be known in the AFP processing environment. Optional x and y attributes can be specified
to place the Overlay at an offset from the top left of the page.</p>
-<a name="N1035C"></a><a name="afp-page-segment"></a>
+<a name="N1037A"></a><a name="afp-page-segment"></a>
<h4>Page Segment (IPS) Extension</h4>
<p>The include-page-segment extension element allows to define resource substitution for fo:external-graphics elements.
Example:</p>
@@ -1321,7 +1355,7 @@ Note that the value of the encoding attr
generated document so that the external resource does not have to be supplied in the
print job.
</p>
-<a name="N10376"></a><a name="afp-tag-logical-element"></a>
+<a name="N10394"></a><a name="afp-tag-logical-element"></a>
<h4>Tag Logical Element (TLE) Extension</h4>
<p>The tag-logical-element extension element allows to injects TLEs into the AFP output stream. Example:</p>
<pre class="code">
@@ -1345,7 +1379,7 @@ Note that the value of the encoding attr
Multiple tag-logical-element extension elements within a simple-page-master or
page-sequence are allowed. The name and value attributes are mandatory.
</p>
-<a name="N10387"></a><a name="afp-no-operation"></a>
+<a name="N103A5"></a><a name="afp-no-operation"></a>
<h4>No Operation (NOP) Extension</h4>
<p>The no-operation extension provides the ability to carry up to 32K of comments or any other type
of unarchitected data into the AFP output stream. Example:</p>
@@ -1359,16 +1393,21 @@ Note that the value of the encoding attr
</fo:layout-master-set>
</pre>
<p>The no-operation extension element can appear as child of
- simple-page-master (appears after "Begin Page" BPG),
- page-sequence (appears after "Begin Named Page Group" BNG
- and declarations (appears after "Begin Document" BDT).
+ <span class="codefrag">simple-page-master</span> (appears after "Begin Page" BPG),
+ <span class="codefrag">page-sequence</span> (appears after "Begin Named Page Group" BNG
+ and <span class="codefrag">declarations</span> (appears after "Begin Document" BDT).
Multiple no-operation extension elements inside the same formatting object are allowed.
Each NOP will appear right after the respective "Begin" field indicated above even if it
- is specified as the last child under its parent. However, the order inside the parent
+ is specified as the last child under its parent. The order inside the parent
will be maintained.
- The name attribute is mandatory but will not appear inside the AFP stream.
+ The "placement" attribute can be used to have the NOP appear before
+ the "End" field of the object rather than after the "Begin" field. Specify
+ <span class="codefrag">placement="before-end"</span> to do that. Please note that, at the moment, this only
+ has an effect for NOPs that are children of the <span class="codefrag">page-sequence</span> formatting
+ object.
+ The "name" attribute is mandatory but will not appear inside the AFP stream.
</p>
-<a name="N10398"></a><a name="afp-invoke-medium-map"></a>
+<a name="N103C5"></a><a name="afp-invoke-medium-map"></a>
<h4>Invoke Medium Map (IMM) Extension</h4>
<p>
The invoke-medium-map extension allows to generate IMM fields (Invoke Medium Map) in the
@@ -1390,7 +1429,7 @@ Note that the value of the encoding attr
only reference an existing medium map by name. The medium map has to be constructed
through different means and available on the target platform.
</p>
-<a name="N103A9"></a><a name="afp-form-maps"></a>
+<a name="N103D6"></a><a name="afp-form-maps"></a>
<h4>Form Maps/Defs</h4>
<p>
Apache FOP supports embedding an external form map resource in the
@@ -1421,9 +1460,9 @@ Note that the value of the encoding attr
tool.
</div>
</div>
-<a name="N103D0"></a><a name="afp-foreign-attributes"></a>
+<a name="N103FD"></a><a name="afp-foreign-attributes"></a>
<h3 class="underlined_5">Foreign Attributes</h3>
-<a name="N103D6"></a><a name="afp-foreign-attributes-resource"></a>
+<a name="N10403"></a><a name="afp-foreign-attributes-resource"></a>
<h4>Resource</h4>
<p>The resource foreign attributes provides the ability to name and control where data object resources
(e.g. images/scalable vector graphics) will reside in the AFP output.
@@ -1460,7 +1499,7 @@ Note that the value of the encoding attr
<p></p>
</div>
-<a name="N103EF"></a><a name="rtf"></a>
+<a name="N1041C"></a><a name="rtf"></a>
<h2 class="underlined_10">RTF</h2>
<div class="section">
<p>
@@ -1514,7 +1553,7 @@ Note that the value of the encoding attr
</ul>
</div>
-<a name="N10423"></a><a name="xml"></a>
+<a name="N10450"></a><a name="xml"></a>
<h2 class="underlined_10">XML (Area Tree XML)</h2>
<div class="section">
<p>
@@ -1528,7 +1567,7 @@ Note that the value of the encoding attr
</p>
</div>
-<a name="N10434"></a><a name="awt"></a>
+<a name="N10461"></a><a name="awt"></a>
<h2 class="underlined_10">Java2D/AWT</h2>
<div class="section">
<p>
@@ -1543,14 +1582,14 @@ Note that the value of the encoding attr
</p>
</div>
-<a name="N10441"></a><a name="print"></a>
+<a name="N1046E"></a><a name="print"></a>
<h2 class="underlined_10">Print</h2>
<div class="section">
<p>
It is possible to directly print the document from the command line.
This is done with the same code that renders to the Java2D/AWT renderer.
</p>
-<a name="N1044A"></a><a name="print-issues"></a>
+<a name="N10477"></a><a name="print-issues"></a>
<h3 class="underlined_5">Known issues</h3>
<p>
If you run into the problem that the printed output is incomplete on Windows:
@@ -1561,7 +1600,7 @@ Note that the value of the encoding attr
</p>
</div>
-<a name="N10455"></a><a name="bitmap"></a>
+<a name="N10482"></a><a name="bitmap"></a>
<h2 class="underlined_10">Bitmap (TIFF/PNG)</h2>
<div class="section">
<p>
@@ -1580,7 +1619,7 @@ Note that the value of the encoding attr
The quality of the bitmap depends on the target resolution setting
on the FOUserAgent and on further settings described below.
</p>
-<a name="N1046A"></a><a name="bitmap-configuration"></a>
+<a name="N10497"></a><a name="bitmap-configuration"></a>
<h3 class="underlined_5">Configuration</h3>
<p>
The TIFF and PNG renderer configuration currently allows the following settings:
@@ -1641,7 +1680,7 @@ Note that the value of the encoding attr
at the loss of some image quality. If this setting has an actual effect depends
on the JVM's Java2D backend.
</p>
-<a name="N104D1"></a><a name="tiff-configuration"></a>
+<a name="N104FE"></a><a name="tiff-configuration"></a>
<h3 class="underlined_5">TIFF-specific Configuration</h3>
<p>
In addition to the above values the TIFF renderer configuration allows some additional
@@ -1707,7 +1746,7 @@ Note that the value of the encoding attr
Deflate and JPEG compression for writing.
</div>
</div>
-<a name="N1051C"></a><a name="bitmap-rendering-options"></a>
+<a name="N10549"></a><a name="bitmap-rendering-options"></a>
<h3 class="underlined_5">Runtime Rendering Options</h3>
<p>
The IF-based bitmap output implementations support a rendering option with the key
@@ -1719,7 +1758,7 @@ Note that the value of the encoding attr
"target-bitmap-size", new Dimension(320, 200));</pre>
</div>
-<a name="N1052B"></a><a name="txt"></a>
+<a name="N10558"></a><a name="txt"></a>
<h2 class="underlined_10">TXT</h2>
<div class="section">
<p>
@@ -1757,7 +1796,7 @@ Note that the value of the encoding attr
</ul>
</div>
-<a name="N10547"></a><a name="sandbox"></a>
+<a name="N10574"></a><a name="sandbox"></a>
<h2 class="underlined_10">Output Formats in the Sandbox</h2>
<div class="section">
<p>
@@ -1766,7 +1805,7 @@ Note that the value of the encoding attr
can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the
main build. The output formats in the sandbox are marked as such below.
</p>
-<a name="N10550"></a><a name="mif"></a>
+<a name="N1057D"></a><a name="mif"></a>
<h3 class="underlined_5">MIF</h3>
<div class="warning">
<div class="label">Warning</div>
@@ -1776,7 +1815,7 @@ Note that the value of the encoding attr
This format is the Maker Interchange Format which is used by
Adobe Framemaker.
</p>
-<a name="N1055D"></a><a name="svg"></a>
+<a name="N1058A"></a><a name="svg"></a>
<h3 class="underlined_5">SVG</h3>
<div class="warning">
<div class="label">Warning</div>
@@ -1795,7 +1834,7 @@ Note that the value of the encoding attr
</p>
</div>
-<a name="N1056B"></a><a name="wishlist"></a>
+<a name="N10598"></a><a name="wishlist"></a>
<h2 class="underlined_10">Wish list</h2>
<div class="section">
<p>
@@ -1818,7 +1857,7 @@ Note that the value of the encoding attr
<font size="-2">by Keiron Liddle, Art Welch</font>
</p>
<span class="version">
- version 1066078</span>
+ version 1095882</span>
</div>
<!--+
|end content
@@ -1836,7 +1875,7 @@ document.write("Last Published: " + docu
</div>
<div class="copyright">
Copyright ©
- 1999-2009 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ 1999-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
</div>
<!--+
|end bottomstrip
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org