.\" 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_load_ttf_font_stretch" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_load_ttf_font_stretch - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_ttf.h>

ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h,
   int flags)
\f[R]
.fi
.SH DESCRIPTION
.PP
Like al_load_ttf_font(3alleg5), except it takes separate width and
height parameters instead of a single size parameter.
.PP
If the height is a positive value, and the width zero or positive, then
font will be stretched according to those parameters.
The width must not be negative if the height is positive.
.PP
As with al_load_ttf_font(3alleg5), the height may be a negative value to
specify the total height in pixels.
Then the width must also be a negative value, or zero.
.PP
Returns \f[V]NULL\f[R] if the height is positive while width is
negative, or if the height is negative while the width is positive.
.SH SINCE
.PP
5.0.6, 5.1.0
.SH SEE ALSO
.PP
al_load_ttf_font(3alleg5), al_load_ttf_font_stretch_f(3alleg5)