From 1a9f422ad3b876ebd1dd0f2978e1ae10e845ea44 Mon Sep 17 00:00:00 2001 From: William Victor Mote Date: Tue, 29 Apr 2003 06:35:43 +0000 Subject: [PATCH] Document EPS support & rework related FAQs a bit. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196369 13f79535-47bb-0310-9956-ffa450edef68 --- src/documentation/content/xdocs/faq.xml | 46 +++++++------------- src/documentation/content/xdocs/graphics.xml | 13 ++++++ 2 files changed, 29 insertions(+), 30 deletions(-) diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index eb6e0a691..553281c39 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -370,45 +370,31 @@ - A graphic is not displayed. + Why is my graphic not rendered? -

- The most common reason is that the file is not found because of an - empty or wrong baseDir setting, spelling errors in the file name, in - particular using the wrong case, or, if the image is retrieved over - HTTP, the image was not delivered because of security settings in the - server, missing cookies or other authorization information, or - because of server misconfigurations. One way to check this is to - cut&paste the source URL from the fo:external-graphic into the - Location field of a browser on the machine where the FOP - process will be running. -

-

- Several other possibilities: -

+

Most commonly, the external file is not being found by FOP. +Check the following:

    -
  • - The graphic is too large to fit into the intended space. -
    • -
  • - Some image format subclasses can't be handled, try to convert the - graphic to a format subclass known to work. (Sorry, no list of - formats known to work) -
    • -
  • - Something else obscures the graphic, for example stuff from a - static content (very rare, but has happened). +
  • Empty or wrong baseDir setting.
    • +
  • Spelling errors in the file name (including using the wrong case).
    • +
  • Security Problems (i.e. image was not delivered because FOP is not allowed to read the file). +This is especially a problem if the external file is retrieved over HTTP. +Possible issues include security settings on the server, server configuration, and missing cookies or other authorization information. +Any easy way to check this is to cut&paste the source URL from the fo:external-graphic into the Location field of a browser on the machine where the FOP process will be running.
    • +
+

Other possibilities:

+
    +
  • The image format is not supported or not supported completely. See FOP Graphics Formats for a list of supported formats and related issues.
    • +
  • The graphic may be too large to fit into the intended space.
    • +
  • There may be something (static content) that is obscuring the graphic. (This is very rare).
- My graphical images do not work properly. -

See Graphical Formats.

+

See FOP Graphics Formats for a list of supported formats and related issues.

 diff --git a/src/documentation/content/xdocs/graphics.xml b/src/documentation/content/xdocs/graphics.xml index 5f929d869..809973071 100644 --- a/src/documentation/content/xdocs/graphics.xml +++ b/src/documentation/content/xdocs/graphics.xml @@ -27,6 +27,11 @@ unknown JIMI + + EPS (Encapsulated PostScript) + metafile (both bitmap and vector), probably most frequently used for vector drawings + FOP native (limited support) + GIF (Graphics Interchange Format) bitmap @@ -132,6 +137,14 @@ JAI is much faster than JIMI, but is not available for all platforms. See 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.

+
+ EPS +

FOP provides support for two output targets:

+
    +
  • PostScript (full support).
    • +
  • PDF (partial support). FOP embeds the EPS file into the PDF, but currently does not do so completely correctly. PostScript devices (including ghostscript) will render the EPS correctly, but Acrobat Reader will not currently display it.
    • +
+
JPEG

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. -- 2.39.5