流媒体/Mpeg4/MP4

开发平台：
Visual C++

SDL_CreateRGBSurface.3：源码内容
							.TH "SDL_CreateRGBSurface" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
.SH "NAME"
SDL_CreateRGBSurface- Create an empty SDL_Surface
.SH "SYNOPSIS"
.PP
fB#include "SDL&.h"
.sp
fBSDL_Surface *fBSDL_CreateRGBSurfacefPfR(fBUint32 flags, int width, int height, int depth, Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 AmaskfR);
.SH "DESCRIPTION"
.PP
Allocate an empty surface (must be called after fISDL_SetVideoModefR)
.PP
If fBdepthfR is 8 bits an empty palette is allocated for the surface, otherwise a &'packed-pixel&' fIfBSDL_PixelFormatfRfR is created using the fB[RGBA]maskfR&'s provided (see fIfBSDL_PixelFormatfRfR)&. The fBflagsfR specifies the type of surface that should be created, it is an OR&'d combination of the following possible values&.
.TP 20
fBSDL_SWSURFACEfP
SDL will create the surface in system memory&. This improves the performance of pixel level access, however you may not be able to take advantage of some types of hardware blitting&.
.TP 20
fBSDL_HWSURFACEfP
SDL will attempt to create the surface in video memory&. This will allow SDL to take advantage of Video->Video blits (which are often accelerated)&.
.TP 20
fBSDL_SRCCOLORKEYfP
This flag turns on colourkeying for blits from this surface&. If fBSDL_HWSURFACEfP is also specified and colourkeyed blits are hardware-accelerated, then SDL will attempt to place the surface in video memory&. Use fIfBSDL_SetColorKeyfPfR to set or clear this flag after surface creation&.
.TP 20
fBSDL_SRCALPHAfP
This flag turns on alpha-blending for blits from this surface&. If fBSDL_HWSURFACEfP is also specified and alpha-blending blits are hardware-accelerated, then the surface will be placed in video memory if possible&. Use fIfBSDL_SetAlphafPfR to set or clear this flag after surface creation&.
.PP
.RS
fBNote:  
.PP
If an alpha-channel is specified (that is, if fBAmaskfR is nonzero), then the fBSDL_SRCALPHAfP flag is automatically set&. You may remove this flag by calling fIfBSDL_SetAlphafPfR after surface creation&.
.RE
.SH "RETURN VALUE"
.PP
Returns the created surface, or fBNULLfR upon error&.
.SH "EXAMPLE"
.PP
.nf
f(CW    /* Create a 32-bit surface with the bytes of each pixel in R,G,B,A order,
       as expected by OpenGL for textures */
    SDL_Surface *surface;
    Uint32 rmask, gmask, bmask, amask;
    /* SDL interprets each pixel as a 32-bit number, so our masks must depend
       on the endianness (byte order) of the machine */
#if SDL_BYTEORDER == SDL_BIG_ENDIAN
    rmask = 0xff000000;
    gmask = 0x00ff0000;
    bmask = 0x0000ff00;
    amask = 0x000000ff;
#else
    rmask = 0x000000ff;
    gmask = 0x0000ff00;
    bmask = 0x00ff0000;
    amask = 0xff000000;
#endif
    surface = SDL_CreateRGBSurface(SDL_SWSURFACE, width, height, 32,
                                   rmask, gmask, bmask, amask);
    if(surface == NULL) {
        fprintf(stderr, "CreateRGBSurface failed: %s
", SDL_GetError());
        exit(1);
    }fR
.fi
.PP
.SH "SEE ALSO"
.PP
fIfBSDL_CreateRGBSurfaceFromfPfR, fIfBSDL_FreeSurfacefPfR, fIfBSDL_SetVideoModefPfR, fIfBSDL_LockSurfacefPfR, fIfBSDL_PixelFormatfRfR, fIfBSDL_SurfacefRfR fIfBSDL_SetAlphafPfR fIfBSDL_SetColorKeyfPfR
..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01

						