vmote       2003/07/08 10:36:52

  Modified:    src/documentation/content/xdocs graphics.xml
  Log:
  Add user comments regarding color-space and other issues. Submitted by Ben Galbraith 
(see thread at http://marc.theaimsgroup.com/?t=105760121500002&r=1&w=2).
  
  Revision  Changes    Path
  1.18      +22 -12    xml-fop/src/documentation/content/xdocs/graphics.xml
  
  Index: graphics.xml
  ===================================================================
  RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/graphics.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- graphics.xml      21 May 2003 17:18:33 -0000      1.17
  +++ graphics.xml      8 Jul 2003 17:36:52 -0000       1.18
  @@ -18,7 +18,7 @@
             <th>Support Thru</th>
           </tr>
           <tr>
  -          <td>BMP (Microsoft Windows Bitmap)</td>
  +          <td><link href="#bmp">BMP</link> (Microsoft Windows Bitmap)</td>
             <td>bitmap</td>
             <td><link href="#native">FOP native</link></td>
           </tr>
  @@ -38,7 +38,7 @@
             <td><link href="#native">FOP native</link></td>
           </tr>
           <tr>
  -          <td>PNG (Portable Network Graphic)</td>
  +          <td><link href="#png">PNG</link> (Portable Network Graphic)</td>
             <td>bitmap</td>
             <td><link href="#jimi">JIMI</link> or <link href="#jai">JAI</link></td>
           </tr>
  @@ -95,6 +95,10 @@
           </ul>
         </section>
       </section>
  +    <section id="bmp">
  +      <title>BMP</title>
  +      <p>FOP native support for BMP images is limited to the RGB color-space.</p>
  +    </section>
       <section id="eps">
         <title>EPS</title>
         <p>FOP provides support for two output targets:</p>
  @@ -115,17 +119,17 @@
       </section>
       <section id="jpeg">
         <title>JPEG</title>
  -      <p>
  -        Not all variants of JPEG are supported, especially those containing unusual 
color 
  -        lookup tables and color profiles. If you have trouble with a JPEG image in 
FOP, try 
  -        opening it with an image processing program (such as Photoshop or Gimp) and 
then saving 
  -        it. Specifying 24-bit color output may also help.
  -      </p>
  -      <p>
  -        For the PDF and PostScript renderers most JPEG images can be passed through 
without 
  -        decompression.
  +      <p>FOP native support of JPEG does not include all variants, especially those 
containing unusual color lookup tables and color profiles.
  +If you have trouble with a JPEG image in FOP, try opening it with an image 
processing program (such as Photoshop or Gimp) and then saving it.
  +Specifying 24-bit color output may also help.
  +For the PDF and PostScript renderers most JPEG images can be passed through without 
decompression.
  +User reports indicate that grayscale, RGB, and CMYK color-spaces are all rendered 
properly.
         </p>
       </section>
  +    <section id="png">
  +      <title>PNG</title>
  +      <p>If using JAI for PNG support, only RGB and RGBA color-spaces are supported 
for FOP rendering.</p>
  +    </section>
       <section id="svg">
         <title>SVG</title>
         <section id="svg-intro">
  @@ -242,7 +246,13 @@
       </section>
       <section id="tiff">
         <title>TIFF</title>
  -      <p>TIFF images with JPEG or CCITT content are passed through by FOP natively 
(PDF and PostScript only). Other TIFF subformats are handled by JAI.</p>
  +      <p>FOP-native TIFF support is limited to PDF and PostScript output only. 
Also, according to user reports, FOP's native support for TIFF is limited to images 
with the following characteristics (all must be true for successful rendering):</p>
  +      <ul>
  +        <li>single channel images (i.e., bi-level and grayscale only)</li>
  +        <li>uncompressed images, or images using CCITT T.4, CCITT T.6, or JPEG 
compression</li>
  +        <li>images using white-is-zero encoding in the TIFF 
PhotometricInterpretation tag</li>
  +      </ul>
  +      <p><em>JAI:</em> Supports RGB and RGBA only for FOP rendering.</p>
       </section>
       <section id="resolution">
         <title>Graphics Resolution</title>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to