include/SDL_video.h
changeset 292 eadc0746dfaf
parent 251 b8688cfdc232
child 296 fab1ddc4d7bf
     1.1 --- a/include/SDL_video.h	Sat Mar 02 16:50:35 2002 +0000
     1.2 +++ b/include/SDL_video.h	Tue Mar 05 19:55:32 2002 +0000
     1.3 @@ -532,6 +532,26 @@
     1.4  extern DECLSPEC void SDL_UnlockSurface(SDL_Surface *surface);
     1.5  
     1.6  /*
     1.7 + * SDL_LockRect() locks a portion of the surface designated by the 'rect'
     1.8 + * parameter, and saves the resulting pixels and pitch in the arguments.
     1.9 + * The rect will be clipped if it extends beyond the bounds of the surface
    1.10 + *
    1.11 + * This may be more efficient than a full lock if you are using a hardware
    1.12 + * surface and plan to make a few changes to small areas in the surface.
    1.13 + *
    1.14 + * While a rectangle is locked, no other lock or blit call may be called
    1.15 + * on the surface.  No operating system or library calls should be made
    1.16 + * between lock/unlock pairs, as critical system locks may be held during
    1.17 + * this time.
    1.18 + *
    1.19 + * After the surface is unlocked, the pixels pointer is no longer valid.
    1.20 + *
    1.21 + * SDL_LockRect() returns 0, or -1 if the surface couldn't be locked.
    1.22 + */
    1.23 +extern DECLSPEC int SDL_LockRect(SDL_Surface *surface, SDL_Rect *rect, void **pixels, int *pitch);
    1.24 +extern DECLSPEC void SDL_UnlockRect(SDL_Surface *surface);
    1.25 +
    1.26 +/*
    1.27   * Load a surface from a seekable SDL data source (memory or file.)
    1.28   * If 'freesrc' is non-zero, the source will be closed after being read.
    1.29   * Returns the new surface, or NULL if there was an error.