From: William Victor Mote Date: Wed, 9 Jul 2003 17:10:06 +0000 (+0000) Subject: 1. move strokeSVGText documentation from graphics.xml to configuration.xml X-Git-Tag: Root_Temp_KnuthStylePageBreaking~1311 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=c4b2a86a79808e21090e7b1764449886970e85ef;p=xmlgraphics-fop.git 1. move strokeSVGText documentation from graphics.xml to configuration.xml 2. add summary table in configuration.xml 3. minor cleanup in graphics.xml git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196666 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/configuration.xml b/src/documentation/content/xdocs/configuration.xml index aeb6e9e2b..a1c3b1bcb 100644 --- a/src/documentation/content/xdocs/configuration.xml +++ b/src/documentation/content/xdocs/configuration.xml @@ -16,11 +16,32 @@ It contains templates for the various configuration options, most of which are c Be sure to follow any instructions, including comments which specify the value range. Also, since the configuration file is XML, be sure to keep it well-formed.

Do not change {fop-dir}/conf/config.xml or use it as the basis for your configuration file. It has an entirely different purpose. +

The general structure of the configuration file is a series of <entry> tags, each containing a <key> and a <value. (Fonts use a different format). Here is an example:

+ + strokeSVGText + false +]]>

After creating your configuration file, you must tell FOP how to find it:

+

See Setting the Configuration Programmatically for instructions on how to do so in an embedded environment.

+ +
+ Summary of Configuration Options + + + + + + + + + + + +
Option (key)Data Type (for the value)Default Value
strokeSVGTextBooleanTrue
Setting up hyphenation @@ -82,6 +103,14 @@ in the userconfig.xml in the entry <hyphenation-dir>. these conditions.
+
+ SVG +
+ strokeSVGText (boolean, True) +

In some cases, some text in SVG documents is converted to graphical shapes instead of retaining its character as text. To force all text to be rendered as text, set strokeSVGText = false. For a discussion of this issue, see FOP: Graphics, Placing SVG Text into PDF.

+ strokeSVGText is currently only effective in the PDF renderer. +
+
diff --git a/src/documentation/content/xdocs/graphics.xml b/src/documentation/content/xdocs/graphics.xml index fd5806fb3..1c8adfa69 100644 --- a/src/documentation/content/xdocs/graphics.xml +++ b/src/documentation/content/xdocs/graphics.xml @@ -182,23 +182,10 @@ If the text is inserted into the PDF using the inbuilt text commands for PDF it will use a single character.

-It is possible to make sure that all text is drawn into PDF using the -PDF text commands (instead of the graphical shapes), by adding the following to the user config: -

- - strokeSVGText - false -]]> -

In a servlet environment, you can set it directly:

- org.apache.fop.configuration.Configuration.put("strokeSVGText", Boolean.FALSE); -

For information on using a configuration file in a servlet, see the FAQ on that topic.

-

Note that this configuration setting works only for the PDF renderer.

-

-The drawback to forcing text to be rendered as text is that it will be confined to text that is -possible for PDF fonts (including embedded fonts) and implemented with -this workaround. The fonts available are the standard pdf fonts and any -fonts that you have embedded using FOP. The font sizes will be rounded -to an integer value. In future this will be improved. +For PDF output, there is a configuration option to force SVG text to be rendered as text. +The drawback to this approach is that it is effective only for available fonts (including embedded fonts). +Font sizes are rounded to the next integer point size. +This will be improved in the future.

Note that because SVG text can be rendered as either text or a vector graphic, you may need to consider settings in your viewer for both. The Acrobat viewer has both "smooth line art" and "smooth text" settings that may need to be set for SVG images to be displayed nicely on your screen (see Edit / Preferences / Display).