glheader.h revision c1f859d4 
1/**
2 * \file glheader.h
3 * Top-most include file.
4 *
5 * This is the top-most include file of the Mesa sources.
6 * It includes gl.h and all system headers which are needed.
7 * Other Mesa source files should \e not directly include any system
8 * headers.  This allows system-dependent hacks/workarounds to be
9 * collected in one place.
10 *
11 * \note Actually, a lot of system-dependent stuff is now in imports.[ch].
12 *
13 * If you touch this file, everything gets recompiled!
14 *
15 * This file should be included before any other header in the .c files.
16 *
17 * Put compiler/OS/assembly pragmas and macros here to avoid
18 * cluttering other source files.
19 */
20
21/*
22 * Mesa 3-D graphics library
23 * Version:  6.5
24 *
25 * Copyright (C) 1999-2005  Brian Paul   All Rights Reserved.
26 *
27 * Permission is hereby granted, free of charge, to any person obtaining a
28 * copy of this software and associated documentation files (the "Software"),
29 * to deal in the Software without restriction, including without limitation
30 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
31 * and/or sell copies of the Software, and to permit persons to whom the
32 * Software is furnished to do so, subject to the following conditions:
33 *
34 * The above copyright notice and this permission notice shall be included
35 * in all copies or substantial portions of the Software.
36 *
37 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
38 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
39 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
40 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
41 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
42 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
43 */
44
45
46#ifndef GLHEADER_H
47#define GLHEADER_H
48
49#include <assert.h>
50#include <ctype.h>
51#if defined(__alpha__) && defined(CCPML)
52#include <cpml.h> /* use Compaq's Fast Math Library on Alpha */
53#else
54#include <math.h>
55#endif
56#include <limits.h>
57#include <stdlib.h>
58#include <stdio.h>
59#include <string.h>
60#if defined(__linux__) && defined(__i386__)
61#include <fpu_control.h>
62#endif
63#include <float.h>
64#include <stdarg.h>
65
66
67/* Get typedefs for uintptr_t and friends */
68#if defined(__MINGW32__) || defined(__NetBSD__)
69#  include <stdint.h>
70#elif defined(_WIN32)
71#  include <BaseTsd.h>
72#  if _MSC_VER == 1200
73     typedef UINT_PTR uintptr_t;
74#  endif
75#elif defined(__INTERIX)
76/* Interix 3.x has a gcc that shadows this. */
77#  ifndef _UINTPTR_T_DEFINED
78     typedef unsigned long uintptr_t;
79#  define _UINTPTR_T_DEFINED
80#  endif
81#else
82#  include <inttypes.h>
83#endif
84
85
86/* Sun compilers define __i386 instead of the gcc-style __i386__ */
87#ifdef __SUNPRO_C
88# if !defined(__i386__) && defined(__i386)
89#  define __i386__
90# elif !defined(__amd64__) && defined(__amd64)
91#  define __amd64__
92# elif !defined(__sparc__) && defined(__sparc)
93#  define __sparc__
94# endif
95# if !defined(__volatile)
96#  define __volatile volatile
97# endif
98#endif
99
100#if defined(_WIN32) && !defined(__WIN32__) && !defined(__CYGWIN__) && !defined(BUILD_FOR_SNAP)
101#  define __WIN32__
102#  define finite _finite
103#endif
104
105#if defined(__WATCOMC__)
106#  define finite _finite
107#  pragma disable_message(201) /* Disable unreachable code warnings */
108#endif
109
110#ifdef WGLAPI
111#	undef WGLAPI
112#endif
113
114#if !defined(OPENSTEP) && (defined(__WIN32__) && !defined(__CYGWIN__)) && !defined(BUILD_FOR_SNAP)
115#  if !defined(__GNUC__) /* mingw environment */
116#    pragma warning( disable : 4068 ) /* unknown pragma */
117#    pragma warning( disable : 4710 ) /* function 'foo' not inlined */
118#    pragma warning( disable : 4711 ) /* function 'foo' selected for automatic inline expansion */
119#    pragma warning( disable : 4127 ) /* conditional expression is constant */
120#    if defined(MESA_MINWARN)
121#      pragma warning( disable : 4244 ) /* '=' : conversion from 'const double ' to 'float ', possible loss of data */
122#      pragma warning( disable : 4018 ) /* '<' : signed/unsigned mismatch */
123#      pragma warning( disable : 4305 ) /* '=' : truncation from 'const double ' to 'float ' */
124#      pragma warning( disable : 4550 ) /* 'function' undefined; assuming extern returning int */
125#      pragma warning( disable : 4761 ) /* integral size mismatch in argument; conversion supplied */
126#    endif
127#  endif
128#  if (defined(_MSC_VER) || defined(__MINGW32__)) && defined(BUILD_GL32) /* tag specify we're building mesa as a DLL */
129#    define WGLAPI __declspec(dllexport)
130#  elif (defined(_MSC_VER) || defined(__MINGW32__)) && defined(_DLL) /* tag specifying we're building for DLL runtime support */
131#    define WGLAPI __declspec(dllimport)
132#  else /* for use with static link lib build of Win32 edition only */
133#    define WGLAPI __declspec(dllimport)
134#  endif /* _STATIC_MESA support */
135#endif /* WIN32 / CYGWIN bracket */
136
137
138/*
139 * Either define MESA_BIG_ENDIAN or MESA_LITTLE_ENDIAN.
140 * Do not use them unless absolutely necessary!
141 * Try to use a runtime test instead.
142 * For now, only used by some DRI hardware drivers for color/texel packing.
143 */
144#if defined(BYTE_ORDER) && defined(BIG_ENDIAN) && BYTE_ORDER == BIG_ENDIAN
145#if defined(__linux__)
146#include <byteswap.h>
147#define CPU_TO_LE32( x )	bswap_32( x )
148#elif defined(__APPLE__)
149#include <CoreFoundation/CFByteOrder.h>
150#define CPU_TO_LE32( x )	CFSwapInt32HostToLittle( x )
151#else /*__linux__ __APPLE__*/
152#include <sys/endian.h>
153#define CPU_TO_LE32( x )	bswap32( x )
154#endif /*__linux__*/
155#define MESA_BIG_ENDIAN 1
156#else
157#define CPU_TO_LE32( x )	( x )
158#define MESA_LITTLE_ENDIAN 1
159#endif
160#define LE32_TO_CPU( x )	CPU_TO_LE32( x )
161
162
163#define GL_GLEXT_PROTOTYPES
164#include "GL/gl.h"
165#include "GL/glext.h"
166
167
168#ifndef GL_FIXED
169#define GL_FIXED 0x140C
170#endif
171
172
173#ifndef GL_OES_point_size_array
174#define GL_POINT_SIZE_ARRAY_OES                                 0x8B9C
175#define GL_POINT_SIZE_ARRAY_TYPE_OES                            0x898A
176#define GL_POINT_SIZE_ARRAY_STRIDE_OES                          0x898B
177#define GL_POINT_SIZE_ARRAY_POINTER_OES                         0x898C
178#define GL_POINT_SIZE_ARRAY_BUFFER_BINDING_OES                  0x8B9F
179#endif
180
181
182#ifndef GL_OES_draw_texture
183#define GL_TEXTURE_CROP_RECT_OES  0x8B9D
184#endif
185
186
187#if !defined(CAPI) && defined(WIN32) && !defined(BUILD_FOR_SNAP)
188#define CAPI _cdecl
189#endif
190
191
192/* This is a macro on IRIX */
193#ifdef _P
194#undef _P
195#endif
196
197
198/* Turn off macro checking systems used by other libraries */
199#ifdef CHECK
200#undef CHECK
201#endif
202
203
204/* Create a macro so that asm functions can be linked into compilers other
205 * than GNU C
206 */
207#ifndef _ASMAPI
208#if defined(WIN32) && !defined(BUILD_FOR_SNAP)/* was: !defined( __GNUC__ ) && !defined( VMS ) && !defined( __INTEL_COMPILER )*/
209#define _ASMAPI __cdecl
210#else
211#define _ASMAPI
212#endif
213#ifdef	PTR_DECL_IN_FRONT
214#define	_ASMAPIP * _ASMAPI
215#else
216#define	_ASMAPIP _ASMAPI *
217#endif
218#endif
219
220#ifdef USE_X86_ASM
221#define _NORMAPI _ASMAPI
222#define _NORMAPIP _ASMAPIP
223#else
224#define _NORMAPI
225#define _NORMAPIP *
226#endif
227
228
229/* Function inlining */
230#if defined(__GNUC__)
231#  define INLINE __inline__
232#elif defined(__MSC__)
233#  define INLINE __inline
234#elif defined(_MSC_VER)
235#  define INLINE __inline
236#elif defined(__ICL)
237#  define INLINE __inline
238#elif defined(__INTEL_COMPILER)
239#  define INLINE inline
240#elif defined(__WATCOMC__) && (__WATCOMC__ >= 1100)
241#  define INLINE __inline
242#elif defined(__SUNPRO_C) && defined(__C99FEATURES__)
243#  define INLINE inline
244#  define __inline inline
245#  define __inline__ inline
246#elif (__STDC_VERSION__ >= 199901L) /* C99 */
247#  define INLINE inline
248#else
249#  define INLINE
250#endif
251
252
253/* If we build the library with gcc's -fvisibility=hidden flag, we'll
254 * use the PUBLIC macro to mark functions that are to be exported.
255 *
256 * We also need to define a USED attribute, so the optimizer doesn't
257 * inline a static function that we later use in an alias. - ajax
258 */
259#if defined(__GNUC__) && (__GNUC__ * 100 + __GNUC_MINOR__) >= 303
260#  define PUBLIC __attribute__((visibility("default")))
261#  define USED __attribute__((used))
262#else
263#  define PUBLIC
264#  define USED
265#endif
266
267
268/* Some compilers don't like some of Mesa's const usage */
269#ifdef NO_CONST
270#  define CONST
271#else
272#  define CONST const
273#endif
274
275
276#if !defined(_WIN32_WCE)
277#if defined(BUILD_FOR_SNAP) && defined(CHECKED)
278#  define ASSERT(X)   _CHECK(X)
279#elif defined(DEBUG)
280#  define ASSERT(X)   assert(X)
281#else
282#  define ASSERT(X)
283#endif
284#endif
285
286
287#if (!defined(__GNUC__) || __GNUC__ < 3) && (!defined(__IBMC__) || __IBMC__ < 900)
288#  define __builtin_expect(x, y) x
289#endif
290
291/* The __FUNCTION__ gcc variable is generally only used for debugging.
292 * If we're not using gcc, define __FUNCTION__ as a cpp symbol here.
293 * Don't define it if using a newer Windows compiler.
294 */
295#ifndef __FUNCTION__
296# if defined(__VMS)
297#  define __FUNCTION__ "VMS$NL:"
298# elif ((!defined __GNUC__) || (__GNUC__ < 2)) && (!defined __xlC__) && \
299      (!defined(_MSC_VER) || _MSC_VER < 1300)
300#  if (__STDC_VERSION__ >= 199901L) /* C99 */ || \
301    (defined(__SUNPRO_C) && defined(__C99FEATURES__))
302#   define __FUNCTION__ __func__
303#  else
304#   define __FUNCTION__ "<unknown>"
305#  endif
306# endif
307#endif
308
309
310#include "config.h"
311
312#endif /* GLHEADER_H */
313