Provided by: allegro5-doc_5.2.5.0-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.

       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)