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

FreeBSD Manual Pages

  
 
  

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

NAME
     create_sub_zbuffer  -  Creates a sub-z-buffer. Allegro game programming li-
     brary.

SYNOPSIS
     #include <allegro.h>

     ZBUFFER *create_sub_zbuffer(ZBUFFER *parent, int x, int y, int  width,  int
     height);

DESCRIPTION
     Creates  a  sub-z-buffer, ie. a z-buffer sharing drawing memory with a pre-
     existing z-buffer, but possibly with a different size. The  same  rules  as
     for  sub-bitmaps apply: the sub-z-buffer 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.

     When  drawing  z-buffered to a bitmap, the top left corner of the bitmap is
     always mapped to the top left corner of the current z-buffer. So this func-
     tion is primarily useful if you want to draw to a sub-bitmap  and	use  the
     corresponding  sub-area  of  the  z-buffer. In other cases, eg. if you just
     want to draw to a sub-bitmap of screen (and not to other parts of	screen),
     then  you would usually want to create a normal z-buffer (not sub-z-buffer)
     the size of the visible screen. You don't need to first create  a	z-buffer
     the size of the virtual screen and then a sub-z-buffer of that.

RETURN VALUE
     Returns  the pointer to the sub ZBUFFER or NULL if there was an error.  Re-
     member to destroy the ZBUFFER once you are done with it,  to  avoid  having
     memory leaks.

SEE ALSO
     create_zbuffer(3), create_sub_bitmap(3), destroy_zbuffer(3)

Allegro 			  version 4.4.3 	   create_sub_zbuffer(3)

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

home | help