Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_regist...identifier(3)  Library Functions Manual  al_regist...identifier(3)

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(3).  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(3)  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  be-
       ginning.

       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  unregister-
       ing an entry that doesn't exist.

SINCE
       5.1.12

SEE ALSO
       al_identify_bitmap(3)

Allegro	reference manual			     al_regist...identifier(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_register_bitmap_identifier&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help