Provided by: allegro5-doc_5.2.4.0-3_all bug

NAME

       al_register_bitmap_identifier - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              bool al_register_bitmap_identifier(const char *extension,
                 bool (*identifier)(ALLEGRO_FILE *f))

DESCRIPTION

       Register  an identify handler for al_identify_bitmap(3alleg5).  The given function will be
       used to detect files for the given extension.  It will be called with a single argument of
       type  ALLEGRO_FILE(3alleg5)  which  is a file handle opened for reading and located at the
       first byte of the file.  The handler should try to read as few bytes as possible to safely
       determine  if the given file contents correspond to the type with the extension and return
       true in that case, false otherwise.  The file handle must not be closed but  there  is  no
       need to reset it to the beginning.

       The  extension  should  include  the  leading  dot  (`.')  character.   It will be matched
       case-insensitively.

       The identifier argument may be NULL to unregister an entry.

       Returns true on success, false on error.  Returns false if  unregistering  an  entry  that
       doesn't exist.

SINCE

       5.1.12

SEE ALSO

       al_identify_bitmap(3alleg5)