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),	 register_bit-
       map_file_type(3)

Allegro				 version 4.4.2			save_bitmap(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help