aboutsummaryrefslogtreecommitdiffstats
path: root/src/documentation
diff options
context:
space:
mode:
authorJeremias Maerki <jeremias@apache.org>2007-03-02 17:41:37 +0000
committerJeremias Maerki <jeremias@apache.org>2007-03-02 17:41:37 +0000
commit5ddd5eb42b6bb6b7579e5ae947b59b5b8a506e30 (patch)
tree2088f290e629a06c84537f6823ae25407fd61a41 /src/documentation
parent667bb1ccbce991aa1b2b6c25f8fcab0419b5fb42 (diff)
downloadxmlgraphics-fop-5ddd5eb42b6bb6b7579e5ae947b59b5b8a506e30.tar.gz
xmlgraphics-fop-5ddd5eb42b6bb6b7579e5ae947b59b5b8a506e30.zip
Update the documentation for the PostScript renderer.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@513862 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src/documentation')
-rw-r--r--src/documentation/content/xdocs/trunk/output.xml32
1 files changed, 31 insertions, 1 deletions
diff --git a/src/documentation/content/xdocs/trunk/output.xml b/src/documentation/content/xdocs/trunk/output.xml
index 8c2c0213e..96f7000a2 100644
--- a/src/documentation/content/xdocs/trunk/output.xml
+++ b/src/documentation/content/xdocs/trunk/output.xml
@@ -199,8 +199,38 @@ out = proc.getOutputStream();]]></source>
support for most text and layout.
Images and SVG are not fully supported, yet. Currently, the PostScript
renderer generates PostScript Level 3 with most DSC comments. Actually,
- the only Level 3 feature used is FlateDecode, everything else is Level 2.
+ the only Level 3 features used are the FlateDecode and DCTDecode
+ filter (the latter is used for 1:1 embedding of JPEG images), everything
+ else is Level 2.
</p>
+ <section id="ps-configuration">
+ <title>Configuration</title>
+ <p>
+ The PostScript renderer configuration currently allows the following settings:
+ </p>
+<source><![CDATA[<renderer mime="application/postscript">
+ <auto-rotate-landscape>false</auto-rotate-landscape>
+ <language-level>3</language-level>
+ <optimize-resources>false</optimize-resources>
+</renderer>]]></source>
+ <p>
+ The default value for the "auto-rotate-landscape" setting is "false". Setting it
+ to "true" will automatically rotate landscape pages and will mark them as landscape.
+ </p>
+ <p>
+ The default value for the "language-level" setting is "3". This setting specifies
+ the PostScript language level which should be used by FOP. Set this to "2"
+ only if you don't have a Level 3 capable interpreter.
+ </p>
+ <p>
+ The default value for the "optimize-resources" setting is "false". Setting it
+ to "true" will produce the PostScript file in two steps. A temporary file will be
+ written first which will then be processed to add only the fonts which were really
+ used and images are added to the stream only once as PostScript forms. This will
+ reduce file size but can potentially increase the memory needed in the interpreter
+ to process.
+ </p>
+ </section>
<section id="ps-limitations">
<title>Limitations</title>
<ul>