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 2010/07/21 09:25:30 UTC

svn commit: r966121 [11/14] - in /xmlgraphics/site/deploy/fop: ./ 0.94/ 0.95/ dev/ dev/design/ dev/svg/ skin/ trunk/

Modified: xmlgraphics/site/deploy/fop/team.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/team.pdf?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/team.pdf (original) and xmlgraphics/site/deploy/fop/team.pdf Wed Jul 21 07:25:21 2010 differ

Modified: xmlgraphics/site/deploy/fop/team.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/team.xml?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/team.xml (original)
+++ xmlgraphics/site/deploy/fop/team.xml Wed Jul 21 07:25:21 2010
@@ -136,4 +136,4 @@
       </ul>
     </section>
   </body>
-</document>
\ No newline at end of file
+</document>

Modified: xmlgraphics/site/deploy/fop/trunk/accessibility.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/accessibility.html?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/accessibility.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/accessibility.html Wed Jul 21 07:25:21 2010
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-version" content="0.8">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Accessibility</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -58,10 +58,10 @@
 <a class="unselected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="unselected" href="../0.94/index.html">Version 0.94</a>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
 </li>
 <li>
-<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+<a class="unselected" href="../1.0/index.html">Version 1.0</a>
 </li>
 <li class="current">
 <a class="selected" href="../trunk/index.html">FOP Trunk</a>
