1 //
2 // "$Id$"
3 //
4 // OpenGL header file for the Fast Light Tool Kit (FLTK).
5 //
6 // Copyright 1998-2011 by Bill Spitzak and others.
7 //
8 // You must include this instead of GL/gl.h to get the Microsoft
9 // APIENTRY stuff included (from <windows.h>) prior to the OpenGL
10 // header files.
11 //
12 // This file also provides "missing" OpenGL functions, and
13 // gl_start() and gl_finish() to allow OpenGL to be used in any window
14 //
15 // This library is free software. Distribution and use rights are outlined in
16 // the file "COPYING" which should have been included with this file. If this
17 // file is missing or damaged, see the license at:
18 //
19 // http://www.fltk.org/COPYING.php
20 //
21 // Please report all bugs and problems on the following page:
22 //
23 // http://www.fltk.org/str.php
24 //
25
26 /** \file gl.h
27 * This file defines wrapper functions for OpenGL in FLTK
28 *
29 * To use OpenGL from within an FLTK application you MUST use gl_visual()
30 * to select the default visual before doing show() on any windows. Mesa
31 * will crash if yoy try to use a visual not returned by glxChooseVidual.
32 *
33 * This does not work with Fl_Double_Window's! It will try to draw
34 * into the front buffer. Depending on the system this will either
35 * crash or do nothing (when pixmaps are being used as back buffer
36 * and GL is being done by hardware), work correctly (when GL is done
37 * with software, such as Mesa), or draw into the front buffer and
38 * be erased when the buffers are swapped (when double buffer hardware
39 * is being used)
40 */
41
42 #ifndef FL_gl_H
43 # define FL_gl_H
44
45 # include "Enumerations.H" // for color names
46 # ifdef WIN32
47 # include <windows.h>
48 # endif
49 # ifndef APIENTRY
50 # if defined(__CYGWIN__)
51 # define APIENTRY __attribute__ ((__stdcall__))
52 # else
53 # define APIENTRY
54 # endif
55 # endif
56
57 # ifdef __APPLE__
58 # include <OpenGL/gl.h>
59 # else
60 # include <GL/gl.h>
61 # endif // __APPLE__
62
63 FL_EXPORT void gl_start();
64 FL_EXPORT void gl_finish();
65
66 FL_EXPORT void gl_color(Fl_Color i);
67 /** back compatibility */
gl_color(int c)68 inline void gl_color(int c) {gl_color((Fl_Color)c);}
69
70 FL_EXPORT void gl_rect(int x,int y,int w,int h);
71 /**
72 Fills the given rectangle with the current color.
73 \see gl_rect(int x, int y, int w, int h)
74 */
gl_rectf(int x,int y,int w,int h)75 inline void gl_rectf(int x,int y,int w,int h) {glRecti(x,y,x+w,y+h);}
76
77 FL_EXPORT void gl_font(int fontid, int size);
78 FL_EXPORT int gl_height();
79 FL_EXPORT int gl_descent();
80 FL_EXPORT double gl_width(const char *);
81 FL_EXPORT double gl_width(const char *, int n);
82 FL_EXPORT double gl_width(uchar);
83
84 FL_EXPORT void gl_draw(const char*);
85 FL_EXPORT void gl_draw(const char*, int n);
86 FL_EXPORT void gl_draw(const char*, int x, int y);
87 FL_EXPORT void gl_draw(const char*, float x, float y);
88 FL_EXPORT void gl_draw(const char*, int n, int x, int y);
89 FL_EXPORT void gl_draw(const char*, int n, float x, float y);
90 FL_EXPORT void gl_draw(const char*, int x, int y, int w, int h, Fl_Align);
91 FL_EXPORT void gl_measure(const char*, int& x, int& y);
92 #ifdef __APPLE__
93 extern FL_EXPORT void gl_texture_pile_height(int max);
94 extern FL_EXPORT int gl_texture_pile_height();
95 #endif
96
97 FL_EXPORT void gl_draw_image(const uchar *, int x,int y,int w,int h, int d=3, int ld=0);
98
99 #endif // !FL_gl_H
100
101 //
102 // End of "$Id$".
103 //
104