2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 // vid.h -- video driver defs
25 #define ENGINE_ICON ( (gamemode == GAME_NEXUIZ) ? nexuiz_xpm : darkplaces_xpm )
27 extern int cl_available;
29 typedef struct viddef_s
31 // these are set by VID_Mode
37 qboolean userefreshrate;
41 // these are used for state tracking
47 extern void (*vid_menudrawfn)(void);
48 extern void (*vid_menukeyfn)(int key);
50 extern qboolean vid_hidden;
51 extern qboolean vid_activewindow;
52 extern cvar_t vid_hardwaregammasupported;
53 extern qboolean vid_usinghwgamma;
54 extern qboolean vid_supportrefreshrate;
56 extern cvar_t vid_fullscreen;
57 extern cvar_t vid_width;
58 extern cvar_t vid_height;
59 extern cvar_t vid_bitsperpixel;
60 extern cvar_t vid_samples;
61 extern cvar_t vid_refreshrate;
62 extern cvar_t vid_userefreshrate;
63 extern cvar_t vid_vsync;
64 extern cvar_t vid_mouse;
65 extern cvar_t vid_grabkeyboard;
66 extern cvar_t vid_stick_mouse;
67 extern cvar_t vid_resizable;
68 extern cvar_t vid_minwidth;
69 extern cvar_t vid_minheight;
71 extern cvar_t gl_combine;
72 extern cvar_t gl_finish;
74 extern cvar_t v_gamma;
75 extern cvar_t v_contrast;
76 extern cvar_t v_brightness;
77 extern cvar_t v_color_enable;
78 extern cvar_t v_color_black_r;
79 extern cvar_t v_color_black_g;
80 extern cvar_t v_color_black_b;
81 extern cvar_t v_color_grey_r;
82 extern cvar_t v_color_grey_g;
83 extern cvar_t v_color_grey_b;
84 extern cvar_t v_color_white_r;
85 extern cvar_t v_color_white_g;
86 extern cvar_t v_color_white_b;
87 extern cvar_t v_hwgamma;
89 extern int gl_stencil;
91 // brand of graphics chip
92 extern const char *gl_vendor;
93 // graphics chip model and other information
94 extern const char *gl_renderer;
95 // begins with 1.0.0, 1.1.0, 1.2.0, 1.2.1, 1.3.0, 1.3.1, or 1.4.0
96 extern const char *gl_version;
97 // extensions list, space separated
98 extern const char *gl_extensions;
100 extern const char *gl_platform;
101 // another extensions list, containing platform-specific extensions that are
102 // not in the main list
103 extern const char *gl_platformextensions;
104 // name of driver library (opengl32.dll, libGL.so.1, or whatever)
105 extern char gl_driver[256];
107 // compatibility hacks
108 extern qboolean isG200;
109 extern qboolean isRagePro;
111 // LordHavoc: GLX_SGI_swap_control and WGL_EXT_swap_control
112 extern int gl_videosyncavailable;
114 void *GL_GetProcAddress(const char *name);
115 int GL_CheckExtension(const char *name, const dllfunction_t *funcs, const char *disableparm, int silent);
117 void VID_Shared_Init(void);
121 void VID_CheckExtensions(void);
123 void VID_Init (void);
126 void VID_Shutdown (void);
127 // Called at shutdown
129 int VID_SetMode (int modenum);
130 // sets the mode; only used by the Quake engine for resetting to mode 0 (the
131 // base mode) on memory allocation failures
133 int VID_InitMode(int fullscreen, int width, int height, int bpp, int refreshrate, int stereobuffer, int samples);
134 // allocates and opens an appropriate OpenGL context (and its window)
137 // sets hardware gamma correction, returns false if the device does not
138 // support gamma control
139 // (ONLY called by VID_UpdateGamma and VID_RestoreSystemGamma)
140 int VID_SetGamma(unsigned short *ramps, int rampsize);
141 // gets hardware gamma correction, returns false if the device does not
142 // support gamma control
143 // (ONLY called by VID_UpdateGamma and VID_RestoreSystemGamma)
144 int VID_GetGamma(unsigned short *ramps, int rampsize);
145 // makes sure ramp arrays are big enough and calls VID_GetGamma/VID_SetGamma
146 // (ONLY to be called from VID_Finish!)
147 void VID_UpdateGamma(qboolean force, int rampsize);
148 // turns off hardware gamma ramps immediately
149 // (called from various shutdown/deactivation functions)
150 void VID_RestoreSystemGamma(void);
152 void VID_GrabMouse (qboolean grab);
153 void VID_Finish (void);
155 void VID_Restart_f(void);
157 void VID_Start(void);
159 extern unsigned int vid_gammatables_serial; // so other subsystems can poll if gamma parameters have changed; this starts with 0 and gets increased by 1 each time the gamma parameters get changed and VID_BuildGammaTables should be called again
160 extern qboolean vid_gammatables_trivial; // this is set to true if all color control values are at default setting, and it therefore would make no sense to use the gamma table
161 void VID_BuildGammaTables(unsigned short *ramps, int rampsize); // builds the current gamma tables into an array (needs 3*rampsize items)