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
|
/* Copyright (C) 1996, 1997, 1998 Aladdin Enterprises. All rights
reserved. Unauthorized use, copying, and/or distribution
prohibited. */
/* pccrd.h - PCL interface to color rendering dictionaries */
#ifndef pccrd_INCLUDED
#define pccrd_INCLUDED
#include "gx.h"
#include "gsstruct.h"
#include "gsrefct.h"
#include "gsmatrix.h"
#include "gscspace.h"
#include "gscolor2.h"
#include "gscie.h"
#include "gscrd.h"
#include "pcident.h"
#include "pcstate.h"
/*
* In PCL, color rendering dictionaries are set by the device, but the
* default white point is specified by the language, and the white point
* may be modified by the language via the "View Illuminant" command.
*
* Though trivial in principle, this arrangement is a bit awkward for the
* graphic library as there is no make-unique functionality provided
* for color rendering dictionaries (none is necessary for PostScript as
* color rendering dictionaries may not be modified once they are set).
*
* This code hides some of the structure of the graphic library color
* rendering objects from the rest of the PCL code.
*/
/*
* The PCL id exists to provide an identifier for a color rendering
* dictionary. Having such an identifier is important to avoid the need
* to repeatedly re-insert the color rendering dictionary into the
* graphic state.
*
* The is_dflt_illum flag is used to optimize the case in which a CRD that
* already uses the default view illuminant is once again set to use this
* view illuminant.
*/
struct pcl_crd_s {
rc_header rc;
bool is_dflt_illum;
gs_cie_render * pgscrd;
};
#define private_st_crd_t() \
gs_private_st_ptrs1( st_crd_t, \
pcl_crd_t, \
"pcl color rendering dictionary", \
crd_enum_ptrs, \
crd_reloc_ptrs, \
pgscrd \
)
#ifndef pcl_crd_DEFINED
#define pcl_crd_DEFINED
typedef struct pcl_crd_s pcl_crd_t;
#endif
/*
* The usual copy, init, and release macros.
*/
#define pcl_crd_init_from(pto, pfrom) \
BEGIN \
rc_increment(pfrom); \
(pto) = (pfrom); \
END
#define pcl_crd_copy_from(pto, pfrom) \
BEGIN \
if ((pto) != (pfrom)) { \
rc_increment(pfrom); \
rc_decrement(pto, "pcl_crd_copy_from"); \
(pto) = (pfrom); \
} \
END
#define pcl_crd_release(pindexed) \
rc_decrement(pindexed, "pcl_crd_release")
/*
* Unlike other elements of the PCL "palette", color rendering dictionaries
* are for the most part not a feature that can be controlled from the language.
* Except for the white point, the parameters of a color rendering dictionary
* are determined by the output device rather than the language.
*
* To accommodate this situation, the device-specific or default color
* rendering dictionary is maintained as a global. When used to as part of a
* palette, this global should be "copied" using the copy_from macro provided
* below.
*/
extern pcl_crd_t * pcl_default_crd;
/*
* Build the default color rendering dictionary.
*
* This routine should be called only once, and then only when there is no
* current CRD.
*
* Returns 0 on success, < 0 in the event of an error.
*/
extern int pcl_crd_build_default_crd( pcl_state_t * pcs );
/*
* Build a CRD with device-provided parameters, but with the default PCL
* white point.
*
* Note that this is one of the few routines which accept a memory pointer
* operand but does not have it as the last operand.
*
* Any operands set to NULL will be given their graphic library defaults
* (which may not be the same as their values in the default PCL CRD).
*
* Returns 0 on success, < 0 in the event of an error.
*/
extern int pcl_crd_build_dev_crd(
gs_memory_t * pmem,
const gs_vector3 * BlackPoint,
const gs_matrix3 * MatrixPQR,
const gs_range3 * RangePQR,
const gs_cie_transform_proc3 * TransformPQR,
const gs_matrix3 * MatrixLMN,
const gs_cie_render_proc3 * EncodeLMN,
const gs_range3 * RangeLMN,
const gs_matrix3 * MatrixABC,
const gs_cie_render_proc3 * EncodeABC,
const gs_range3 * RangeABC,
const gs_cie_render_table_t * RenderTable
);
/*
* Set the viewing illuminant.
*
* Though this code goes through the motions of an "unshare" operation, it
* will almost always allocate a new structure, as the CRD will be referred
* to both by the palette and the graphic state.
*
* Returns 0 on success, < 0 in the event of an error.
*/
extern int pcl_crd_set_view_illuminant(
pcl_crd_t ** ppcrd,
const gs_vector3 * pwht_pt
);
/*
* Set a color rendering dictionary into the graphic state. If the rendering
* dictionary does not yet exist, create a default color rendering dictionary.
*
* Returns 0 on success, < 0 in the event of an error.
*/
extern int pcl_crd_set_crd( pcl_crd_t ** ppcrd, pcl_state_t * pcs );
#endif /* pccrd_INCLUDED */
|
