From: William Victor Mote Date: Tue, 29 Apr 2003 03:30:54 +0000 (+0000) Subject: Expand descriptions of graphics formats where known. X-Git-Tag: Root_Temp_KnuthStylePageBreaking~1518 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=e6a875fab512ee33c0c7e7e3a3b36be0fb378d94;p=xmlgraphics-fop.git Expand descriptions of graphics formats where known. Expand Resolution section to include brief conclusion. Add Batik version to Batik section. Minor changes to Batik/SVG sections. All suggestions from Clay Leeds. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196366 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/graphics.xml b/src/documentation/content/xdocs/graphics.xml index c50964349..e1bd176ef 100644 --- a/src/documentation/content/xdocs/graphics.xml +++ b/src/documentation/content/xdocs/graphics.xml @@ -18,7 +18,7 @@ Support Thru - BMP + BMP (Microsoft Windows Bitmap) bitmap JIMI or JAI @@ -28,7 +28,7 @@ JIMI - GIF + GIF (Graphics Interchange Format) bitmap FOP native @@ -43,12 +43,12 @@ JIMI - JPEG + JPEG (Joint Photographic Experts Group) bitmap FOP native - PCX + PCX (PC Paintbrush) bitmap JIMI @@ -58,12 +58,12 @@ JIMI - PNG + PNG (Portable Network Graphic) bitmap JIMI or JAI - PNM + PNM (Portable aNyMap Utilities, part of the Portable Bitmap Utilies, aka pbmplus. PNM is a superset encompassing PBM or Portable Bitmap, PGM or Portable Grayscale, and PPM or Portable Pixmap.) bitmap JAI @@ -73,32 +73,32 @@ JIMI - Sunraster + RAS (Sunraster) bitmap JIMI - SVG + SVG (Scalable Vector Graphics) vector (with embedded bitmaps) Batik - Targa + TGA (Targa) bitmap JIMI - TIFF + TIFF (Tag Image Format File) bitmap JIMI or JAI - XBM + XBM (X BitMap) bitmap JIMI - XPM + XPM (X PixMap) bitmap JIMI @@ -129,9 +129,7 @@ JAI is much faster than JIMI, but is not available for all platforms. See
Batik -

- FOP distributions include a batik.jar file. No installation is required. -

+

Current FOP distributions include a distribution of the Apache Software Foundation's Batik version 1.5beta4. No installation is required. Because Batik's API changes frequently, it is highly recommended that you use this version with FOP.

@@ -144,7 +142,7 @@ JAI is much faster than JIMI, but is not available for all platforms. See Introduction

-FOP uses the SVG library from Batik to handle SVG. +FOP uses Batik for SVG support. This format can be handled as an fo:instream-foreign-object or in a separate file referenced with fo:external-graphic. Either way the SVG document will be read in and converted into a DOM in Batik. This DOM will then be used by the renderer to @@ -284,6 +282,7 @@ into a raster graphic are not drawn properly in PDF. The image is opaque.

  • If only one dimension is given, FOP by default uses the same aspect ratio to compute the other dimension (to avoid the appearance of stretching). For example, suppose a graphic 300 pixels wide and 400 pixels high, for which content-width = ".5in". FOP will compute the content-height = .667 inches, and will render the graphic at that size, with an apparent resolution of 600 dpi.
  • If both dimensions are given, FOP simply renders the image in that space. For example, suppose a graphic 300 pixels wide and 400 pixels high, for which content-width = "3in" and content-height = "4in". FOP will render the graphic at that size, with an apparent resolution of 100 dpi.
    • +

    If you need a higher apparent output resolution for bitmapped images, first make sure that at least one dimension of the image is defined in your XSL-FO input. Apart from that, resolution problems are in the image file itself, and must be corrected there: use or create a higher-resolution image file.

    The explanation above describes only the basic default behavior. There are other attributes of the fo:external-graphic element that can affect the behavior described above.