al_get_text_dimensions(1) Allegro 5 API


#include <allegro5/allegro_font.h>
void al_get_text_dimensions(const ALLEGRO_FONT *f,
   char const *text,
   int *bbx, int *bby, int *bbw, int *bbh)


Sometimes, the al_get_text_width(3alleg5) and al_get_font_line_height(3alleg5) functions are not enough for exact text placement, so this function returns some additional information.

Returned variables (all in pixels):

  • x, y - Offset to upper left corner of bounding box.
  • w, h - Dimensions of bounding box.

Note that glyphs may go to the left and upwards of the X, in which case x and y will have negative values.