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

FreeBSD Manual Pages

  
 
  

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

NAME
     create_sub_bitmap	-  Creates a memory sub bitmap. Allegro game programming
     library.

SYNOPSIS
     #include <allegro.h>

     BITMAP *create_sub_bitmap(BITMAP *parent, int x, y, width, height);

DESCRIPTION
     Creates a sub-bitmap, ie. a bitmap sharing drawing memory with a pre-exist-
     ing bitmap, but possibly with a different size and clipping settings.  When
     creating a sub-bitmap of the mode-X screen, the x position must be a multi-
     ple  of  four.  The sub-bitmap width and height can extend beyond the right
     and bottom edges of the parent (they will be clipped), but the origin point
     must lie within the parent region.

RETURN VALUE
     Returns a pointer to the created sub bitmap, or  NULL  if	the  sub  bitmap
     could  not  be  created. Remember to free the sub bitmap before freeing the
     parent bitmap to avoid memory leaks and potential crashes accessing  memory
     which has been freed.

SEE ALSO
     create_bitmap(3), create_bitmap_ex(3), destroy_bitmap(3), is_sub_bitmap(3),
     clear_bitmap(3), clear_to_color(3), expat(3), exscroll(3), exswitch(3)

Allegro 			  version 4.4.3 	    create_sub_bitmap(3)

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

home | help