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

FreeBSD Manual Pages

  
 
  

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

NAME
       create_bitmap  -	 Creates a memory bitmap. Allegro game programming li-
       brary.

SYNOPSIS
       #include	<allegro.h>

       BITMAP *create_bitmap(int width,	int height);

DESCRIPTION
       Creates a memory	bitmap sized width by height.  The  bitmap  will  have
       clipping	 turned	on, and	the clipping rectangle set to the full size of
       the bitmap. The image memory will not be	cleared, so it	will  probably
       contain garbage:	you should clear the bitmap before using it. This rou-
       tine  always  uses  the	global	pixel  format, as specified by calling
       set_color_depth().  The minimum height of the  BITMAP  must  be	1  and
       width can't be negative.	 Example:

	  /* Create a 10 pixel tall bitmap, as wide as the screen. */
	  BITMAP *bmp =	create_bitmap(SCREEN_W,	10);
	  if (!bmp)
	     abort_on_error("Couldn't create bitmap!");
	  /* Use the bitmap. */
	  ...
	  /* Destroy it	when we	don't need it any more.	*/
	  destroy_bitmap(bmp);

RETURN VALUE
       Returns	a  pointer  to the created bitmap, or NULL if the bitmap could
       not be created. Remember	to free	this  bitmap  later  to	 avoid	memory
       leaks.

SEE ALSO
       create_bitmap_ex(3), create_sub_bitmap(3), create_video_bitmap(3), cre-
       ate_system_bitmap(3),  destroy_bitmap(3),  set_color_depth(3),  is_mem-
       ory_bitmap(3), clear_bitmap(3), clear_to_color(3)

Allegro				 version 4.4.3		      create_bitmap(3)

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

home | help