diff options
author | Jeremias Maerki <jeremias@apache.org> | 2009-02-05 10:40:52 +0000 |
---|---|---|
committer | Jeremias Maerki <jeremias@apache.org> | 2009-02-05 10:40:52 +0000 |
commit | 879e33c0429f91fd9d6734b7d00410b71afbfa1d (patch) | |
tree | 7dd4b3b179973708ac5a47ffc82c5ba5b8880228 /src/documentation | |
parent | 8ab837c32d7a38a7fa7742d335944e251b203a50 (diff) | |
download | xmlgraphics-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.xml | 26 |
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> |