.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_draw_justified_text" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_draw_justified_text - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_font.h>

void al_draw_justified_text(const ALLEGRO_FONT *font,
   ALLEGRO_COLOR color, float x1, float x2,
   float y, float diff, int flags, const char *text)
\f[R]
.fi
.SH DESCRIPTION
.PP
Like al_draw_text(3alleg5), but justifies the string to the region
x1-x2.
.PP
The \f[V]diff\f[R] parameter is the maximum amount of horizontal space
to allow between words.
If justisfying the text would exceed \f[V]diff\f[R] pixels, or the
string contains less than two words, then the string will be drawn left
aligned.
.PP
The \f[V]flags\f[R] parameter can be 0 or one of the following flags:
.IP \[bu] 2
ALLEGRO_ALIGN_INTEGER - Draw text aligned to integer pixel positions.
Since: 5.0.8, 5.1.5
.SH SEE ALSO
.PP
al_draw_justified_textf(3alleg5), al_draw_justified_ustr(3alleg5)