DragonFly On-Line Manual Pages

draw_character_ex(3)            Allegro manual            draw_character_ex(3)

NAME
       draw_character_ex - Draws non transparent pixels of the sprite with a
       color. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

       void draw_character_ex(BITMAP *bmp, BITMAP *sprite, int x, int y,
       color, bg);

DESCRIPTION
       Draws a copy of the sprite bitmap onto the destination bitmap at the
       specified position, drawing transparent pixels in the background color
       (or skipping them if the background color is -1) and setting all other
       pixels to the specified color. Transparent pixels are marked by a zero
       in 256-color modes or bright pink for truecolor data (maximum red and
       blue, zero green). The sprite must be an 8-bit image, even if the
       destination is a truecolor bitmap. Example:

          BITMAP *logo;
          ...
          /* Draw the logo silhouette in red. */
          draw_character_ex(screen, logo, SCREEN_W / 2, SCREEN_H / 2,
                            makecol(255, 0, 0), -1);

SEE ALSO
       draw_sprite(3), bitmap_mask_color(3)

Allegro                          version 4.4.2            draw_character_ex(3)