1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
/* Copyright (C) 2001-2021 Artifex Software, Inc.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied,
modified or distributed except as expressly authorized under the terms
of the license contained in the file LICENSE in this distribution.
Refer to licensing information at http://www.artifex.com or contact
Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato,
CA 94945, U.S.A., +1(415)492-9861, for further information.
*/
/* Rest of (client) halftone definitions */
#ifndef gxht_INCLUDED
# define gxht_INCLUDED
#include "gsht1.h"
#include "gsrefct.h"
#include "gxhttype.h"
#include "gxtmap.h"
#include "gscspace.h"
/*
* Halftone types. Note that for this implementation there are only
* spot functions, thresholds, and multi-component halftones; the peculiar
* colored halftones supported by PostScript (HalftoneType's 2 and 4) are
* not supported.
*
* NB1: While this code supports relocation of the client data, it will not
* free that data when the halftone is released. The client must handle
* that task directly.
*
* NB2: The garbage collection code will deal with the user provided data as
* a structure pointer allocated on the heap. The client must make
* certain this is the case.
*
* There is, somewhat unfortunately, no identifier applied to these
* halftones. This reflects the origin of this graphics library as a set
* of routines for use by a PostScript interpreter.
*
* In PostScript, halftone objects do not exist in an identified form outside
* of the graphic state. Though Level 2 and PostScript 3 support halftone
* dictionaries, these are neither read-only structures nor tagged
* by a unique identifier. Hence, they are not suitable for use as cache keys.
* Caching of halftones for PostScript is confined to the graphic state,
* and this holds true for the graphic library as well.
*
* Note also that implementing a generalized halftone cache is not trivial,
* as the device-specific representation of spot halftones depends on the
* default transformation for the device, and more generally the device
* specific representation of halftones may depend on the sense of the device
* (additive or subtract). Hence, a halftone cache would need to be keyed
* by device. (This is not an issue when caching halftones in the graphic
* state as the device is also a component of the graphic state).
*/
/*
* Note that the transfer_closure members will replace transfer sometime
* in the future. For the moment, transfer_closure is only used if
* transfer = 0.
*/
/* Type 1 halftone. This is just a Level 1 halftone with */
/* a few extra members. */
typedef struct gs_spot_halftone_s {
gs_screen_halftone screen;
bool accurate_screens;
gs_mapping_proc transfer; /* OBSOLETE */
gs_mapping_closure_t transfer_closure;
} gs_spot_halftone;
#define st_spot_halftone_max_ptrs st_screen_halftone_max_ptrs + 1
/* Define common elements for Type 3 and extended Type 3 halftones. */
#define GS_THRESHOLD_HALFTONE_COMMON\
int width;\
int height;\
gs_mapping_closure_t transfer_closure
typedef struct gs_threshold_halftone_common_s {
GS_THRESHOLD_HALFTONE_COMMON;
} gs_threshold_halftone_common;
/* Type 3 halftone. */
typedef struct gs_threshold_halftone_s {
GS_THRESHOLD_HALFTONE_COMMON; /* must be first */
gs_const_string thresholds;
gs_mapping_proc transfer;
} gs_threshold_halftone;
#define st_threshold_halftone_max_ptrs 2
/* Extended Type 3 halftone. */
typedef struct gs_threshold2_halftone_s {
GS_THRESHOLD_HALFTONE_COMMON; /* must be first */
int width2;
int height2;
int bytes_per_sample; /* 1 or 2 */
gs_const_bytestring thresholds; /* nota bene */
gs_mapping_proc transfer;
} gs_threshold2_halftone;
/* Client-defined halftone that generates a halftone order. */
typedef struct gs_client_order_halftone_s gs_client_order_halftone;
typedef struct gx_ht_order_s gx_ht_order;
typedef struct gs_client_order_ht_procs_s {
/*
* Allocate and fill in the order. gx_ht_alloc_client_order
* (see gzht.h) does everything but fill in the actual data.
*/
int (*create_order) (gx_ht_order * porder,
gs_gstate * pgs,
const gs_client_order_halftone * phcop,
gs_memory_t * mem);
} gs_client_order_ht_procs_t;
struct gs_client_order_halftone_s {
int width;
int height;
int num_levels;
const gs_client_order_ht_procs_t *procs;
const void *client_data;
gs_mapping_closure_t transfer_closure;
};
#define st_client_order_halftone_max_ptrs 2
/* Define the elements of a Type 5 halftone. */
typedef struct gs_halftone_component_s {
int comp_number;
int cname;
gs_halftone_type type;
union {
gs_spot_halftone spot; /* Type 1 */
gs_threshold_halftone threshold; /* Type 3 */
gs_threshold2_halftone threshold2; /* Extended Type 3 */
gs_client_order_halftone client_order; /* client order */
} params;
} gs_halftone_component;
extern_st(st_halftone_component);
#define public_st_halftone_component() /* in gsht1.c */\
gs_public_st_composite(st_halftone_component, gs_halftone_component,\
"gs_halftone_component", halftone_component_enum_ptrs,\
halftone_component_reloc_ptrs)
extern_st(st_ht_component_element);
#define public_st_ht_component_element() /* in gsht1.c */\
gs_public_st_element(st_ht_component_element, gs_halftone_component,\
"gs_halftone_component[]", ht_comp_elt_enum_ptrs, ht_comp_elt_reloc_ptrs,\
st_halftone_component)
#define st_halftone_component_max_ptrs\
max(max(st_spot_halftone_max_ptrs, st_threshold_halftone_max_ptrs),\
st_client_order_halftone_max_ptrs)
/* Define the Type 5 halftone itself. */
typedef struct gs_multiple_halftone_s {
gs_halftone_component *components;
uint num_comp;
int (*get_colorname_string)(gs_gstate *pgs, gs_separation_name colorname_index,
unsigned char **ppstr, unsigned int *pname_size);
} gs_multiple_halftone;
#define st_multiple_halftone_max_ptrs 1
/*
* The halftone stored in the graphics state is the union of
* setscreen, setcolorscreen, Type 1, Type 3, and Type 5.
*
* NOTE: it is assumed that all subsidiary structures of halftones (the
* threshold array(s) for Type 3 halftones or halftone components, and the
* components array for Type 5 halftones) are allocated with the same
* allocator as the halftone structure itself.
*/
struct gs_halftone_s {
gs_halftone_type type;
rc_header rc;
union {
gs_screen_halftone screen; /* setscreen */
gs_colorscreen_halftone colorscreen; /* setcolorscreen */
gs_spot_halftone spot; /* Type 1 */
gs_threshold_halftone threshold; /* Type 3 */
gs_threshold2_halftone threshold2; /* Extended Type 3 */
gs_client_order_halftone client_order; /* client order */
gs_multiple_halftone multiple; /* Type 5 */
} params;
};
extern_st(st_halftone);
#define public_st_halftone() /* in gsht.c */\
gs_public_st_composite(st_halftone, gs_halftone, "gs_halftone",\
halftone_enum_ptrs, halftone_reloc_ptrs)
#define st_halftone_max_ptrs\
max(max(st_screen_halftone_max_ptrs, st_colorscreen_halftone_max_ptrs),\
max(max(st_spot_halftone_max_ptrs, st_threshold_halftone_max_ptrs),\
max(st_client_order_halftone_max_ptrs,\
st_multiple_halftone_max_ptrs)))
/* Procedural interface for AccurateScreens */
/*
* Set/get the default AccurateScreens value (for set[color]screen).
*/
void gs_setaccuratescreens(gs_memory_t *, bool);
bool gs_currentaccuratescreens(gs_memory_t *);
/* Initiate screen sampling with optional AccurateScreens. */
int gs_screen_init_memory(gs_screen_enum *, gs_gstate *,
gs_screen_halftone *, bool, gs_memory_t *);
#define gs_screen_init_accurate(penum, pgs, phsp, accurate)\
gs_screen_init_memory(penum, pgs, phsp, accurate, pgs->memory)
/* Procedural interface for MinScreenLevels (a Ghostscript extension) */
/*
* Set/get the MinScreenLevels value.
*/
void gs_setminscreenlevels(gs_memory_t *, uint);
uint gs_currentminscreenlevels(gs_memory_t *);
#endif /* gxht_INCLUDED */
|