.\" Automatically generated by Pandoc 3.1.3
.\"
.\" 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_backup_dirty_bitmap" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_backup_dirty_bitmap - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

void al_backup_dirty_bitmap(ALLEGRO_BITMAP *bitmap)
\f[R]
.fi
.SH DESCRIPTION
.PP
On some platforms, notably Windows Direct3D and Android, textures may be
lost at any time for events such as display resize or switching out of
the app.
On those platforms, bitmaps created without the
ALLEGRO_NO_PRESERVE_TEXTURE flag automatically get backed up to system
memory every time al_flip_display is called.
.PP
This function gives you more control over when your bitmaps get backed
up.
By calling this function after modifying a bitmap, you can make sure the
bitmap is backed up right away instead of during the next flip.
.SH SINCE
.PP
5.2.1
.RS
.PP
\f[I][Unstable API]:\f[R] This API is new and subject to refinement.
.RE
.SH SEE ALSO
.PP
al_backup_dirty_bitmaps(3alleg5), al_create_bitmap(3alleg5)