1 /* |
|
2 * jconfig.doc |
|
3 * |
|
4 * Copyright (C) 1991-1994, Thomas G. Lane. |
|
5 * This file is part of the Independent JPEG Group's software. |
|
6 * For conditions of distribution and use, see the accompanying README file. |
|
7 * |
|
8 * This file documents the configuration options that are required to |
|
9 * customize the JPEG software for a particular system. |
|
10 * |
|
11 * The actual configuration options for a particular installation are stored |
|
12 * in jconfig.h. On many machines, jconfig.h can be generated automatically |
|
13 * or copied from one of the "canned" jconfig files that we supply. But if |
|
14 * you need to generate a jconfig.h file by hand, this file tells you how. |
|
15 * |
|
16 * DO NOT EDIT THIS FILE --- IT WON'T ACCOMPLISH ANYTHING. |
|
17 * EDIT A COPY NAMED JCONFIG.H. |
|
18 */ |
|
19 |
|
20 |
|
21 /* |
|
22 * These symbols indicate the properties of your machine or compiler. |
|
23 * #define the symbol if yes, #undef it if no. |
|
24 */ |
|
25 |
|
26 /* Does your compiler support function prototypes? |
|
27 * (If not, you also need to use ansi2knr, see install.doc) |
|
28 */ |
|
29 #define HAVE_PROTOTYPES |
|
30 |
|
31 /* Does your compiler support the declaration "unsigned char" ? |
|
32 * How about "unsigned short" ? |
|
33 */ |
|
34 #define HAVE_UNSIGNED_CHAR |
|
35 #define HAVE_UNSIGNED_SHORT |
|
36 |
|
37 /* Define "void" as "char" if your compiler doesn't know about type void. |
|
38 * NOTE: be sure to define void such that "void *" represents the most general |
|
39 * pointer type, e.g., that returned by malloc(). |
|
40 */ |
|
41 /* #define void char */ |
|
42 |
|
43 /* Define "const" as empty if your compiler doesn't know the "const" keyword. |
|
44 */ |
|
45 /* #define const */ |
|
46 |
|
47 /* Define this if an ordinary "char" type is unsigned. |
|
48 * If you're not sure, leaving it undefined will work at some cost in speed. |
|
49 * If you defined HAVE_UNSIGNED_CHAR then the speed difference is minimal. |
|
50 */ |
|
51 #undef CHAR_IS_UNSIGNED |
|
52 |
|
53 /* Define this if your system has an ANSI-conforming <stddef.h> file. |
|
54 */ |
|
55 #define HAVE_STDDEF_H |
|
56 |
|
57 /* Define this if your system has an ANSI-conforming <stdlib.h> file. |
|
58 */ |
|
59 #define HAVE_STDLIB_H |
|
60 |
|
61 /* Define this if your system does not have an ANSI/SysV <string.h>, |
|
62 * but does have a BSD-style <strings.h>. |
|
63 */ |
|
64 #undef NEED_BSD_STRINGS |
|
65 |
|
66 /* Define this if your system does not provide typedef size_t in any of the |
|
67 * ANSI-standard places (stddef.h, stdlib.h, or stdio.h), but places it in |
|
68 * <sys/types.h> instead. |
|
69 */ |
|
70 #undef NEED_SYS_TYPES_H |
|
71 |
|
72 /* For 80x86 machines, you need to define NEED_FAR_POINTERS, |
|
73 * unless you are using a large-data memory model or 80386 flat-memory mode. |
|
74 * On less brain-damaged CPUs this symbol must not be defined. |
|
75 * (Defining this symbol causes large data structures to be referenced through |
|
76 * "far" pointers and to be allocated with a special version of malloc.) |
|
77 */ |
|
78 #undef NEED_FAR_POINTERS |
|
79 |
|
80 /* Define this if your linker needs global names to be unique in less |
|
81 * than the first 15 characters. |
|
82 */ |
|
83 #undef NEED_SHORT_EXTERNAL_NAMES |
|
84 |
|
85 /* Although a real ANSI C compiler can deal perfectly well with pointers to |
|
86 * unspecified structures (see "incomplete types" in the spec), a few pre-ANSI |
|
87 * and pseudo-ANSI compilers get confused. To keep one of these bozos happy, |
|
88 * define INCOMPLETE_TYPES_BROKEN. This is not recommended unless you |
|
89 * actually get "missing structure definition" warnings or errors while |
|
90 * compiling the JPEG code. |
|
91 */ |
|
92 #undef INCOMPLETE_TYPES_BROKEN |
|
93 |
|
94 |
|
95 /* |
|
96 * The following options affect code selection within the JPEG library, |
|
97 * but they don't need to be visible to applications using the library. |
|
98 * To minimize application namespace pollution, the symbols won't be |
|
99 * defined unless JPEG_INTERNALS has been defined. |
|
100 */ |
|
101 |
|
102 #ifdef JPEG_INTERNALS |
|
103 |
|
104 /* Define this if your compiler implements ">>" on signed values as a logical |
|
105 * (unsigned) shift; leave it undefined if ">>" is a signed (arithmetic) shift, |
|
106 * which is the normal and rational definition. |
|
107 */ |
|
108 #undef RIGHT_SHIFT_IS_UNSIGNED |
|
109 |
|
110 |
|
111 #endif /* JPEG_INTERNALS */ |
|
112 |
|
113 |
|
114 /* |
|
115 * The remaining options do not affect the JPEG library proper, |
|
116 * but only the sample applications cjpeg/djpeg (see cjpeg.c, djpeg.c). |
|
117 * Other applications can ignore these. |
|
118 */ |
|
119 |
|
120 #ifdef JPEG_CJPEG_DJPEG |
|
121 |
|
122 /* These defines indicate which image (non-JPEG) file formats are allowed. */ |
|
123 |
|
124 #define BMP_SUPPORTED /* BMP image file format */ |
|
125 #define GIF_SUPPORTED /* GIF image file format */ |
|
126 #define PPM_SUPPORTED /* PBMPLUS PPM/PGM image file format */ |
|
127 #undef RLE_SUPPORTED /* Utah RLE image file format */ |
|
128 #define TARGA_SUPPORTED /* Targa image file format */ |
|
129 |
|
130 /* Define this if you want to name both input and output files on the command |
|
131 * line, rather than using stdout and optionally stdin. You MUST do this if |
|
132 * your system can't cope with binary I/O to stdin/stdout. See comments at |
|
133 * head of cjpeg.c or djpeg.c. |
|
134 */ |
|
135 #undef TWO_FILE_COMMANDLINE |
|
136 |
|
137 /* Define this if your system needs explicit cleanup of temporary files. |
|
138 * This is crucial under MS-DOS, where the temporary "files" may be areas |
|
139 * of extended memory; on most other systems it's not as important. |
|
140 */ |
|
141 #undef NEED_SIGNAL_CATCHER |
|
142 |
|
143 /* By default, we open image files with fopen(...,"rb") or fopen(...,"wb"). |
|
144 * This is necessary on systems that distinguish text files from binary files, |
|
145 * and is harmless on most systems that don't. If you have one of the rare |
|
146 * systems that complains about the "b" spec, define this symbol. |
|
147 */ |
|
148 #undef DONT_USE_B_MODE |
|
149 |
|
150 /* Define this if you want percent-done progress reports from cjpeg/djpeg. |
|
151 */ |
|
152 #undef PROGRESS_REPORT |
|
153 |
|
154 |
|
155 #endif /* JPEG_CJPEG_DJPEG */ |
|