summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKen Sharp <ken.sharp@artifex.com>2021-11-02 11:59:28 +0000
committerKen Sharp <ken.sharp@artifex.com>2021-11-02 11:59:56 +0000
commitbb3319b1a396288c8fc75c7ab198e6e7fd3c734e (patch)
treef21a4781629af543f0d603367cb8d60795b9b0ab /doc
parent974e7fb5db480c06fc5def1d39e5898951a6a88c (diff)
downloadghostpdl-bb3319b1a396288c8fc75c7ab198e6e7fd3c734e.tar.gz
GhostPDF - add control for Marked Content and document
Now that we can pass marked content from the input to the pdfwrite device we need to be able to control it (this can significantly increase the size of a PDF file). This commit adds a new control to GhostPDF '-dPreserveMarkedContent' which defaults to true. If false then marked content is not passed to the pdfwrite device. Add documentation for the parameter, fix formatting of the PreserveAnnots and PreserveAnnotTypes while we're here. Finally, when processing optional content, do not emit an EMC if it is associated with optional content.
Diffstat (limited to 'doc')
-rw-r--r--doc/VectorDevices.htm20
1 files changed, 17 insertions, 3 deletions
diff --git a/doc/VectorDevices.htm b/doc/VectorDevices.htm
index 0266c1f64..e329b7912 100644
--- a/doc/VectorDevices.htm
+++ b/doc/VectorDevices.htm
@@ -755,9 +755,7 @@ usually result in a slightly larger PDF file.</dd>
There are a few annotation types which are not preserved, most notably Link and Widget annotations. However, should you wish to revert
to the old behaviour, or find that the new behaviour leads to problems, you can set this switch to false which will cause all annotations to be
inserted into the page content stream, instead of preserved as annotations.
-</dd>
-</dt>
-<d<p> In addition, finer control is available by defining an array
+<p> In addition, finer control is available by defining an array
<code>/PreserveAnnotTypes</code>. Annotation types listed in this array will
be preserved, whilst those not listed will be drawn according to the setting os ShowAnnots and ShowAnnotTypes.
By using the controls PreserveAnnots, PreserveAnnotTypes, ShowAnnots and ShowAnnotTypes it is possible to select
@@ -770,9 +768,25 @@ by annotation type whether annotations are preserved as annotations, drawn into
<p> For example, adding the follow to the command line:
<code>-c "/PreserveAnnotTypes [/Text /UnderLine] def" -f &ltinput file&gt</code>
<br> would preserve only annotations with the subtypes &quotText&quot and &quotUnderLine&quot</p>
+</dd>
+</dt>
</d1>
+<dl>
+<dt><code>-dPreserveMarkedContent=</code><em>boolean</em>
+<dd>We now attempt to preserve marked content from input PDF files through to the output PDF file (note, not in output PostScript!)
+This does not include marked content relating to optional content, because currently we do not preserve optional content, it is
+instead applied by the interpreter.
+<p>
+This control also requires the PDF interpreter to pass the marked content to the pdfwrite device, this is only done with the
+new (C-based) PDF interpreter. THe old (PostScript-based) interpreter does not support this feature and will not pass marked
+content to the pdfwrite device.
+</p>
+</dd>
+</dt>
<p>
+</dl>
+
The following options are useful for creating PDF 1.2 files:
<p>