Provided by: allegro5-doc_5.0.10-2_all bug

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.

       The  behaviour  is  undefined  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)