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
|
/* Copyright (C) 2001-2023 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., 39 Mesa Street, Suite 108A, San Francisco,
CA 94129, USA, for further information.
*/
/* Definitions for implementing compositing functions */
#ifndef gxcomp_INCLUDED
# define gxcomp_INCLUDED
#include "gscompt.h"
#include "gsrefct.h"
#include "gxbitfmt.h"
#include "gsdevice.h"
/*
* Because compositor information is passed through the command list,
* individual compositors must be identified by some means that is
* independent of address space. The address of the compositor method
* array, gs_composite_type_t (see below), cannot be used, as it is
* meaningful only within a single address space.
*
* In addition, it is desirable the keep the compositor identifier
* size as small as possible, as this identifier must be passed through
* the command list for all bands whenever the compositor is invoked.
* Fortunately, compositor invocation is not so frequent as to warrant
* byte-sharing techniques, which most likely would store the identifier
* in some unused bits of a command code byte. Hence, the smallest
* reasonable size for the identifier is one byte. This allows for up
* to 255 compositors, which should be ample (as of this writing, there
* are only two compositors, only one of which can be passed through
* the command list).
*
* The following list is intended to enumerate all compositors. We
* use definitions rather than an encoding to ensure a one-byte size.
*/
#define GX_COMPOSITOR_ALPHA 0x01 /* DPS/Next alpha compositor */
#define GX_COMPOSITOR_OVERPRINT 0x02 /* overprint/overprintmode compositor */
#define GX_COMPOSITOR_PDF14_TRANS 0x03 /* PDF 1.4 transparency compositor */
/*
* Define the abstract superclass for all compositing function types.
*/
/*typedef struct gs_composite_s gs_composite_t; *//* in gscompt.h */
typedef struct gx_device_clist_writer_s gx_device_clist_writer;
typedef struct gs_composite_type_procs_s {
/*
* Create the default compositor for a compositing function.
*/
#define composite_create_default_compositor_proc(proc)\
int proc(const gs_composite_t *pcte, gx_device **pcdev,\
gx_device *dev, gs_gstate *pgs, gs_memory_t *mem)
composite_create_default_compositor_proc((*create_default_compositor));
/*
* Test whether this function is equal to another one.
*/
#define composite_equal_proc(proc)\
bool proc(const gs_composite_t *pcte, const gs_composite_t *pcte2)
composite_equal_proc((*equal));
/*
* Convert the representation of this function to a string
* for writing in a command list. *psize is the amount of space
* available. If it is large enough, the procedure sets *psize
* to the amount used and returns 0; if it is not large enough,
* the procedure sets *psize to the amount needed and returns a
* rangecheck error; in the case of any other error, *psize is
* not changed.
*/
#define composite_write_proc(proc)\
int proc(const gs_composite_t *pcte, byte *data, uint *psize, gx_device_clist_writer *cdev)
composite_write_proc((*write));
/*
* Convert the string representation of a function back to
* a structure, allocating the structure. Return the number of
* bytes read, or < 0 in the event of an error.
*/
#define composite_read_proc(proc)\
int proc(gs_composite_t **ppcte, const byte *data, uint size,\
gs_memory_t *mem)
composite_read_proc((*read));
/*
* Adjust CTM before applying the compositor. Used with banding.
*/
#define composite_adjust_ctm_proc(proc)\
int proc(gs_composite_t *pcte, int x0, int y0, gs_gstate *pgs)
composite_adjust_ctm_proc((*adjust_ctm));
/*
* Checks whether a next compositor operation closes this one.
* Must set the 2nd argument with a pointer to the opening compositor operation.
* Return codes : <0 - error, 0 - not closing,
* 1 - closing with annihilation, 2 - execute immediately,
* 3 - closing and replacing, 4 - replace one, 5 - drop queue.
*/
#define composite_is_closing_proc(proc)\
gs_compositor_closing_state proc(const gs_composite_t *this, gs_composite_t **pcte, gx_device *dev)
composite_is_closing_proc((*is_closing));
/*
* Checks whether a next operation is friendly to the compositor
* so that it may commute with the compositor operation.
*/
#define composite_is_friendly_proc(proc)\
bool proc(const gs_composite_t *this, byte cmd0, byte cmd1)
composite_is_friendly_proc((*is_friendly));
/*
* Update the clist write device when a compositor device is created.
*/
#define composite_clist_write_update(proc)\
int proc(const gs_composite_t * pcte, gx_device * dev, gx_device ** pcdev,\
gs_gstate * pgs, gs_memory_t * mem)
composite_clist_write_update((*clist_compositor_write_update));
/*
* Update the clist read device when a compositor device is created.
*/
#define composite_clist_read_update(proc)\
int proc(gs_composite_t * pcte, gx_device * cdev, gx_device * tdev,\
gs_gstate * pgs, gs_memory_t * mem)
composite_clist_read_update((*clist_compositor_read_update));
/*
* Get compositor cropping.
*/
#define composite_get_cropping_proc(proc)\
int proc(const gs_composite_t * pcte, int *ry, int *rheight, int cropping_min, int cropping_max)
composite_get_cropping_proc((*get_cropping));
} gs_composite_type_procs_t;
typedef struct gs_composite_type_s {
byte comp_id; /* to identify compositor passed through command list */
gs_composite_type_procs_t procs;
} gs_composite_type_t;
/*
* Default implementation for creating a compositor for clist writing.
* The default does nothing.
*/
composite_clist_write_update(gx_default_composite_clist_write_update);
/* Default handler for adjusting a compositor's CTM. */
composite_adjust_ctm_proc(gx_default_composite_adjust_ctm);
/* Default check for closing compositor. */
composite_is_closing_proc(gx_default_composite_is_closing);
/* Default check for a friendly command to a compositor. */
composite_is_friendly_proc(gx_default_composite_is_friendly);
/*
* Default implementation for adjusting the clist reader when a compositor
* device is added. The default does nothing.
*/
composite_clist_read_update(gx_default_composite_clist_read_update);
/*
* Default implementation for get_cropping doesn't return a cropping.
*/
composite_get_cropping_proc(gx_default_composite_get_cropping);
/*
* Compositing objects are reference-counted, because graphics states will
* eventually reference them. Note that the common part has no
* garbage-collectible pointers and is never actually instantiated, so no
* structure type is needed for it.
*/
#define gs_composite_common\
const gs_composite_type_t *type;\
gs_id id; /* see gscompt.h */\
bool idle; /* Doesn't paint anything. */\
struct gs_composite_s *prev, *next /* Queue links for clist_playback_band. */
struct gs_composite_s {
gs_composite_common;
};
/* Replace a procedure with a macro. */
#define gs_composite_id(pcte) ((pcte)->id)
#endif /* gxcomp_INCLUDED */
|
