.\" Generated by the Allegro makedoc utility
.TH draw_character_ex 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
draw_character_ex \- Draws non transparent pixels of the sprite with a color. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B void draw_character_ex(BITMAP *bmp, BITMAP *sprite, int x, int y,
.B color, bg);
.SH 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:

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

.SH SEE ALSO
.BR draw_sprite (3alleg4),
.BR bitmap_mask_color (3alleg4)