aboutsummaryrefslogtreecommitdiffstats
path: root/src/documentation
diff options
context:
space:
mode:
authorJeremias Maerki <jeremias@apache.org>2009-02-05 10:40:52 +0000
committerJeremias Maerki <jeremias@apache.org>2009-02-05 10:40:52 +0000
commit879e33c0429f91fd9d6734b7d00410b71afbfa1d (patch)
tree7dd4b3b179973708ac5a47ffc82c5ba5b8880228 /src/documentation
parent8ab837c32d7a38a7fa7742d335944e251b203a50 (diff)
downloadxmlgraphics-fop-879e33c0429f91fd9d6734b7d00410b71afbfa1d.tar.gz
xmlgraphics-fop-879e33c0429f91fd9d6734b7d00410b71afbfa1d.zip
AFP Output: Added a configuration option to override the resource level defaults in the code. The chosen defaults in code may not always be the best. For example, a user reported that they can't use print-level images for some reason and it is not possible to switch on inlining for background images.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@741068 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src/documentation')
-rw-r--r--src/documentation/content/xdocs/trunk/output.xml26
1 files changed, 24 insertions, 2 deletions
diff --git a/src/documentation/content/xdocs/trunk/output.xml b/src/documentation/content/xdocs/trunk/output.xml
index 1962800e0..83e730de9 100644
--- a/src/documentation/content/xdocs/trunk/output.xml
+++ b/src/documentation/content/xdocs/trunk/output.xml
@@ -657,6 +657,26 @@ out = proc.getOutputStream();]]></source>
]]></source>
<note>Be careful when using this option not to overwrite existing resource files from previous rendering runs.</note>
</section>
+ <section id="afp-resource-level-defaults">
+ <title>Resource Level Defaults</title>
+ <p>
+ By default, bitmap image objects (or page segments derived from them) are put in the
+ print-file-level resource group and GOCA graphics are inlined for compatibility with
+ the AFP Workbench tool.
+ </p>
+ <p>
+ It is possible to override these defaults, either per image (see the
+ <link href="#afp-foreign-attributes-resource">afp:resource-level</link>
+ extension attribute below) or by specifying different defaults in the configuration:
+ </p>
+ <source><![CDATA[
+<default-resource-levels goca="print-file" bitmap="inline"/>]]></source>
+ <p>
+ "goca" refers to GOCA graphics and "bitmap" refers to IOCA images. The possible values
+ for the attributes are "inline" and "print-file". In the future,
+ additional possibilities may be added.
+ </p>
+ </section>
</section>
<section id="afp-extensions">
<title>Extensions</title>
@@ -772,8 +792,10 @@ out = proc.getOutputStream();]]></source>
]]></source>
<p>The resource-level attribute where the resource object will reside in the AFP output datastream.
The possible values for this are "inline", "print-file" and "external".
- When no resource-level attribute is provided, resources are by default placed at "print-file" level.
- When "external" is used a resource-group-file attribute must also be specified.</p>
+ When "external" is used a resource-group-file attribute must also be specified.
+ Please refer to the <link href="#afp-resource-level-defaults">Resource Level Defaults</link>
+ above to see what is used if the resource-level attribute is not specified.
+ </p>
<p></p>
</section>
</section>