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

FreeBSD Manual Pages

  
 
  

home | help
save_bitmap(3)			Allegro	manual			save_bitmap(3)

NAME
       save_bitmap  -  Saves  a	bitmap into any	supported file format. Allegro
       game programming	library.

SYNOPSIS
       #include	<allegro.h>

       int save_bitmap(const char *filename, BITMAP *bmp, const	RGB *pal);

DESCRIPTION
       Writes a	bitmap into a file, using the specified	palette, which	should
       be an array of 256 RGB structures. The output format is determined from
       the  filename extension:	at present this	function supports BMP, PCX and
       TGA formats.

       Two things to watch out for: on some video cards	it may	be  faster  to
       copy  the screen	to a memory bitmap and save the	latter,	and if you use
       this to dump the	screen into a file you may end up with an  image  much
       larger  than  you were expecting, because Allegro often creates virtual
       screens larger than the visible screen. You can get around this by  us-
       ing a sub-bitmap	to specify which part of the screen to save, eg:

	  BITMAP *bmp;
	  PALETTE pal;
	  ...
	  get_palette(pal);
	  bmp =	create_sub_bitmap(screen, 0, 0,	SCREEN_W, SCREEN_H);
	  save_bitmap("dump.pcx", bmp, pal);
	  destroy_bitmap(bmp);

RETURN VALUE
       Returns non-zero	on error.

SEE ALSO
       save_bmp(3),    save_pcx(3),    save_tga(3),   load_bitmap(3),	regis-
       ter_bitmap_file_type(3)

Allegro				 version 4.4.3			save_bitmap(3)

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

home | help