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.2		      create_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=create_bitmap&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help