diff options
| author | Peter Hancock <phancock@apache.org> | 2011-11-01 12:20:21 +0000 |
|---|---|---|
| committer | Peter Hancock <phancock@apache.org> | 2011-11-01 12:20:21 +0000 |
| commit | fd263a114c84c3756ead9c16b8b088531c5cab2c (patch) | |
| tree | 4cd6ba7c8fe3a144629477ac911b2651707bdb03 /src/documentation/content/xdocs | |
| parent | 54a4751b616ab4e8957b97af4088bd725367ea6f (diff) | |
| download | xmlgraphics-fop-fd263a114c84c3756ead9c16b8b088531c5cab2c.tar.gz xmlgraphics-fop-fd263a114c84c3756ead9c16b8b088531c5cab2c.zip | |
Bugzilla#52089: Allow JPEG images to be embedded in an AFP document as
is, without being decoded and encoded. It also allows lossy JPEG compression.
Patch by Jeremias Maerki and Mehdi Houshmand.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@1195952 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src/documentation/content/xdocs')
| -rw-r--r-- | src/documentation/content/xdocs/trunk/output.xml | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/src/documentation/content/xdocs/trunk/output.xml b/src/documentation/content/xdocs/trunk/output.xml index 7b245eb07..cf88bd321 100644 --- a/src/documentation/content/xdocs/trunk/output.xml +++ b/src/documentation/content/xdocs/trunk/output.xml @@ -796,6 +796,23 @@ Note that the value of the encoding attribute in the example is the double-byte </p> <source><![CDATA[ <images mode="b+w" bits-per-pixel="1" dithering-quality="maximum"/>]]></source> + <p> + By default, JPEG images are rasterized to a bitmap and the bitmap is included in the AFP doc. + However it is possible to encode in a lossless way to maintain maximum quality. But due + to lack of support for compression schemes like LZW (patent concerns), bitmap data is currently + not compressed resulting in large AFP files. Using the "allow-embedding" attribute on jpeg child + element allows the user to pass the JPEG as is in the document. The default is set to "false" since + there are compatibility concerns as some AFP printers don't support JPEG decoding. Using the + "bitmap-encoding-quality" attribute it is possible to enable lossy compression (JPEG baseline + DCT). The default is "1.0" which means lossless encoding. Setting a value lower than 1.0, JPEG + compression is enabled and the setting is used as the quality setting when encoding bitmap data. + Note that this setting does not always have an effect. Bi-level (1 bit) bitmaps are not compressed + using JPEG. Example: + </p> + <source><![CDATA[ + <images mode="color" cmyk="true"> + <jpeg allow-embedding="false" bitmap-encoding-quality="0.8"/> + </images>]]></source> </section> <section id="afp-goca-config"> <title>GOCA (Vector Graphics)</title> |