diff options
| author | Robin Watts <Robin.Watts@artifex.com> | 2021-06-30 15:26:09 +0100 |
|---|---|---|
| committer | Robin Watts <Robin.Watts@artifex.com> | 2021-07-01 00:27:56 +0100 |
| commit | 8e1859c5fa8ff7af476e8317f8efc3f762c935cc (patch) | |
| tree | 97523332af4d8e149437e3991d1fcb2b4b117570 /doc | |
| parent | 2f7f448a4b73b8f996fa9196527da1db5cc520e2 (diff) | |
| download | ghostpdl-8e1859c5fa8ff7af476e8317f8efc3f762c935cc.tar.gz | |
Remove "unread" param from get_bits_rectangle.
No one sets it. No one reads it. It's pointless, so excise it.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/Drivers.htm | 21 |
1 files changed, 1 insertions, 20 deletions
diff --git a/doc/Drivers.htm b/doc/Drivers.htm index d0d1d38a4..4e9fb37a8 100644 --- a/doc/Drivers.htm +++ b/doc/Drivers.htm @@ -2851,8 +2851,7 @@ if the glyph can't be translated to Unicode.</p> <dl> <dt><code>int (*get_bits_rectangle)(gx_device *dev, -const gs_int_rect *prect, gs_get_bits_params_t *params, -gs_int_rect **unread)</code> <b><em>[OPTIONAL]</em></b></dt> +const gs_int_rect *prect, gs_get_bits_params_t *params)</code> <b><em>[OPTIONAL]</em></b></dt> <p><dd> Read a rectangle of bits back from the device. The <code>params</code> @@ -2967,24 +2966,6 @@ in each scan line are undefined. If the implementation returns pointers to the data, it stores them into <code>data[0]</code> or <code>data[</code><b><em>0..N-1</em></b><code>]</code>.</p> -<p> -If not all the source data are available (for example, because the source -was a partially obscured window and backing store was not available or not -used), or if the rectangle does not fall completely within the device's -coordinate system, any unread bits are undefined, and the value returned -depends on whether unread is <code>NULL</code>. If unread is -<code>NULL</code>, return <code>gs_error_ioerror</code>; in this case, -some bits may or may not have been read. If unread is not -<code>NULL</code>, allocate (using <code>dev</code>->memory) and -fill in a list of rectangles that could not be read, store the pointer to -the list in <code>*unread</code>, and return the number of rectangles; in -this case, all bits not listed in the rectangle list have been read back -properly. The list is not sorted in any particular order, but the -rectangles do not overlap. Note that the rectangle list may cover a -superset of the region actually obscured: for example, a lazy implementation -could return a single rectangle that was the bounding box of the region.</p> -</dl> - <h3><a name="Parameters"></a>Parameters</h3> <p> |