Linux Certif

Toute la documentation sur la certification Linux LPI

get_rle_sprite.3alleg

NAME

get_rle_sprite - Creates an RLE sprite using a bitmap as source. Allegro game programming library.

SYNOPSIS

#include <allegro.h>

RLE_SPRITE *get_rle_sprite(BITMAP *bitmap);

DESCRIPTION

Creates an RLE sprite based on the specified bitmap (which must be a memory bitmap). Remember to free this RLE sprite later to avoid memory leaks. Example:

    RLE_SPRITE *rle;
    BITMAP *bmp;
    ...
    /* Create RLE sprite from an existent bitmap. */
    rle = get_rle_sprite(bmp);
    if (!rle)
       abort_on_error("Couldn't create RLE sprite!");
       
    /* We don't need the bitmap any more.*/
    destroy_bitmap(bmp);
    
    /* Use the RLE sprite. */
    ...
    /* Destroy it when we don't need it any more. */
    destroy_rle_sprite(rle);
 

RETURN VALUE

Returns a pointer to the created RLE sprite, or NULL if the RLE sprite could not be created. Remember to free this RLE sprite later to avoid memory leaks.

SEE ALSO

draw_rle_sprite(3alleg), destroy_rle_sprite(3alleg)