SDL 功能函数（一）

Function    PrepNuke(kilotons, target)
Synopsis    Sets up a tactical nuke and aims it at target.
Parameters    kilotons-Power rating of the desired nuke.
        target-Target of the nuke. 0 picks a random
        destination. Be carefull!

Function    SDL_Init(flags)
Synopsis    Initializes one or more subsystems of SDL.
Returns        Zero on success, a negative number on failure.
Parameters    flags-Subsystems to initialize. This is an ORed list
        of flags. Possible flags are SDL_INIT_VIDEO and
        SDL_INIT_AUDIO, among others.


Function    SDL_SetVideoMode(width, height, bpp, flags)
Synopsis    Creates a window or initalizes the video adapter to
        prepare for SDL video output.
Returns        Pointer to a valid SDL_Surface structure on success,
        NULL on failure.
Parameters    width-Width(x-resolution) of the desired video mode.
        height-Height(y-resolution) of the desired video mode.
        bpp-Desired color depth. Likely values are 8,15,16,24
        or 32. 0 lets SDL pick any supported mode.
        flags-Mode flags.Possible values are
        SDL_FULLSCREEN(requests a fullscreen video mode),
        SDL_DOUBLEBUF(requests a double buffered video setup),
        SDL_HWSURFACE(requests a hardware framebuffer for fast
        updates),
        SDL_OPENGL(requests an OpenGL context), and others.


Function    SDL_Quit()
Synopsis    Shuts down SDL cleanly, regardless of its present state.


Function    SDL_QuitSubSystem()
Synopsis    Shuts down a particular component of SDL, leaving the
        other untouched. It is safe to shut a subsystem down
        twice; SDL keeps track of its state internally.
Parameters    flags-ORed bitmask of subsystems to shut down.
        These are the same flags you would pass to SDL_Init.
        To shut down the audio subsystem without touching
        the video subsystem, you would use SDL_QuitSubSystem(
        SDL_INIT_AUDIO).

Function    SDL_Surface
Synopsis    Represents a video surface.
Members        flags-ORed bitmask of surface flags. For instance,
        the SDL_HWSURFACE bit of flags will be set if this is
        a hardware (video memory) surface. Read-only.
        format-Pointer to this surface's pixel format information
        (a SDL_PixelFormat structure).
        Read-only.
        w-Width of this surface (in pixels). Read-only.
        h-Height of this surface (in pixels). Read-only.
        pitch-Number of pixel per scanline in memory. This
        is often different from the surface's width - beware!
        Always use pitch for pixel offset calculations.
        Read-only.
        pixels-void pointer to the actual data that makes up
        this image. Read-write only after you call SDL_LockSurface.


Function    SDL_LockSurface(surf)
Synopsis    "Locks" a surface, making its pixel available for direct
        access. You can use SDL_MUSTLOCK(surf) to determine wheter a
        particular surface requires locking;
        some surfaces don't, Do not call DSL_BlitSurface on a locked
        surface.
Returns        Non-NULL on success, NULL on failure.
Parameters     surf-Surface to lock.



Function    SDL_UnlockSurface(surf)
Synopsis    "Unlocks" a surface. Use this as soon as you have finished
        drawing on a locked surface.
Parameter    surf-Surface to unlock


Struct        SDL_PixelFormat
Synpsis        Contains information about a surface's pixel composition.
Members        palette-Pointer to this surface's palette(of type
        SDL_Palette, if this is a paletted image.
        BitsPerPixel-Color depth of this surface. Possible
        values are 8,15,16,24, or 32.
        BytesPerPixel-Number of bytes needed for each pixel.
        This is usually BitPerPixel /8, rounded up to the
        nearest integer.
        Rloss—Number of bits to remove from an 8-bit red
        color value in order for it to fit in the allotted space.
        For instance, a 565 video mode allows for 5 bits of red
        color data, so the Rloss would be 3. SDL PixelFormat
        also contains Gloss, Bloss, and Aloss members for
        the green, blue, and alpha channels.
        Rshift—Number of bits to shift the red value in order
        to position it in the correct bit field. There are similar
        Gshift, Bshift, and Ashift members.
        Rmask—Bitmask for extracting the red component
        from a pixel value. There are similar Gmask, Bmask,
        and Amask members.
        colorkey—Color value for colorkey blitting. Set this
        with SDL SetColorKey. More on colorkey blitting
        later.
        alpha—Transparency value for the surface associated
        with this SDL PixelFormat structure. Set this with
        SDL SetAlpha. More on alpha blitting later.

Funciton    SDL_UpdateRect(surface, left, top, right, bottom)
Synopsis    Updates specific region of a surface. Normally used to
        make changes appear on the screen(see text above).
Parameters    surface-Surface to update. Usually the screen.
        left-Starting x coordinate of the region to update.
        If all coordinates are zero, SDL_UpdateRect will update
        the entire surface.
        top-Starting y coordinate of the region to update.
        right-Ending x coordinate of the region to update.
        bottom-Ending y coordinate of the region to update.


Function    SDL_LoadBMP(filename)
Synopsis    Loads a.bmp image file from disk into an SDL surface.
Returns        Pointer to a newly allocated SDL_Surface containing
        the loaded image.
Parameters    filename-Name of the bitmap file to load.


Function    SDL_BlitSurface(src, srcect, dest, destrect)
Synopsis    Blits all or part of one surface(the source) onto
        another (the destination).
Parameters    src-Source surface. Pointer to a valid SDL_Surface
        structure.
        srcect-Region of the source surface to copy. This
        is a pinter to an SDL_Rect structure. If this is NULL,
        SDL will try to copy the entire surface.
        dest-Destination surface.
        destrect-Region of the destionation surface to
        replace with the source surface. The width and height
        of the destionation surface don't matter; SDL only
        cares about the s and y coordinates.


Struture    SDL_Rect
Synopsis    Specifies regions of pixels. Used for clipping and blitting.
Members     x-starting x corrdinate.
        y-starting y corrdinate.
        w-width of the region, in pixels.
        h-height of the region, in pixels.


Function    SDL_SetColorKey(surface, flags, colorkey)
Synopsis    Adjusts the colorkey information ofr an SDL_Surface.
Parameters    surface-Surfce to modity.
        flags-ORed bitmask of colorkey flags.
        SDL_SRCCOLORKEY enables colorkey blitting for this
        surface. SDL_RLEACCEL enables run-length
        acceleration, which can speed up colorkey operations
        (but can alse slow down SDL_LockSurface significatly).
        colorkey-If SDL_SRCCOLORKEY is set, this specifies the
        pixel value to use as colorkey.


Function    SDL_SetAlpha(surface, flags, alpha)
Synopsis    Enables alpha blending on a particular surface.
Parameters    surface-The surface to modify.
        flags-ORed list of alpha blending flags.
        SDL_SRCALPHA enable alpha blending, and
        SDL_RLEACCEL enable RLE acceleration (with the
        same ramifications described under SDL_SetColorKey).
        alpha-Perj-surface alpha value. 255 represents complete
        opacity, and 0 represents complete transparency.

来自programming linux games

中文的在ubuntu论坛上见到过一些