From f6d2687d1f32a52ffd3c2946488fac074b11cfa9 Mon Sep 17 00:00:00 2001 From: Keiron Liddle Date: Mon, 25 Sep 2000 22:41:22 +0000 Subject: [PATCH] updated docs with some more info on svg git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@193715 13f79535-47bb-0310-9956-ffa450edef68 --- docs/xml-docs/fop/architecture.xml | 29 ++++++++++++++++++++++++++++- docs/xml-docs/fop/embedding.xml | 2 ++ docs/xml-docs/fop/running.xml | 6 +++++- 3 files changed, 35 insertions(+), 2 deletions(-) diff --git a/docs/xml-docs/fop/architecture.xml b/docs/xml-docs/fop/architecture.xml index d298086e2..6b2140f6c 100644 --- a/docs/xml-docs/fop/architecture.xml +++ b/docs/xml-docs/fop/architecture.xml @@ -14,6 +14,8 @@ this class, a typical sequence is:

driver.setRenderer("org.apache.fop.render.pdf.PDFRenderer", version);

driver.addElementMapping("org.apache.fop.fo.StandardElementMapping");

driver.addElementMapping("org.apache.fop.svg.SVGElementMapping");

+

driver.addPropertyList("org.apache.fop.fo.StandardPropertyListMapping");

+

driver.addPropertyList("org.apache.fop.svg.SVGPropertyListMapping");

driver.setWriter(new PrintWriter(new FileWriter(args[1])));

driver.buildFOTree(parser, fileInputSource(args[0]));

@@ -254,4 +256,29 @@ discusses some issues applicable to rendering.

- \ No newline at end of file + + +

+FOP supports some svg rendering. SVG is supported as an instream-foreign-object +embedded in an FO document. FOP also supports rendering of an external SVG image. +

+ +

+Since the intream object that contains the SVG returns a single fo area then +the construction of the SVG document is handled differently. The SVG is created +by calling the createGraphic() on each SVG element. The element is then +responsible for loading the necessary information and child elements and creating +the corresponding SVG DOM element. When the FO tree is being layed out the +SVG tree is turned into the SVG DOM document which is stored for later rendering. +

+ +

+The SVG document is then held as a DOM tree which is then rendered by going through +the elements of the tree and rendering then in turn. +

+ +

+For more information see the SVG documentation. +

+ + diff --git a/docs/xml-docs/fop/embedding.xml b/docs/xml-docs/fop/embedding.xml index c39e58d3c..dbed2a95b 100644 --- a/docs/xml-docs/fop/embedding.xml +++ b/docs/xml-docs/fop/embedding.xml @@ -32,6 +32,8 @@

driver.setRenderer("org.apache.fop.render.pdf.PDFRenderer", version);

driver.addElementMapping("org.apache.fop.fo.StandardElementMapping");

driver.addElementMapping("org.apache.fop.svg.SVGElementMapping");

+

driver.addPropertyList("org.apache.fop.fo.StandardPropertyListMapping");

+

driver.addPropertyList("org.apache.fop.svg.SVGPropertyListMapping");

driver.setWriter(new PrintWriter(new FileWriter(args[1])));

driver.buildFOTree(parser, fileInputSource(args[0]));

driver.format();

diff --git a/docs/xml-docs/fop/running.xml b/docs/xml-docs/fop/running.xml index 049fe4f22..acdf11fe8 100644 --- a/docs/xml-docs/fop/running.xml +++ b/docs/xml-docs/fop/running.xml @@ -13,7 +13,11 @@

c) Fop supports SVG (see Features for further information) and needs the w3c.jar library. This library comes with Fop (xml-fop/lib) and must - be included in your classpath + be included in your classpath. The jar file w3c.jar is the compiled classes for the + java svg bindings with some other DOM classes that are used by the SVG DOM bindings. + The source for the svg java binding classes can be found at - + SVG Java bindings, currently they correspond to the CR-SVG-20000802 specification document. + The other required files can be found at W3C DOM Java binding.

d) Optional: Fop supports the jimi library for image processing, if it is in your classpath when you build Fop. -- 2.39.5