---
name: "draw_character_ex"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/draw_character_ex/3alleg4"
---

# draw\_character\_ex(3alleg4)

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

## 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**(3alleg4), **bitmap\_mask\_color**(3alleg4)