include/SDL_render.h
changeset 7191 75360622e65f
parent 7188 20bd120bf7e4
child 7239 04dda95ba22c
     1.1 --- a/include/SDL_render.h	Sat May 18 12:48:50 2013 -0700
     1.2 +++ b/include/SDL_render.h	Sat May 18 14:17:52 2013 -0700
     1.3 @@ -21,7 +21,7 @@
     1.4  
     1.5  /**
     1.6   *  \file SDL_render.h
     1.7 - *  
     1.8 + *
     1.9   *  Header file for SDL 2D rendering functions.
    1.10   *
    1.11   *  This API supports the following features:
    1.12 @@ -52,9 +52,7 @@
    1.13  #include "begin_code.h"
    1.14  /* Set up for C function definitions, even when using C++ */
    1.15  #ifdef __cplusplus
    1.16 -/* *INDENT-OFF* */
    1.17  extern "C" {
    1.18 -/* *INDENT-ON* */
    1.19  #endif
    1.20  
    1.21  /**
    1.22 @@ -62,10 +60,10 @@
    1.23   */
    1.24  typedef enum
    1.25  {
    1.26 -    SDL_RENDERER_SOFTWARE = 0x00000001,         /**< The renderer is a software fallback */ 
    1.27 -    SDL_RENDERER_ACCELERATED = 0x00000002,      /**< The renderer uses hardware 
    1.28 +    SDL_RENDERER_SOFTWARE = 0x00000001,         /**< The renderer is a software fallback */
    1.29 +    SDL_RENDERER_ACCELERATED = 0x00000002,      /**< The renderer uses hardware
    1.30                                                       acceleration */
    1.31 -    SDL_RENDERER_PRESENTVSYNC = 0x00000004,     /**< Present is synchronized 
    1.32 +    SDL_RENDERER_PRESENTVSYNC = 0x00000004,     /**< Present is synchronized
    1.33                                                       with the refresh rate */
    1.34      SDL_RENDERER_TARGETTEXTURE = 0x00000008     /**< The renderer supports
    1.35                                                       rendering to texture */
    1.36 @@ -130,28 +128,28 @@
    1.37  /* Function prototypes */
    1.38  
    1.39  /**
    1.40 - *  \brief Get the number of 2D rendering drivers available for the current 
    1.41 + *  \brief Get the number of 2D rendering drivers available for the current
    1.42   *         display.
    1.43 - *  
    1.44 + *
    1.45   *  A render driver is a set of code that handles rendering and texture
    1.46   *  management on a particular display.  Normally there is only one, but
    1.47   *  some drivers may have several available with different capabilities.
    1.48 - *  
    1.49 + *
    1.50   *  \sa SDL_GetRenderDriverInfo()
    1.51   *  \sa SDL_CreateRenderer()
    1.52   */
    1.53  extern DECLSPEC int SDLCALL SDL_GetNumRenderDrivers(void);
    1.54  
    1.55  /**
    1.56 - *  \brief Get information about a specific 2D rendering driver for the current 
    1.57 + *  \brief Get information about a specific 2D rendering driver for the current
    1.58   *         display.
    1.59 - *  
    1.60 + *
    1.61   *  \param index The index of the driver to query information about.
    1.62 - *  \param info  A pointer to an SDL_RendererInfo struct to be filled with 
    1.63 + *  \param info  A pointer to an SDL_RendererInfo struct to be filled with
    1.64   *               information on the rendering driver.
    1.65 - *  
    1.66 + *
    1.67   *  \return 0 on success, -1 if the index was out of range.
    1.68 - *  
    1.69 + *
    1.70   *  \sa SDL_CreateRenderer()
    1.71   */
    1.72  extern DECLSPEC int SDLCALL SDL_GetRenderDriverInfo(int index,
    1.73 @@ -175,14 +173,14 @@
    1.74  
    1.75  /**
    1.76   *  \brief Create a 2D rendering context for a window.
    1.77 - *  
    1.78 + *
    1.79   *  \param window The window where rendering is displayed.
    1.80 - *  \param index    The index of the rendering driver to initialize, or -1 to 
    1.81 + *  \param index    The index of the rendering driver to initialize, or -1 to
    1.82   *                  initialize the first one supporting the requested flags.
    1.83   *  \param flags    ::SDL_RendererFlags.
    1.84 - *  
    1.85 + *
    1.86   *  \return A valid rendering context or NULL if there was an error.
    1.87 - *  
    1.88 + *
    1.89   *  \sa SDL_CreateSoftwareRenderer()
    1.90   *  \sa SDL_GetRendererInfo()
    1.91   *  \sa SDL_DestroyRenderer()
    1.92 @@ -192,11 +190,11 @@
    1.93  
    1.94  /**
    1.95   *  \brief Create a 2D software rendering context for a surface.
    1.96 - *  
    1.97 + *
    1.98   *  \param surface The surface where rendering is done.
    1.99 - *  
   1.100 + *
   1.101   *  \return A valid rendering context or NULL if there was an error.
   1.102 - *  
   1.103 + *
   1.104   *  \sa SDL_CreateRenderer()
   1.105   *  \sa SDL_DestroyRenderer()
   1.106   */
   1.107 @@ -215,17 +213,17 @@
   1.108  
   1.109  /**
   1.110   *  \brief Create a texture for a rendering context.
   1.111 - *  
   1.112 + *
   1.113   *  \param renderer The renderer.
   1.114   *  \param format The format of the texture.
   1.115   *  \param access One of the enumerated values in ::SDL_TextureAccess.
   1.116   *  \param w      The width of the texture in pixels.
   1.117   *  \param h      The height of the texture in pixels.
   1.118 - *  
   1.119 - *  \return The created texture is returned, or 0 if no rendering context was 
   1.120 + *
   1.121 + *  \return The created texture is returned, or 0 if no rendering context was
   1.122   *          active,  the format was unsupported, or the width or height were out
   1.123   *          of range.
   1.124 - *  
   1.125 + *
   1.126   *  \sa SDL_QueryTexture()
   1.127   *  \sa SDL_UpdateTexture()
   1.128   *  \sa SDL_DestroyTexture()
   1.129 @@ -237,14 +235,14 @@
   1.130  
   1.131  /**
   1.132   *  \brief Create a texture from an existing surface.
   1.133 - *  
   1.134 + *
   1.135   *  \param renderer The renderer.
   1.136   *  \param surface The surface containing pixel data used to fill the texture.
   1.137 - *  
   1.138 + *
   1.139   *  \return The created texture is returned, or 0 on error.
   1.140 - *  
   1.141 + *
   1.142   *  \note The surface is not modified or freed by this function.
   1.143 - *  
   1.144 + *
   1.145   *  \sa SDL_QueryTexture()
   1.146   *  \sa SDL_DestroyTexture()
   1.147   */
   1.148 @@ -252,15 +250,15 @@
   1.149  
   1.150  /**
   1.151   *  \brief Query the attributes of a texture
   1.152 - *  
   1.153 + *
   1.154   *  \param texture A texture to be queried.
   1.155 - *  \param format  A pointer filled in with the raw format of the texture.  The 
   1.156 - *                 actual format may differ, but pixel transfers will use this 
   1.157 + *  \param format  A pointer filled in with the raw format of the texture.  The
   1.158 + *                 actual format may differ, but pixel transfers will use this
   1.159   *                 format.
   1.160   *  \param access  A pointer filled in with the actual access to the texture.
   1.161   *  \param w       A pointer filled in with the width of the texture in pixels.
   1.162   *  \param h       A pointer filled in with the height of the texture in pixels.
   1.163 - *  
   1.164 + *
   1.165   *  \return 0 on success, or -1 if the texture is not valid.
   1.166   */
   1.167  extern DECLSPEC int SDLCALL SDL_QueryTexture(SDL_Texture * texture,
   1.168 @@ -269,15 +267,15 @@
   1.169  
   1.170  /**
   1.171   *  \brief Set an additional color value used in render copy operations.
   1.172 - *  
   1.173 + *
   1.174   *  \param texture The texture to update.
   1.175   *  \param r       The red color value multiplied into copy operations.
   1.176   *  \param g       The green color value multiplied into copy operations.
   1.177   *  \param b       The blue color value multiplied into copy operations.
   1.178 - *  
   1.179 - *  \return 0 on success, or -1 if the texture is not valid or color modulation 
   1.180 + *
   1.181 + *  \return 0 on success, or -1 if the texture is not valid or color modulation
   1.182   *          is not supported.
   1.183 - *  
   1.184 + *
   1.185   *  \sa SDL_GetTextureColorMod()
   1.186   */
   1.187  extern DECLSPEC int SDLCALL SDL_SetTextureColorMod(SDL_Texture * texture,
   1.188 @@ -286,14 +284,14 @@
   1.189  
   1.190  /**
   1.191   *  \brief Get the additional color value used in render copy operations.
   1.192 - *  
   1.193 + *
   1.194   *  \param texture The texture to query.
   1.195   *  \param r         A pointer filled in with the current red color value.
   1.196   *  \param g         A pointer filled in with the current green color value.
   1.197   *  \param b         A pointer filled in with the current blue color value.
   1.198 - *  
   1.199 + *
   1.200   *  \return 0 on success, or -1 if the texture is not valid.
   1.201 - *  
   1.202 + *
   1.203   *  \sa SDL_SetTextureColorMod()
   1.204   */
   1.205  extern DECLSPEC int SDLCALL SDL_GetTextureColorMod(SDL_Texture * texture,
   1.206 @@ -302,13 +300,13 @@
   1.207  
   1.208  /**
   1.209   *  \brief Set an additional alpha value used in render copy operations.
   1.210 - *  
   1.211 + *
   1.212   *  \param texture The texture to update.
   1.213   *  \param alpha     The alpha value multiplied into copy operations.
   1.214 - *  
   1.215 - *  \return 0 on success, or -1 if the texture is not valid or alpha modulation 
   1.216 + *
   1.217 + *  \return 0 on success, or -1 if the texture is not valid or alpha modulation
   1.218   *          is not supported.
   1.219 - *  
   1.220 + *
   1.221   *  \sa SDL_GetTextureAlphaMod()
   1.222   */
   1.223  extern DECLSPEC int SDLCALL SDL_SetTextureAlphaMod(SDL_Texture * texture,
   1.224 @@ -316,12 +314,12 @@
   1.225  
   1.226  /**
   1.227   *  \brief Get the additional alpha value used in render copy operations.
   1.228 - *  
   1.229 + *
   1.230   *  \param texture The texture to query.
   1.231   *  \param alpha     A pointer filled in with the current alpha value.
   1.232 - *  
   1.233 + *
   1.234   *  \return 0 on success, or -1 if the texture is not valid.
   1.235 - *  
   1.236 + *
   1.237   *  \sa SDL_SetTextureAlphaMod()
   1.238   */
   1.239  extern DECLSPEC int SDLCALL SDL_GetTextureAlphaMod(SDL_Texture * texture,
   1.240 @@ -329,16 +327,16 @@
   1.241  
   1.242  /**
   1.243   *  \brief Set the blend mode used for texture copy operations.
   1.244 - *  
   1.245 + *
   1.246   *  \param texture The texture to update.
   1.247   *  \param blendMode ::SDL_BlendMode to use for texture blending.
   1.248 - *  
   1.249 + *
   1.250   *  \return 0 on success, or -1 if the texture is not valid or the blend mode is
   1.251   *          not supported.
   1.252 - *  
   1.253 + *
   1.254   *  \note If the blend mode is not supported, the closest supported mode is
   1.255   *        chosen.
   1.256 - *  
   1.257 + *
   1.258   *  \sa SDL_GetTextureBlendMode()
   1.259   */
   1.260  extern DECLSPEC int SDLCALL SDL_SetTextureBlendMode(SDL_Texture * texture,
   1.261 @@ -346,12 +344,12 @@
   1.262  
   1.263  /**
   1.264   *  \brief Get the blend mode used for texture copy operations.
   1.265 - *  
   1.266 + *
   1.267   *  \param texture   The texture to query.
   1.268   *  \param blendMode A pointer filled in with the current blend mode.
   1.269 - *  
   1.270 + *
   1.271   *  \return 0 on success, or -1 if the texture is not valid.
   1.272 - *  
   1.273 + *
   1.274   *  \sa SDL_SetTextureBlendMode()
   1.275   */
   1.276  extern DECLSPEC int SDLCALL SDL_GetTextureBlendMode(SDL_Texture * texture,
   1.277 @@ -359,15 +357,15 @@
   1.278  
   1.279  /**
   1.280   *  \brief Update the given texture rectangle with new pixel data.
   1.281 - *  
   1.282 + *
   1.283   *  \param texture   The texture to update
   1.284 - *  \param rect      A pointer to the rectangle of pixels to update, or NULL to 
   1.285 + *  \param rect      A pointer to the rectangle of pixels to update, or NULL to
   1.286   *                   update the entire texture.
   1.287   *  \param pixels    The raw pixel data.
   1.288   *  \param pitch     The number of bytes between rows of pixel data.
   1.289 - *  
   1.290 + *
   1.291   *  \return 0 on success, or -1 if the texture is not valid.
   1.292 - *  
   1.293 + *
   1.294   *  \note This is a fairly slow function.
   1.295   */
   1.296  extern DECLSPEC int SDLCALL SDL_UpdateTexture(SDL_Texture * texture,
   1.297 @@ -376,17 +374,17 @@
   1.298  
   1.299  /**
   1.300   *  \brief Lock a portion of the texture for write-only pixel access.
   1.301 - *  
   1.302 - *  \param texture   The texture to lock for access, which was created with 
   1.303 + *
   1.304 + *  \param texture   The texture to lock for access, which was created with
   1.305   *                   ::SDL_TEXTUREACCESS_STREAMING.
   1.306 - *  \param rect      A pointer to the rectangle to lock for access. If the rect 
   1.307 + *  \param rect      A pointer to the rectangle to lock for access. If the rect
   1.308   *                   is NULL, the entire texture will be locked.
   1.309 - *  \param pixels    This is filled in with a pointer to the locked pixels, 
   1.310 + *  \param pixels    This is filled in with a pointer to the locked pixels,
   1.311   *                   appropriately offset by the locked area.
   1.312   *  \param pitch     This is filled in with the pitch of the locked pixels.
   1.313 - *  
   1.314 + *
   1.315   *  \return 0 on success, or -1 if the texture is not valid or was not created with ::SDL_TEXTUREACCESS_STREAMING.
   1.316 - *  
   1.317 + *
   1.318   *  \sa SDL_UnlockTexture()
   1.319   */
   1.320  extern DECLSPEC int SDLCALL SDL_LockTexture(SDL_Texture * texture,
   1.321 @@ -395,7 +393,7 @@
   1.322  
   1.323  /**
   1.324   *  \brief Unlock a texture, uploading the changes to video memory, if needed.
   1.325 - *  
   1.326 + *
   1.327   *  \sa SDL_LockTexture()
   1.328   */
   1.329  extern DECLSPEC void SDLCALL SDL_UnlockTexture(SDL_Texture * texture);
   1.330 @@ -446,7 +444,7 @@
   1.331   *  If the output display is a window, mouse events in the window will be filtered
   1.332   *  and scaled so they seem to arrive within the logical resolution.
   1.333   *
   1.334 - *  \note If this function results in scaling or subpixel drawing by the 
   1.335 + *  \note If this function results in scaling or subpixel drawing by the
   1.336   *        rendering backend, it will be handled using the appropriate
   1.337   *        quality hints.
   1.338   *
   1.339 @@ -496,7 +494,7 @@
   1.340  
   1.341  /**
   1.342   *  \brief Set the clip rectangle for the current target.
   1.343 - *  
   1.344 + *
   1.345   *  \param renderer The renderer for which clip rectangle should be set.
   1.346   *  \param rect   A pointer to the rectangle to set as the clip rectangle, or
   1.347   *                NULL to disable clipping.
   1.348 @@ -510,7 +508,7 @@
   1.349  
   1.350  /**
   1.351   *  \brief Get the clip rectangle for the current target.
   1.352 - *  
   1.353 + *
   1.354   *  \param renderer The renderer from which clip rectangle should be queried.
   1.355   *  \param rect   A pointer filled in with the current clip rectangle, or
   1.356   *                an empty rectangle if clipping is disabled.
   1.357 @@ -531,7 +529,7 @@
   1.358   *  before they are used by the renderer.  This allows resolution
   1.359   *  independent drawing with a single coordinate system.
   1.360   *
   1.361 - *  \note If this results in scaling or subpixel drawing by the 
   1.362 + *  \note If this results in scaling or subpixel drawing by the
   1.363   *        rendering backend, it will be handled using the appropriate
   1.364   *        quality hints.  For best results use integer scaling factors.
   1.365   *
   1.366 @@ -555,14 +553,14 @@
   1.367  
   1.368  /**
   1.369   *  \brief Set the color used for drawing operations (Rect, Line and Clear).
   1.370 - *  
   1.371 + *
   1.372   *  \param renderer The renderer for which drawing color should be set.
   1.373   *  \param r The red value used to draw on the rendering target.
   1.374   *  \param g The green value used to draw on the rendering target.
   1.375   *  \param b The blue value used to draw on the rendering target.
   1.376 - *  \param a The alpha value used to draw on the rendering target, usually 
   1.377 + *  \param a The alpha value used to draw on the rendering target, usually
   1.378   *           ::SDL_ALPHA_OPAQUE (255).
   1.379 - *  
   1.380 + *
   1.381   *  \return 0 on success, or -1 on error
   1.382   */
   1.383  extern DECLSPEC int SDL_SetRenderDrawColor(SDL_Renderer * renderer,
   1.384 @@ -571,14 +569,14 @@
   1.385  
   1.386  /**
   1.387   *  \brief Get the color used for drawing operations (Rect, Line and Clear).
   1.388 - *  
   1.389 + *
   1.390   *  \param renderer The renderer from which drawing color should be queried.
   1.391   *  \param r A pointer to the red value used to draw on the rendering target.
   1.392   *  \param g A pointer to the green value used to draw on the rendering target.
   1.393   *  \param b A pointer to the blue value used to draw on the rendering target.
   1.394 - *  \param a A pointer to the alpha value used to draw on the rendering target, 
   1.395 + *  \param a A pointer to the alpha value used to draw on the rendering target,
   1.396   *           usually ::SDL_ALPHA_OPAQUE (255).
   1.397 - *  
   1.398 + *
   1.399   *  \return 0 on success, or -1 on error
   1.400   */
   1.401  extern DECLSPEC int SDL_GetRenderDrawColor(SDL_Renderer * renderer,
   1.402 @@ -587,15 +585,15 @@
   1.403  
   1.404  /**
   1.405   *  \brief Set the blend mode used for drawing operations (Fill and Line).
   1.406 - *  
   1.407 + *
   1.408   *  \param renderer The renderer for which blend mode should be set.
   1.409   *  \param blendMode ::SDL_BlendMode to use for blending.
   1.410 - *  
   1.411 + *
   1.412   *  \return 0 on success, or -1 on error
   1.413 - *  
   1.414 - *  \note If the blend mode is not supported, the closest supported mode is 
   1.415 + *
   1.416 + *  \note If the blend mode is not supported, the closest supported mode is
   1.417   *        chosen.
   1.418 - *  
   1.419 + *
   1.420   *  \sa SDL_GetRenderDrawBlendMode()
   1.421   */
   1.422  extern DECLSPEC int SDLCALL SDL_SetRenderDrawBlendMode(SDL_Renderer * renderer,
   1.423 @@ -603,12 +601,12 @@
   1.424  
   1.425  /**
   1.426   *  \brief Get the blend mode used for drawing operations.
   1.427 - *  
   1.428 + *
   1.429   *  \param renderer The renderer from which blend mode should be queried.
   1.430   *  \param blendMode A pointer filled in with the current blend mode.
   1.431 - *  
   1.432 + *
   1.433   *  \return 0 on success, or -1 on error
   1.434 - *  
   1.435 + *
   1.436   *  \sa SDL_SetRenderDrawBlendMode()
   1.437   */
   1.438  extern DECLSPEC int SDLCALL SDL_GetRenderDrawBlendMode(SDL_Renderer * renderer,
   1.439 @@ -625,11 +623,11 @@
   1.440  
   1.441  /**
   1.442   *  \brief Draw a point on the current rendering target.
   1.443 - *  
   1.444 + *
   1.445   *  \param renderer The renderer which should draw a point.
   1.446   *  \param x The x coordinate of the point.
   1.447   *  \param y The y coordinate of the point.
   1.448 - *  
   1.449 + *
   1.450   *  \return 0 on success, or -1 on error
   1.451   */
   1.452  extern DECLSPEC int SDLCALL SDL_RenderDrawPoint(SDL_Renderer * renderer,
   1.453 @@ -637,11 +635,11 @@
   1.454  
   1.455  /**
   1.456   *  \brief Draw multiple points on the current rendering target.
   1.457 - *  
   1.458 + *
   1.459   *  \param renderer The renderer which should draw multiple points.
   1.460   *  \param points The points to draw
   1.461   *  \param count The number of points to draw
   1.462 - *  
   1.463 + *
   1.464   *  \return 0 on success, or -1 on error
   1.465   */
   1.466  extern DECLSPEC int SDLCALL SDL_RenderDrawPoints(SDL_Renderer * renderer,
   1.467 @@ -650,13 +648,13 @@
   1.468  
   1.469  /**
   1.470   *  \brief Draw a line on the current rendering target.
   1.471 - *  
   1.472 + *
   1.473   *  \param renderer The renderer which should draw a line.
   1.474   *  \param x1 The x coordinate of the start point.
   1.475   *  \param y1 The y coordinate of the start point.
   1.476   *  \param x2 The x coordinate of the end point.
   1.477   *  \param y2 The y coordinate of the end point.
   1.478 - *  
   1.479 + *
   1.480   *  \return 0 on success, or -1 on error
   1.481   */
   1.482  extern DECLSPEC int SDLCALL SDL_RenderDrawLine(SDL_Renderer * renderer,
   1.483 @@ -664,11 +662,11 @@
   1.484  
   1.485  /**
   1.486   *  \brief Draw a series of connected lines on the current rendering target.
   1.487 - *  
   1.488 + *
   1.489   *  \param renderer The renderer which should draw multiple lines.
   1.490   *  \param points The points along the lines
   1.491   *  \param count The number of points, drawing count-1 lines
   1.492 - *  
   1.493 + *
   1.494   *  \return 0 on success, or -1 on error
   1.495   */
   1.496  extern DECLSPEC int SDLCALL SDL_RenderDrawLines(SDL_Renderer * renderer,
   1.497 @@ -677,10 +675,10 @@
   1.498  
   1.499  /**
   1.500   *  \brief Draw a rectangle on the current rendering target.
   1.501 - *  
   1.502 + *
   1.503   *  \param renderer The renderer which should draw a rectangle.
   1.504   *  \param rect A pointer to the destination rectangle, or NULL to outline the entire rendering target.
   1.505 - *  
   1.506 + *
   1.507   *  \return 0 on success, or -1 on error
   1.508   */
   1.509  extern DECLSPEC int SDLCALL SDL_RenderDrawRect(SDL_Renderer * renderer,
   1.510 @@ -688,11 +686,11 @@
   1.511  
   1.512  /**
   1.513   *  \brief Draw some number of rectangles on the current rendering target.
   1.514 - *  
   1.515 + *
   1.516   *  \param renderer The renderer which should draw multiple rectangles.
   1.517   *  \param rects A pointer to an array of destination rectangles.
   1.518   *  \param count The number of rectangles.
   1.519 - *  
   1.520 + *
   1.521   *  \return 0 on success, or -1 on error
   1.522   */
   1.523  extern DECLSPEC int SDLCALL SDL_RenderDrawRects(SDL_Renderer * renderer,
   1.524 @@ -701,11 +699,11 @@
   1.525  
   1.526  /**
   1.527   *  \brief Fill a rectangle on the current rendering target with the drawing color.
   1.528 - *  
   1.529 + *
   1.530   *  \param renderer The renderer which should fill a rectangle.
   1.531 - *  \param rect A pointer to the destination rectangle, or NULL for the entire 
   1.532 + *  \param rect A pointer to the destination rectangle, or NULL for the entire
   1.533   *              rendering target.
   1.534 - *  
   1.535 + *
   1.536   *  \return 0 on success, or -1 on error
   1.537   */
   1.538  extern DECLSPEC int SDLCALL SDL_RenderFillRect(SDL_Renderer * renderer,
   1.539 @@ -713,11 +711,11 @@
   1.540  
   1.541  /**
   1.542   *  \brief Fill some number of rectangles on the current rendering target with the drawing color.
   1.543 - *  
   1.544 + *
   1.545   *  \param renderer The renderer which should fill multiple rectangles.
   1.546   *  \param rects A pointer to an array of destination rectangles.
   1.547   *  \param count The number of rectangles.
   1.548 - *  
   1.549 + *
   1.550   *  \return 0 on success, or -1 on error
   1.551   */
   1.552  extern DECLSPEC int SDLCALL SDL_RenderFillRects(SDL_Renderer * renderer,
   1.553 @@ -726,14 +724,14 @@
   1.554  
   1.555  /**
   1.556   *  \brief Copy a portion of the texture to the current rendering target.
   1.557 - *  
   1.558 + *
   1.559   *  \param renderer The renderer which should copy parts of a texture.
   1.560   *  \param texture The source texture.
   1.561 - *  \param srcrect   A pointer to the source rectangle, or NULL for the entire 
   1.562 + *  \param srcrect   A pointer to the source rectangle, or NULL for the entire
   1.563   *                   texture.
   1.564 - *  \param dstrect   A pointer to the destination rectangle, or NULL for the 
   1.565 + *  \param dstrect   A pointer to the destination rectangle, or NULL for the
   1.566   *                   entire rendering target.
   1.567 - *  
   1.568 + *
   1.569   *  \return 0 on success, or -1 on error
   1.570   */
   1.571  extern DECLSPEC int SDLCALL SDL_RenderCopy(SDL_Renderer * renderer,
   1.572 @@ -742,7 +740,7 @@
   1.573                                             const SDL_Rect * dstrect);
   1.574  
   1.575  /**
   1.576 - *  \brief Copy a portion of the source texture to the current rendering target, rotating it by angle around the given center 
   1.577 + *  \brief Copy a portion of the source texture to the current rendering target, rotating it by angle around the given center
   1.578   *
   1.579   *  \param renderer The renderer which should copy parts of a texture.
   1.580   *  \param texture The source texture.
   1.581 @@ -753,7 +751,7 @@
   1.582   *  \param angle    An angle in degrees that indicates the rotation that will be applied to dstrect
   1.583   *  \param center   A pointer to a point indicating the point around which dstrect will be rotated (if NULL, rotation will be done aroud dstrect.w/2, dstrect.h/2)
   1.584   *  \param flip     An SDL_RendererFlip value stating which flipping actions should be performed on the texture
   1.585 - * 
   1.586 + *
   1.587   *  \return 0 on success, or -1 on error
   1.588   */
   1.589  extern DECLSPEC int SDLCALL SDL_RenderCopyEx(SDL_Renderer * renderer,
   1.590 @@ -766,17 +764,17 @@
   1.591  
   1.592  /**
   1.593   *  \brief Read pixels from the current rendering target.
   1.594 - *  
   1.595 + *
   1.596   *  \param renderer The renderer from which pixels should be read.
   1.597 - *  \param rect   A pointer to the rectangle to read, or NULL for the entire 
   1.598 + *  \param rect   A pointer to the rectangle to read, or NULL for the entire
   1.599   *                render target.
   1.600   *  \param format The desired format of the pixel data, or 0 to use the format
   1.601   *                of the rendering target
   1.602   *  \param pixels A pointer to be filled in with the pixel data
   1.603   *  \param pitch  The pitch of the pixels parameter.
   1.604 - *  
   1.605 + *
   1.606   *  \return 0 on success, or -1 if pixel reading is not supported.
   1.607 - *  
   1.608 + *
   1.609   *  \warning This is a very slow operation, and should not be used frequently.
   1.610   */
   1.611  extern DECLSPEC int SDLCALL SDL_RenderReadPixels(SDL_Renderer * renderer,
   1.612 @@ -791,7 +789,7 @@
   1.613  
   1.614  /**
   1.615   *  \brief Destroy the specified texture.
   1.616 - *  
   1.617 + *
   1.618   *  \sa SDL_CreateTexture()
   1.619   *  \sa SDL_CreateTextureFromSurface()
   1.620   */
   1.621 @@ -800,7 +798,7 @@
   1.622  /**
   1.623   *  \brief Destroy the rendering context for a window and free associated
   1.624   *         textures.
   1.625 - *  
   1.626 + *
   1.627   *  \sa SDL_CreateRenderer()
   1.628   */
   1.629  extern DECLSPEC void SDLCALL SDL_DestroyRenderer(SDL_Renderer * renderer);
   1.630 @@ -830,9 +828,7 @@
   1.631  
   1.632  /* Ends C function definitions when using C++ */
   1.633  #ifdef __cplusplus
   1.634 -/* *INDENT-OFF* */
   1.635  }
   1.636 -/* *INDENT-ON* */
   1.637  #endif
   1.638  #include "close_code.h"
   1.639