---
name: "textout_centre_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/textout_centre_ex/3alleg4"
---

# textout\_centre\_ex(3alleg4)

Writes a centered string on a bitmap. Allegro game programming library.

## NAME

textout\_centre\_ex - Writes a centered string on a bitmap. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**void textout\_centre\_ex(BITMAP \*bmp, const FONT \*f, const char \*s,** **int x, y, int color, int bg);**

## DESCRIPTION

Like textout\_ex(), but interprets the x coordinate as the centre rather than the left edge of the string. Example:

```
   /* Important texts go in the middle. */
   width = text_length("GAME OVER");
   textout_centre_ex(screen, font, "GAME OVER",
                     SCREEN_W / 2, SCREEN_H / 2,
                     makecol(255, 0, 0), makecol(0, 0, 0));
```

## SEE ALSO

**textout\_ex**(3alleg4), **textprintf\_centre\_ex**(3alleg4)