@@ -176,9 +176,7 @@ document.write("Last Published: " + docu
 <!--+
   |alternative credits
   +-->
-<div id="credit2">
-<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2009" alt="ApacheCon US 2009 - logo" src="http://apache.org/ads/ApacheCon/2009-usa-125x125.png" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
 </div>
 <!--+
     |end Menu
@@ -201,7 +199,6 @@ document.write("Last Published: " + docu
 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Accessibility</h1>
-<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -227,7 +224,6 @@ document.write("Last Published: " + docu
 </li>
 </ul>
 </div>
-</div>
     
 <a name="N1000E"></a><a name="overview"></a>
 <h2 class="underlined_10">Overview</h2>

Modified: xmlgraphics/site/deploy/fop/trunk/accessibility.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/accessibility.pdf?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
Binary files - no diff available.

Modified: xmlgraphics/site/deploy/fop/trunk/anttask.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/anttask.html?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/anttask.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/anttask.html Wed Jul 21 07:25:21 2010
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-version" content="0.8">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Ant task</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -58,10 +58,10 @@
 <a class="unselected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="unselected" href="../0.94/index.html">Version 0.94</a>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
 </li>
 <li>
-<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+<a class="unselected" href="../1.0/index.html">Version 1.0</a>
 </li>
 <li class="current">
 <a class="selected" href="../trunk/index.html">FOP Trunk</a>
@@ -176,9 +176,7 @@ document.write("Last Published: " + docu
 <!--+
   |alternative credits
   +-->
-<div id="credit2">
-<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2009" alt="ApacheCon US 2009 - logo" src="http://apache.org/ads/ApacheCon/2009-usa-125x125.png" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
 </div>
 <!--+
     |end Menu
@@ -201,7 +199,6 @@ document.write("Last Published: " + docu
 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Ant task</h1>
-<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -215,7 +212,6 @@ document.write("Last Published: " + docu
 </li>
 </ul>
 </div>
-</div>
     
 <p>
       Apache FOP provides an Ant task for automating the document build process.

Modified: xmlgraphics/site/deploy/fop/trunk/anttask.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/anttask.pdf?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/trunk/anttask.pdf (original) and xmlgraphics/site/deploy/fop/trunk/anttask.pdf Wed Jul 21 07:25:21 2010 differ

Modified: xmlgraphics/site/deploy/fop/trunk/compiling.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/compiling.html?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/compiling.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/compiling.html Wed Jul 21 07:25:21 2010
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-version" content="0.8">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Apache FOP: Building from Source Code</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -58,10 +58,10 @@
 <a class="unselected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="unselected" href="../0.94/index.html">Version 0.94</a>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
 </li>
 <li>
-<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+<a class="unselected" href="../1.0/index.html">Version 1.0</a>
 </li>
 <li class="current">
 <a class="selected" href="../trunk/index.html">FOP Trunk</a>
@@ -176,9 +176,7 @@ document.write("Last Published: " + docu
 <!--+
   |alternative credits
   +-->
-<div id="credit2">
-<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2009" alt="ApacheCon US 2009 - logo" src="http://apache.org/ads/ApacheCon/2009-usa-125x125.png" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
 </div>
 <!--+
     |end Menu
@@ -201,7 +199,6 @@ document.write("Last Published: " + docu
 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Apache FOP: Building from Source Code</h1>
-<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -232,7 +229,6 @@ document.write("Last Published: " + docu
 </li>
 </ul>
 </div>
-</div>
     
 <a name="N10011"></a><a name="build-needed"></a>
 <h2 class="underlined_10">Do You Need To Build?</h2>

Modified: xmlgraphics/site/deploy/fop/trunk/compiling.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/compiling.pdf?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/trunk/compiling.pdf (original) and xmlgraphics/site/deploy/fop/trunk/compiling.pdf Wed Jul 21 07:25:21 2010 differ

Modified: xmlgraphics/site/deploy/fop/trunk/configuration.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/configuration.html?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/configuration.html (original)
+++ xmlgraphics/site/deploy/fop/trunk/configuration.html Wed Jul 21 07:25:21 2010
@@ -3,7 +3,7 @@
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta content="Apache Forrest" name="Generator">
-<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-version" content="0.8">
 <meta name="Forrest-skin-name" content="pelt">
 <title>Apache FOP: Configuration</title>
 <link type="text/css" href="../skin/basic.css" rel="stylesheet">
@@ -58,10 +58,10 @@
 <a class="unselected" href="../index.html">Home</a>
 </li>
 <li>
-<a class="unselected" href="../0.94/index.html">Version 0.94</a>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
 </li>
 <li>
-<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+<a class="unselected" href="../1.0/index.html">Version 1.0</a>
 </li>
 <li class="current">
 <a class="selected" href="../trunk/index.html">FOP Trunk</a>
@@ -176,9 +176,7 @@ document.write("Last Published: " + docu
 <!--+
   |alternative credits
   +-->
-<div id="credit2">
-<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2009" alt="ApacheCon US 2009 - logo" src="http://apache.org/ads/ApacheCon/2009-usa-125x125.png" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
 </div>
 <!--+
     |end Menu
@@ -201,7 +199,6 @@ document.write("Last Published: " + docu
 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Apache FOP: Configuration</h1>
-<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -216,6 +213,9 @@ document.write("Last Published: " + docu
 <a href="#general-elements">Summary of the General Configuration Options</a>
 </li>
 <li>
+<a href="#image-loading">Image Loading Customization</a>
+</li>
+<li>
 <a href="#renderers">Renderer configuration</a>
 <ul class="minitoc">
 <li>
@@ -237,7 +237,6 @@ document.write("Last Published: " + docu
 </li>
 </ul>
 </div>
-</div>
   
 <a name="N10011"></a><a name="general"></a>
 <h2 class="underlined_10">Configuration File Basics</h2>
@@ -482,7 +481,45 @@ document.write("Last Published: " + docu
 &lt;/fop&gt;</pre>
 </div>
   
-<a name="N1019C"></a><a name="renderers"></a>
+<a name="N1019C"></a><a name="image-loading"></a>
+<h2 class="underlined_10">Image Loading Customization</h2>
+<div class="section">
+<p>
+      Apache FOP uses the image loading framework from
+      <a href="http://xmlgraphics.apache.org/commons/">Apache XML Graphics Commons</a> to load
+      images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty
+      that influences which solution is chosen if there are multiple possibilities to load an image.
+      Sometimes, though, these penalties need to be tweaked and this can be done in the FOP
+      configuration. An example:
+    </p>
+<pre class="code">&lt;fop version="1.0"&gt;
+  [..]
+  &lt;image-loading&gt;
+    &lt;penalty value="10000"
+      class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderRawCCITTFax"/&gt;
+    &lt;penalty value="INFINITE"
+      class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderInternalTIFF"/&gt;
+  &lt;/image-loading&gt;
+  &lt;renderers....
+&lt;/fop&gt;</pre>
+<p>
+      The first penalty element increases the penalty for the raw CCITT loader. This practically
+      forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs
+      available. 
+    </p>
+<p>
+      The second penalty element sets an "infinite" penalty for the TIFF loader using the internal
+      TIFF codec. This practically disables that plug-in as it will never be chosen as a possible
+      solution.
+    </p>
+<p>
+      Negative penalties are possible to promote a plug-in but a negative penalty sum will be
+      treated as zero penalty in most cases. For more details on the image loading framework,
+      please consult the documentation there.
+    </p>
+</div>
+  
+<a name="N101B7"></a><a name="renderers"></a>
 <h2 class="underlined_10">Renderer configuration</h2>
 <div class="section">
 <p>
@@ -517,7 +554,7 @@ document.write("Last Published: " + docu
       The details on the font configuration can be found on the separate <a href="fonts.html">Fonts</a> page.
       Note especially the section entitled <a href="fonts.html#register">Register Fonts with FOP</a>.
     </p>
-<a name="N101B7"></a><a name="pdf-renderer"></a>
+<a name="N101D2"></a><a name="pdf-renderer"></a>
 <h3 class="underlined_5">Special Settings for the PDF Renderer</h3>
 <p>
         The configuration element for the PDF renderer contains two elements. One is for the font configuration
@@ -590,7 +627,7 @@ document.write("Last Published: " + docu
          &lt;noannotations/&gt;
       &lt;/encryption-params&gt;
     &lt;/renderer&gt;</pre>
-<a name="N101DE"></a><a name="ps-renderer"></a>
+<a name="N101F9"></a><a name="ps-renderer"></a>
 <h3 class="underlined_5">Special Settings for the PostScript Renderer</h3>
 <p>
         Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript
@@ -613,7 +650,7 @@ document.write("Last Published: " + docu
         &lt;/font&gt;
       &lt;/fonts&gt;
     &lt;/renderer&gt;</pre>
-<a name="N101EC"></a><a name="pcl-renderer"></a>
+<a name="N10207"></a><a name="pcl-renderer"></a>
 <h3 class="underlined_5">Special Settings for the PCL Renderer</h3>
 <p>
         Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that
@@ -640,7 +677,7 @@ document.write("Last Published: " + docu
         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>
-<a name="N10203"></a><a name="afp-renderer"></a>
+<a name="N1021E"></a><a name="afp-renderer"></a>
 <h3 class="underlined_5">Special Settings for the AFP Renderer</h3>
 <p>
       
@@ -668,7 +705,7 @@ document.write("Last Published: " + docu
 </div>
 
         
-<a name="N10220"></a><a name="When+it+does+not+work"></a>
+<a name="N1023B"></a><a name="When+it+does+not+work"></a>
 <h2 class="underlined_10">When it does not work</h2>
 <div class="section">
 <p>FOP searches the configuration file for the information it
@@ -711,7 +748,7 @@ information it finds. Check if FOP finds
 </div>
   
 <span class="version">
-          version 747015</span>
+          version 924860</span>
 </div>
 <!--+
     |end content

Modified: xmlgraphics/site/deploy/fop/trunk/configuration.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/configuration.pdf?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
Files xmlgraphics/site/deploy/fop/trunk/configuration.pdf (original) and xmlgraphics/site/deploy/fop/trunk/configuration.pdf Wed Jul 21 07:25:21 2010 differ

Modified: xmlgraphics/site/deploy/fop/trunk/configuration.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/trunk/configuration.xml?rev=966121&r1=966120&r2=966121&view=diff
==============================================================================
--- xmlgraphics/site/deploy/fop/trunk/configuration.xml (original)
+++ xmlgraphics/site/deploy/fop/trunk/configuration.xml Wed Jul 21 07:25:21 2010
@@ -17,7 +17,7 @@
 <document>
   <header>
     <title>Apache FOP: Configuration</title>
-    <version>$Revision: 747015 $</version>
+    <version>$Revision: 924860 $</version>
   </header>
 
   <body>
@@ -215,6 +215,42 @@
   <!-- etc. etc..... -->
 </fop>]]></source>
   </section>
+  <section id="image-loading">
+    <title>Image Loading Customization</title>
+    <p>
+      Apache FOP uses the image loading framework from
+      <link href="http://xmlgraphics.apache.org/commons/">Apache XML Graphics Commons</link> to load
+      images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty
+      that influences which solution is chosen if there are multiple possibilities to load an image.
+      Sometimes, though, these penalties need to be tweaked and this can be done in the FOP
+      configuration. An example:
+    </p>
+    <source xml:space="preserve"><![CDATA[<fop version="1.0">
+  [..]
+  <image-loading>
+    <penalty value="10000"
+      class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderRawCCITTFax"/>
+    <penalty value="INFINITE"
+      class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderInternalTIFF"/>
+  </image-loading>
+  <renderers....
+</fop>]]></source>
+    <p>
+      The first penalty element increases the penalty for the raw CCITT loader. This practically
+      forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs
+      available. 
+    </p>
+    <p>
+      The second penalty element sets an "infinite" penalty for the TIFF loader using the internal
+      TIFF codec. This practically disables that plug-in as it will never be chosen as a possible
+      solution.
+    </p>
+    <p>
+      Negative penalties are possible to promote a plug-in but a negative penalty sum will be
+      treated as zero penalty in most cases. For more details on the image loading framework,
+      please consult the documentation there.
+    </p>
+  </section>
   <section id="renderers">
     <title>Renderer configuration</title>
     <p>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org