changeset 5167:97423d858a1a

Added an intro to the features and goals of the 2D rendering API.
author Sam Lantinga <slouken@libsdl.org>
date Thu, 03 Feb 2011 10:03:55 -0800
parents d72793305335
children 2b1989f59674
files include/SDL_render.h
diffstat 1 files changed, 17 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/include/SDL_render.h	Thu Feb 03 02:45:29 2011 -0800
+++ b/include/SDL_render.h	Thu Feb 03 10:03:55 2011 -0800
@@ -24,13 +24,29 @@
  *  \file SDL_render.h
  *  
  *  Header file for SDL 2D rendering functions.
+ *
+ *  This API supports the following features:
+ *      * single pixel points
+ *      * single pixel lines
+ *      * filled rectangles
+ *      * texture images
+ *
+ *  The primitives may be drawn in opaque, blended, or additive modes.
+ *
+ *  The texture images may be drawn in opaque, blended, or additive modes.
+ *  They can have an additional color tint or alpha modulation applied to
+ *  them, and may also be stretched with linear interpolation.
+ *
+ *  This API is designed to accelerate simple 2D operations. You may
+ *  want more functionality such as rotation and particle effects and
+ *  in that case you should use SDL's OpenGL/Direct3D support or one
+ *  of the many good 3D engines.
  */
 
 #ifndef _SDL_render_h
 #define _SDL_render_h
 
 #include "SDL_stdinc.h"
-//#include "SDL_pixels.h"
 #include "SDL_rect.h"
 #include "SDL_video.h"