get_rle_sprite

get_rle_sprite(3alleg4)          Allegro manual          get_rle_sprite(3alleg4)



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(3alleg4), destroy_rle_sprite(3alleg4)



Allegro                           version 4.4.3          get_rle_sprite(3alleg4)