.\" Generated by the Allegro makedoc utility
.TH textout_justify_ex 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
textout_justify_ex \- Draws justified text within a region. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B void textout_justify_ex(BITMAP *bmp, const FONT *f, const char *s,
.B int x1, int x2, int y, int diff, int color,
.B int bg);
.SH DESCRIPTION
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:

.nf
   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));
.fi

.SH SEE ALSO
.BR textout_ex (3alleg4),
.BR textprintf_justify_ex (3alleg4)