From: William Victor Mote Date: Mon, 14 Apr 2003 22:30:54 +0000 (+0000) Subject: Move JIMI and JAI content from faq.xml to svg.xml (which is really used now for infor... X-Git-Tag: Root_Temp_KnuthStylePageBreaking~1618 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=cda7dec37154298be37e534c63cb93b84e5e41e1;p=xmlgraphics-fop.git Move JIMI and JAI content from faq.xml to svg.xml (which is really used now for information on all graphics formats). Expand content to include a list of graphics formats supported by FOP through JIMI and JAI. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196263 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index c4273257a..76a2d911a 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -433,22 +433,9 @@ - My PNG images don't work. + My graphical images do not work properly. -

- The Jimi image library, which is by default used for processing - images in PNG and other formats, was removed from the distribution - for licensing reasons. You have to download - and install it by yourself. -

-

- Extract the file "JimiProClasses.zip" from the archive you've downloaded, rename it to "jimi-1.0.jar" and move it to FOP's lib directory. -

-

- An alternative to Jimi is to use Sun's JAI. It is much faster, but - not available for all platforms. -

+

See Graphical Formats.

 diff --git a/src/documentation/content/xdocs/svg.xml b/src/documentation/content/xdocs/svg.xml index 24b0ebb33..7838f81d0 100644 --- a/src/documentation/content/xdocs/svg.xml +++ b/src/documentation/content/xdocs/svg.xml @@ -6,6 +6,139 @@ FOP Graphics Formats +
+ Overview of Graphics Support +

+ The table below summarizes the theoretical support for graphical formats within FOP. In other words, within the constraints of the limitations listed here, these formats should work. However, many of them have not been tested, and there may be limitations that have not yet been discovered or documented. The packages needed to support some formats are not included in the FOP distribution and must be installed separately. Follow the links in the "Support Thru" column for more details. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FormatTypeSupport Thru
BMPbitmapJIMI or JAI
CURunknownJIMI
GIFbitmapFOP native
FPXunknownJAI
ICO (Sun Icon)bitmapJIMI
JPEGbitmapFOP native
PCXbitmapJIMI
PICT (Macintosh PICT)metafileJIMI
PNGbitmapJIMI or JAI
PNMbitmapJAI
PSD (Adobe Photoshop)bitmapJIMI
SunrasterbitmapJIMI
SVGvector (with embedded bitmaps)Batik
TargabitmapJIMI
TIFFbitmapJIMI or JAI
XBMbitmapJIMI
XPMbitmapJIMI
+
+
+ Graphics Packages +
+ FOP Native +

+ FOP has native ability to handle some graphic file formats. +

+
+
+ JIMI +

+ Because of licensing issues, the JIMI image library is not included in the FOP distribution. First, download and install it. +Then, copy the file "JimiProClasses.zip" from the archive to xml-fop/lib/jimi-1.0.jar. Please note that FOP binary distributions are compiled with JIMI support, so there is no need for you to build FOP to add the support. If jimi-1.0.jar is installed in the right place, it will automatically be used by FOP, otherwise it will not. +

+
+
+ JAI +

+ FOP has been compiled with JAI support, but JAI is not included in the FOP distribution. +To use it, simply install JAI. +JAI is much faster than JIMI, but is not available for all platforms. See What platforms are supported? on the JAI FAQ page for more details. +

+
+
+ Batik +

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

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

+
SVG