FreeBSD Manual Pages
al_hold_bitmap_drawing(3) Library Functions Manual al_hold_bitmap_drawing(3) NAME al_hold_bitmap_drawing - Allegro 5 API SYNOPSIS #include <allegro5/allegro.h> void al_hold_bitmap_drawing(bool hold) DESCRIPTION Enables or disables deferred bitmap drawing. This allows for efficient drawing of many bitmaps that share a parent bitmap, such as sub-bitmaps from a tilesheet or simply identical bitmaps. Drawing bitmaps that do not share a parent is less efficient, so it is advisable to stagger bitmap drawing calls such that the parent bitmap is the same for large number of those calls. While deferred bitmap drawing is enabled, the only functions that can be used are the bitmap drawing functions and font drawing functions. Changing the state such as the blending modes will result in undefined behaviour. One exception to this rule are the non-projection transformations. It is possible to set a new transfor- mation while the drawing is held. No drawing is guaranteed to take place until you disable the hold. Thus, the idiom of this function's usage is to enable the deferred bitmap drawing, draw as many bitmaps as possible, taking care to stag- ger bitmaps that share parent bitmaps, and then disable deferred draw- ing. As mentioned above, this function also works with bitmap and truetype fonts, so if multiple lines of text need to be drawn, this function can speed things up. SEE ALSO al_is_bitmap_drawing_held(3) Allegro reference manual al_hold_bitmap_drawing(3)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_hold_bitmap_drawing&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>