xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From spepp...@apache.org
Subject svn commit: r1160690 [35/39] - in /xmlgraphics/site/deploy/fop: ./ 0.95/ 1.0/ dev/ dev/design/ dev/svg/ skin/images/ trunk/
Date Tue, 23 Aug 2011 13:51:42 GMT
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> &gt; <a href="http://xml.apache.org/">XML
Federation</a> &gt; <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> &gt;
<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>
   &lt;optimize-resources&gt;false&lt;/optimize-resources&gt;
   &lt;safe-set-page-device&gt;false&lt;/safe-set-page-device&gt;
   &lt;dsc-compliant&gt;true&lt;/dsc-compliant&gt;
+  &lt;rendering&gt;quality&lt;/rendering&gt;
 &lt;/renderer&gt;</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>
       &lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
                xmlns:pcl="http://xmlgraphics.apache.org/fop/extensions/pcl"&gt;
 </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 &lt;renderer-resolution/&gt; configuration
element. Example:</p>
 <pre class="code">
       &lt;renderer-resolution&gt;240&lt;/renderer-resolution&gt;</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 &lt;images/&gt; configuration element. Example:</p>
@@ -1215,7 +1227,29 @@ Note that the value of the encoding attr
         </p>
 <pre class="code">
       &lt;images mode="b+w" bits-per-pixel="1" dithering-quality="maximum"/&gt;</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">
+      &lt;goca enabled="false"/&gt;</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">
+      &lt;goca enabled="true" text="shapes"/&gt;</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">
       &lt;shading&gt;dithered&lt;/shading&gt;
 </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
       &lt;fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
                xmlns:afp="http://xmlgraphics.apache.org/fop/extensions/afp"&gt;
 </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
       &lt;/fo:layout-master-set&gt;
 </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&nbsp;Keiron Liddle,&nbsp;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 &copy;
-         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


Mime
View raw message