SDL_LockSurface.3
资源名称:NETVIDEO.rar [点击查看]
上传用户:sun1608
上传日期:2007-02-02
资源大小:6116k
文件大小:2k
源码类别:
流媒体/Mpeg4/MP4
开发平台:
Visual C++
- .TH "SDL_LockSurface" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference"
- .SH "NAME"
- SDL_LockSurface- Lock a surface for directly access&.
- .SH "SYNOPSIS"
- .PP
- fB#include "SDL&.h"
- .sp
- fBint fBSDL_LockSurfacefPfR(fBSDL_Surface *surfacefR);
- .SH "DESCRIPTION"
- .PP
- fBSDL_LockSurfacefP sets up a surface for directly accessing the pixels&. Between calls to fBSDL_LockSurfacefP and fBSDL_UnlockSurfacefP, you can write to and read from fBsurface->fBpixelsfRfR, using the pixel format stored in fBsurface->fBformatfRfR&. Once you are done accessing the surface, you should use fBSDL_UnlockSurfacefP to release it&.
- .PP
- Not all surfaces require locking&. If fBSDL_MUSTLOCKfP(fBsurfacefR) evaluates to fB0fR, then you can read and write to the surface at any time, and the pixel format of the surface will not change&.
- .PP
- No operating system or library calls should be made between lock/unlock pairs, as critical system locks may be held during this time&.
- .PP
- It should be noted, that since SDL 1&.1&.8 surface locks are recursive&. This means that you can lock a surface multiple times, but each lock must have a match unlock&.
- .PP
- .nf
- f(CW &.
- &.
- SDL_LockSurface( surface );
- &.
- /* Surface is locked */
- /* Direct pixel access on surface here */
- &.
- SDL_LockSurface( surface );
- &.
- /* More direct pixel access on surface */
- &.
- SDL_UnlockSurface( surface );
- /* Surface is still locked */
- /* Note: Is versions < 1&.1&.8, the surface would have been */
- /* no longer locked at this stage */
- &.
- SDL_UnlockSurface( surface );
- /* Surface is now unlocked */
- &.
- &.fR
- .fi
- .PP
- .SH "RETURN VALUE"
- .PP
- fBSDL_LockSurfacefP returns fB0fR, or fB-1fR if the surface couldn&'t be locked&.
- .SH "SEE ALSO"
- .PP
- fIfBSDL_UnlockSurfacefPfR
- ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01