.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_draw_glyph" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_draw_glyph - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_font.h>

void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y,
   int codepoint)
\f[R]
.fi
.SH DESCRIPTION
.PP
Draws the glyph that corresponds with \f[V]codepoint\f[R] in the given
\f[V]color\f[R] using the given \f[V]font\f[R].
If \f[V]font\f[R] does not have such a glyph, nothing will be drawn.
.PP
To draw a string as left to right horizontal text you will need to use
al_get_glyph_advance(3alleg5) to determine the position of each glyph.
For drawing strings in other directions, such as top to down, use
al_get_glyph_dimensions(3alleg5) to determine the size and position of
each glyph.
.PP
If you have to draw many glyphs at the same time, use
al_hold_bitmap_drawing(3alleg5) with true as the parameter, before
drawing the glyphs, and then call al_hold_bitmap_drawing(3alleg5) again
with false as a parameter when done drawing the glyphs to further
enhance performance.
.SH SINCE
.PP
5.1.12
.SH SEE ALSO
.PP
al_get_glyph_width(3alleg5), al_get_glyph_dimensions(3alleg5),
al_get_glyph_advance(3alleg5).