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
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
|
/* Copyright (C) 2003 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.
For more information about licensing, please refer to
http://www.ghostscript.com/licensing/. For information on
commercial licensing, go to http://www.artifex.com/licensing/ or
contact Artifex Software, Inc., 101 Lucas Valley Road #110,
San Rafael, CA 94903, U.S.A., +1(415)492-9861.
*/
/*$Id$ */
/* Include file for common DeviceN process color model devices. */
#ifndef gdevdevn_INCLUDED
# define gdevdevn_INCLUDED
/*
* Define the maximum number of spot colors supported by this device.
* This value is arbitrary. It is set simply to define a limit on
* on the separation_name_array and separation_order map.
*/
#define GX_DEVICE_MAX_SEPARATIONS 16
/*
* Define the maximum number of process model colorants. Currently we only
* have code for DeviceGray, DeviceRGB, and DeviceCMYK. Thus this value
* only needs to be 4. However we are allowing for a future hexachrome
* device. (This value does not include spot colors. See previous value.)
*/
#define MAX_DEVICE_PROCESS_COLORS 6
/*
* Type definitions associated with the fixed color model names.
*/
typedef const char * fixed_colorant_name;
typedef fixed_colorant_name * fixed_colorant_names_list;
/*
* Structure for holding SeparationNames elements.
*/
typedef struct gs_separations_s {
int num_separations;
const gs_param_string * names[GX_DEVICE_MAX_SEPARATIONS];
} gs_separations;
/*
* Structure for holding SeparationOrder elements.
*/
typedef struct gs_separation_order_s {
int num_names;
const gs_param_string *
names[GX_DEVICE_MAX_SEPARATIONS + MAX_DEVICE_PROCESS_COLORS];
} gs_separation_order;
/*
* Type for holding a separation order map
*/
typedef int gs_separation_map[GX_DEVICE_MAX_SEPARATIONS];
typedef struct gs_devn_params_s {
/*
* Bits per component (device colorant). Currently only 1 and 8 are
* supported.
*/
int bitspercomponent;
/*
* Pointer to the colorant names for the color model. This will be
* null if we have DeviceN type device. The actual possible colorant
* names are those in this list plus those in the separation[i].name
* list (below).
*/
fixed_colorant_names_list std_colorant_names;
int num_std_colorant_names; /* Number of names in list */
int max_separations; /* From MaxSeparation parameter */
/*
* Separation info (if any).
*/
gs_separations separations;
/*
* Separation Order (if specified).
*/
gs_separation_order separation_order;
/*
* The SeparationOrder parameter may change the logical order of
* components.
*/
gs_separation_map separation_order_map;
} gs_devn_params_t;
typedef gs_devn_params_t gs_devn_params;
extern fixed_colorant_name DeviceCMYKComponents[];
#include "gsequivc.h"
/*
* Utility routines for common DeviceN related parameters:
* SeparationColorNames, SeparationOrder, iand MaxSeparations
*/
/*
* Convert standard color spaces into DeviceN colorants.
* Note; This routine require SeparationOrder map.
*/
void gray_cs_to_devn_cm(gx_device * dev, int * map, frac gray, frac out[]);
void rgb_cs_to_devn_cm(gx_device * dev, int * map,
const gs_imager_state *pis, frac r, frac g, frac b, frac out[]);
void cmyk_cs_to_devn_cm(gx_device * dev, int * map,
frac c, frac m, frac y, frac k, frac out[]);
/*
* Possible values for the 'auto_spot_colors' parameter.
*/
/*
* Do not automatically include spot colors
*/
#define NO_AUTO_SPOT_COLORS 0
/*
* Automatically add spot colors up to the number that the device can image.
* Spot colors over that limit will be handled by the alternate color space
* for the Separation or DeviceN color space.
*/
#define ENABLE_AUTO_SPOT_COLORS 1
/*
* Automatically add spot colors up to the GX_DEVICE_MAX_SEPARATIONS value.
* Note; Spot colors beyond the number that the device can image will be
* ignored (i.e. treated like a colorant that is not specified by the
* SeparationOrder device parameter.
*/
#define ALLOW_EXTRA_SPOT_COLORS 2
/*
* This routine will check to see if the color component name match those
* that are available amoung the current device's color components.
*
* Parameters:
* dev - pointer to device data structure.
* pname - pointer to name (zero termination not required)
* nlength - length of the name
* component_type - separation name or not
* pdevn_params - pointer to device's DeviceN paramters
* pequiv_colors - pointer to equivalent color structure (may be NULL)
* auto_spot_colors - See comments above.
*
* This routine returns a positive value (0 to n) which is the device colorant
* number if the name is found. It returns GX_DEVICE_COLOR_MAX_COMPONENTS if
* the color component is found but is not being used due to the
* SeparationOrder parameter. It returns a negative value if not found.
*
* This routine will also add separations to the device if space is
* available.
*/
int devn_get_color_comp_index(const gx_device * dev,
gs_devn_params * pdevn_params, equivalent_cmyk_color_params * pequiv_colors,
const char * pname, int name_size, int component_type,
int auto_spot_colors);
/* Utility routine for getting DeviceN parameters */
int devn_get_params(gx_device * pdev, gs_param_list * plist,
gs_devn_params * pdevn_params,
equivalent_cmyk_color_params * pequiv_colors);
/*
* Utility routine for handling DeviceN related parameters. This routine
* assumes that the device is based upon a standard printer type device.
* (See the next routine if not.)
*
* Note that this routine requires a pointer to the DeviceN parameters within
* the device structure. The pointer to the equivalent_cmyk_color_params is
* optional (it should be NULL if this feature is not used by the device).
*/
int devn_printer_put_params(gx_device * pdev, gs_param_list * plist,
gs_devn_params * pdevn_params,
equivalent_cmyk_color_params * pequiv_colors);
/*
* Utility routine for handling DeviceN related parameters. This routine
* may modify the color_info, devn_params, and the * equiv_colors fields.
* The pointer to the equivalent_cmyk_color_params is optional (it should be
* NULL if this feature is not used by the device).
*
* Note: This routine does not restore values in case of a problem. This
* is left to the caller.
*/
int devn_put_params(gx_device * pdev, gs_param_list * plist,
gs_devn_params * pdevn_params,
equivalent_cmyk_color_params * pequiv_colors);
/*
* This routine will check to see if the color component name match those
* of either the process color model colorants or the names on the
* SeparationColorNames list.
*
* Parameters:
* dev - pointer to device data structure.
* pname - pointer to name (zero termination not required)
* nlength - length of the name
*
* This routine returns a positive value (0 to n) which is the device colorant
* number if the name is found. It returns a negative value if not found.
*/
int check_pcm_and_separation_names(const gx_device * dev,
const gs_devn_params * pparams, const char * pname,
int name_size, int component_type);
/*
* This routine will extract a specified set of bits from a buffer and pack
* them into a given buffer.
*
* Parameters:
* source - The source of the data
* dest - The destination for the data
* depth - The size of the bits per pixel - must be a multiple of 8
* first_bit - The location of the first data bit (LSB).
* bit_width - The number of bits to be extracted.
* npixel - The number of pixels.
*
* Returns:
* Length of the output line (in bytes)
* Data in dest.
*/
int repack_data(byte * source, byte * dest, int depth, int first_bit,
int bit_width, int npixel);
/*
* This utility routine calculates the number of bits required to store
* color information. In general the values are rounded up to an even
* byte boundary except those cases in which mulitple pixels can evenly
* into a single byte.
*
* The parameter are:
* ncomp - The number of components (colorants) for the device. Valid
* values are 1 to GX_DEVICE_COLOR_MAX_COMPONENTS
* bpc - The number of bits per component. Valid values are 1, 2, 4, 5,
* and 8.
* Input values are not tested for validity.
*/
int bpc_to_depth(int ncomp, int bpc);
#endif /* ifndef gdevdevn_INCLUDED */
|
