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 library.

SYNOPSIS
     #include <allegro.h>

     BITMAP *create_bitmap(int width, int height);

DESCRIPTION
     Creates  a  memory bitmap sized width by height. The bitmap will have clip-
     ping 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  routine  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+15.1.quarterly>

home | help