summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKen Sharp <ken.sharp@artifex.com>2022-07-25 17:15:41 +0100
committerKen Sharp <ken.sharp@artifex.com>2022-07-25 17:15:41 +0100
commite292bb232c987c50671699a8dd8172c0d7adcfe3 (patch)
tree3a2578cbf0640267b65fc9c863b2f29978c1cd35 /doc
parentc5c5fea7e53435579e0692cfc937484cda298314 (diff)
downloadghostpdl-e292bb232c987c50671699a8dd8172c0d7adcfe3.tar.gz
TIFF devices - restore default MaxStripSize
Commit 0abc209b8460396cdece8fc824c053a2662c4cbf altered the default MaxStripSize from 8KB to 1MB, for all Tiff devices, even though it seems that only fax readers have a problem with multiple strip TIFF files. It also did not update the documentation which still stated the default was 8KB. After some discussion, it seems wrong that the default should have been altered, when the documentation points to the recommendation in the TIFF specification. Additionally the change was to a size of 1MB in the 'hope' that no fax page size would exceed that. Which is not a great way to handle the problem. This commit alters just the fax devices to have a default MaxStripSize of 0, which means the output will be written to a single strip, no matter how large, thus fulfilling the requirement to support poor fax reading software, but without affecting the non-fax devices, and more reliably because it doesn't matter how large the media is, even if it exceeds 1MB output we will still only get a single strip.. If the reader can't cope with a single huge strip, and wants multiple strips then the user can override the default by specifying MaxStripSize on the command line in order to restore multiple-strip output for fax devices. Updated the documentation to reflect this.
Diffstat (limited to 'doc')
-rw-r--r--doc/Devices.htm11
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/Devices.htm b/doc/Devices.htm
index 34c95b141..60c60776a 100644
--- a/doc/Devices.htm
+++ b/doc/Devices.htm
@@ -644,7 +644,7 @@ since readers need only store and process one strip at a time. The
<blockquote>
<dl>
-<dt><code>-dMaxStripSize=<em>N</em></code> (non-negative integer; default = 8192)</dt>
+<dt><code>-dMaxStripSize=<em>N</em></code> (non-negative integer; default = 8192, 0 on Fax devices)</dt>
<dd>Set the maximum (uncompressed) size of a strip.</dd>
</dl>
</blockquote>
@@ -852,6 +852,15 @@ The fax devices support the <code>MinFeatureSize</code> parameter as defined in
the TIFF device section.
</p>
+<p>
+It appears from this commit: 0abc209b8460396cdece8fc824c053a2662c4cbf that some (many ?)
+fax readers cannot cope with multiple strip TIFF files. The commit noted above works
+around this by assuming no fax output wil exceed 1MB. Unfrotunately it also altered
+<b>all</b> the TIFF devices' default strip size which we now think was inadvisable.
+
+The fax devices now use a MaxStripSize of 0 so that the file only contains a single strip.
+This can still be overridden by specifying MaxStripSize on the command line.
+</p>
<h3><a name="BMP"></a>BMP</h3>
<p>