.\" 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_init_image_addon" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_init_image_addon - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_image.h>

bool al_init_image_addon(void)
\f[R]
.fi
.SH DESCRIPTION
.PP
Initializes the image addon.
This registers bitmap format handlers for al_load_bitmap(3alleg5),
al_load_bitmap_f(3alleg5), al_save_bitmap(3alleg5),
al_save_bitmap_f(3alleg5).
.PP
The following types are built into the Allegro image addon and
guaranteed to be available: BMP, DDS, PCX, TGA.
Every platform also supports JPEG and PNG via external dependencies.
.PP
Other formats may be available depending on the operating system and
installed libraries, but are not guaranteed and should not be assumed to
be universally available.
.PP
The DDS format is only supported to load from, and only if the DDS file
contains textures compressed in the DXT1, DXT3 and DXT5 formats.
Note that when loading a DDS file, the created bitmap will always be a
video bitmap and will have the pixel format matching the format in the
file.