1/*
2 * Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26/*
27 * This file provides some global definitions needed by the image
28 * conversion package.
29 */
30
31#ifndef IMAGE_GLOBALS_H
32#define IMAGE_GLOBALS_H
33
34#include "jni.h"
35
36/* Image Conversion function return codes. */
37#define SCALEFAILURE -1
38#define SCALENOOP 0
39#define SCALESUCCESS 1
40
41/*
42 * The constants needed to choose from among the many variants of image
43 * conversion functions that can be constructed with the standard header
44 * files. The types of input for the image conversion functions are
45 * broken down into 5 different attributes each with 2 to 4 different
46 * variants:
47 *
48 * SCALING: SCALED or UNSCALED
49 * INPUT SIZE: BYTEIN (8-bit) or INTIN (32-bit)
50 * ALPHA: OPAQUE or ALPHA
51 * ORDER: TDLR or RANDOM
52 * COLORMODEL: ICM, DCM, DCM8 (8-bits for each component) or ANY
53 *
54 * For each attribute, a mask is defined with the "BITS" suffix which
55 * identifies which bits contain the variation information for that
56 * particular attribute. The input information should be analyzed and
57 * characterized for each of the above categories and the appropriate
58 * bit constants OR'd together to produce a unique constant that
59 * identifies which conversion function is needed. The reason that
60 * attributes of the output space are not indicated in the masks is
61 * that typically only a single output device type needs to be supported
62 * at a time and so a vector of the functions specific to the necessary
63 * output device can be constructed at AWT initialization time and then
64 * indexed into with the constant identifier that characterizes the
65 * input data, which is only known and constantly varies at run-time.
66 */
67#define IMGCV_UNSCALED (0 << 0)
68#define IMGCV_SCALED (1 << 0)
69#define IMGCV_SCALEBITS (1 << 0)
70#define IMGCV_BYTEIN (0 << 1)
71#define IMGCV_INTIN (1 << 1)
72#define IMGCV_INSIZEBITS (1 << 1)
73#define IMGCV_OPAQUE (0 << 2)
74#define IMGCV_ALPHA (1 << 2)
75#define IMGCV_ALPHABITS (1 << 2)
76#define IMGCV_TDLRORDER (0 << 3)
77#define IMGCV_RANDORDER (1 << 3)
78#define IMGCV_ORDERBITS (1 << 3)
79#define IMGCV_ICM (0 << 4)
80#define IMGCV_DCM (1 << 4)
81#define IMGCV_DCM8 (2 << 4)
82#define IMGCV_ANYCM (3 << 4)
83#define IMGCV_CMBITS (3 << 4)
84
85#define NUM_IMGCV (1 << 6) /* total # of IMGCV variants */
86
87/*
88 * The structure which holds the image conversion data.
89 */
90typedef struct {
91 void *outbuf;
92 void *maskbuf;
93 void *fserrors;
94} ImgConvertData;
95
96/*
97 * The standard structure which holds information about the pixels
98 * used in the output device.
99 */
100typedef struct {
101 int grayscale;
102 int bitsperpixel;
103 int rOff;
104 int gOff;
105 int bOff;
106 int rScale;
107 int gScale;
108 int bScale;
109} ImgColorData;
110
111/*
112 * The private data member attached to a ColorModel which caches
113 * the information needed to characterize and use a ColorModel
114 * object on the fly.
115 */
116typedef struct {
117 int type;
118 struct methodblock *mb;
119} ImgCMData;
120
121/*
122 * The standard signature of all of the image conversion functions
123 * that can be produced with this package of include files.
124 */
125
126/*
127 * FIXME!
128 */
129typedef int ImgConvertFcn(void *colormodel,
130 int srcOX, int srcOY, int srcW, int srcH,
131 void *srcpix, int srcOff, int srcBPP, int srcScan,
132 int srcTotalWidth, int srcTotalHeight,
133 int dstTotalWidth, int dstTotalHeight,
134 ImgConvertData *cvdata, ImgColorData *clrdata);
135
136/*
137 * The type of the error matrix used in the ordered dithering code.
138 */
139typedef unsigned char uns_ordered_dither_array[8][8];
140typedef char sgn_ordered_dither_array[8][8];
141
142/*
143 * The function provided for constructing the ordered dithering error
144 * matrices based on a given quantum (i.e. the amplitude of the maximum
145 * error values appearing in the matrix which should be the same as the
146 * distance between adjacent allocated component values in the color cube).
147 */
148JNIEXPORT void JNICALL
149make_uns_ordered_dither_array(uns_ordered_dither_array oda,
150 int quantum);
151extern void make_sgn_ordered_dither_array(char* oda, int errmin, int errmax);
152
153/*
154 * The function provided for calculating the contents of the ImgCMData
155 * structure which can be attached to ColorModels to simplify the
156 * work of characterizing their data.
157 */
158extern ImgCMData *img_getCMData(void *cmh);
159
160#endif /* IMAGE_GLOBALS_H */
161