diff include/SDL_hints.h @ 5193:82a48f4d65f6

Added a hint to determine whether framebuffer texture acceleration should be used, and added default behaviors for the various platforms.
author Sam Lantinga <slouken@libsdl.org>
date Sat, 05 Feb 2011 10:03:12 -0800
parents 6f6a9340fb93
children ef5a61ea3202
line wrap: on
line diff
--- a/include/SDL_hints.h	Sat Feb 05 10:02:39 2011 -0800
+++ b/include/SDL_hints.h	Sat Feb 05 10:03:12 2011 -0800
@@ -50,6 +50,22 @@
 /* *INDENT-ON* */
 #endif
 
+/**
+ *  \brief  A variable controlling how 3D acceleration is used to accelerate the SDL 1.2 screen surface. 
+ *
+ *  SDL can try to accelerate the SDL 1.2 screen surface by using streaming
+ *  textures with a 3D rendering engine.  This variable controls whether and
+ *  how this is done.
+ *
+ *  This variable can be set to the following values:
+ *    "0"       - Disable 3D acceleration
+ *    "1"       - Enable 3D acceleration, using the default renderer.
+ *    "X"       - Enable 3D acceleration, using X where X is one of the valid rendering drivers.  (e.g. "direct3d", "opengl", etc.)
+ *
+ *  By default SDL tries to make a best guess for each platform whether
+ *  to use acceleration or not.
+ */
+#define SDL_HINT_FRAMEBUFFER_ACCELERATION   "SDL_FRAMEBUFFER_ACCELERATION"
 
 
 /**