NAME

       al_iphone_override_screen_scale - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_iphone.h>

              void al_iphone_override_screen_scale(float scale)

DESCRIPTION

       Original iPhones and iPod Touches had a screen resolution of 320x480 (in Portrait mode).  When the iPhone
       4  and  iPod  Touch  4th  generation devices came out, they were backwards compatible with all old iPhone
       apps.  This means that they assume a 320x480 screen resolution by default, while  they  actually  have  a
       640x960 pixel screen (exactly 2x on each dimension).  An API was added to allow access to the full (or in
       fact any fraction of the) resolution of the new devices.  This function is normally not needed, as in the
       case when you want a scale of 2.0 for "retina display" resolution (640x960).  In that case you would just
       call  al_create_display  with  the  larger width and height parameters.  It is not limited to 2.0 scaling
       factors however.  You can use 1.5 or 0.5 or other values  in  between,  however  if  it's  not  an  exact
       multiple of the original iPhone resolution, linear filtering will be applied to the final image.

       This function should be called BEFORE calling al_create_display.

Allegro reference manual                                              al_iphone_override_screen_scale(3alleg5)()