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
|
/* Copyright (C) 2001-2012 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., 7 Mt. Lassen Drive - Suite A-134, San Rafael,
CA 94903, U.S.A., +1(415)492-9861, for further information.
*/
/* Definitions for implementing compositing functions */
#ifndef gxcomp_INCLUDED
# define gxcomp_INCLUDED
#include "gscompt.h"
#include "gsrefct.h"
#include "gxbitfmt.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 */
#ifndef gs_imager_state_DEFINED
# define gs_imager_state_DEFINED
typedef struct gs_imager_state_s gs_imager_state;
#endif
#ifndef gx_device_DEFINED
# define gx_device_DEFINED
typedef struct gx_device_s gx_device;
#endif
#ifndef gx_device_clist_writer_DEFINED
#define gx_device_clist_writer_DEFINED
typedef struct gx_device_clist_writer_s gx_device_clist_writer;
#endif
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_imager_state *pis, 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_imager_state *pis)
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 coides : <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)\
int 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 commutate 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_imager_state * pis, 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_imager_state * pis, 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 */
|