annotate include/SDL_getenv.h @ 1295:c3e36ac8a94c

Date: Sun, 6 Mar 2005 17:06:20 +0100 From: Per Inge Mathisen Subject: [SDL] Fullscreen refresh on win32 Windows has a terrible default for fullscreen 3D apps of 60mhz refresh rate. This can be fixed by the user by going into his driver's control panel and forcing the refresh rate higher. However, this not a very user friendly way about it, and in any case SDL contains no code that could figure out this that condition has afflicted the user. So the question is, could SDL fix this for the user? It is possible under Windows to request a higher refresh rate. The danger is of course that if the user has an old monitor, and you request a too high refresh rate, the monitor could be damaged. However, I believe there might be a way around that: Check before switching what refresh rate the user's desktop runs in, and if our fullscreen dimensions are equal or less than those of the desktop, use the higher refresh rate of 60 and the desktop rate. Since most users run their desktops in the same or higher resolution something sane, this should fix this problem for most users. Thoughts? An alternative is to add an SDL_GL_GetAttribute(SDL_GL_REFRESH_RATE) option so that programs can bitch at their users at their own convenience. - Per
author Sam Lantinga <slouken@libsdl.org>
date Mon, 30 Jan 2006 06:56:10 +0000
parents 088b806d877e
children c9b51268668f
rev   line source
1277
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
1 /*
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
2 SDL - Simple DirectMedia Layer
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
3 Copyright (C) 1997-2004 Sam Lantinga
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
4
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
5 This library is free software; you can redistribute it and/or
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
6 modify it under the terms of the GNU Library General Public
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
7 License as published by the Free Software Foundation; either
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
8 version 2 of the License, or (at your option) any later version.
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
9
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
10 This library is distributed in the hope that it will be useful,
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
13 Library General Public License for more details.
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
14
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
15 You should have received a copy of the GNU Library General Public
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
16 License along with this library; if not, write to the Free
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
18
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
19 Sam Lantinga
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
20 slouken@libsdl.org
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
21 */
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
22
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
23 #ifdef SAVE_RCSID
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
24 static char rcsid =
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
25 "@(#) $Id$";
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
26 #endif
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
27
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
28 #ifndef _SDL_getenv_h
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
29 #define _SDL_getenv_h
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
30
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
31 #include "begin_code.h"
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
32 /* Set up for C function definitions, even when using C++ */
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
33 #ifdef __cplusplus
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
34 extern "C" {
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
35 #endif
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
36
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
37 /* Not all environments have a working getenv()/putenv() */
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
38
1268
f098b247299d Use Win32 API for putenv/getenv to avoid C runtime conflicts
Sam Lantinga <slouken@libsdl.org>
parents: 337
diff changeset
39 #if defined(macintosh) || defined(WIN32) || defined(_WIN32_WCE)
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
40 #define NEED_SDL_GETENV
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
41 #endif
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
42
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
43 #ifdef NEED_SDL_GETENV
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
44
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
45 /* Put a variable of the form "name=value" into the environment */
337
9154ec9ca3d2 Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents: 0
diff changeset
46 extern DECLSPEC int SDLCALL SDL_putenv(const char *variable);
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
47 #define putenv(X) SDL_putenv(X)
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
48
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
49 /* Retrieve a variable named "name" from the environment */
337
9154ec9ca3d2 Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents: 0
diff changeset
50 extern DECLSPEC char * SDLCALL SDL_getenv(const char *name);
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
51 #define getenv(X) SDL_getenv(X)
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
52
1277
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
53 #endif /* NEED_GETENV */
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
54
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
55 /* Ends C function definitions when using C++ */
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
56 #ifdef __cplusplus
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
57 }
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
58 #endif
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
59 #include "close_code.h"
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
60
1277
088b806d877e *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 1268
diff changeset
61 #endif /* _SDL_getenv_h */