textout_justify_ex(3alleg)

textout_justify_ex3alleg

Draws justified text within a region. allegro game programming library.

Usage

#include <allegro.h>

void textout_justify_ex(BITMAP *bmp, const FONT *f, const char *s, int x1, int x2, int y, int diff, int color, int bg);

Overview

Draws justified text within the region x1-x2. If the amount of spare space is greater than the diff value, it will give up and draw regular left justified text instead. Example:

   char *lines[] = {"Draws justified text",
                    "within the specified",
                    "x2-x1 area. But not",
                    "T H I S !", NULL};
   /* Show the justification marker. */
   vline(screen, 200, 0, SCREEN_H-1, makecol(0, 0, 0));
   /* Draw all the lines until we reach a NULL entry. */
   for (num = 0, y = 0; lines[num]; num++, y += text_height(font))
      textout_justify_ex(screen, font, lines[num], 0, 200,
                         y, 80, makecol(0, 0, 0),
                         makecol(255, 255, 255));

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.