blob: c18d1c064b77287209ab5d5d6b83e591b702df9f [file] [log] [blame]
Dees_Troy51a0e822012-09-05 15:24:24 -04001/*
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 */