NAME

       al_load_ttf_font_stretch - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_ttf.h>

              ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h,
                 int flags)

DESCRIPTION

       Like  al_load_ttf_font(3alleg5), except it takes separate width and height parameters instead of a single
       size parameter.

       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.

       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.

       Returns NULL if the height is positive while width is negative, or if the height is  negative  while  the
       width is positive.

SINCE

       5.0.6, 5.1.0

SEE ALSO

       al_load_ttf_font(3alleg5), al_load_ttf_font_stretch_f(3alleg5)