NAME

       gl_putboxmask - copy a masked  pixmap to a rectangular area

SYNOPSIS

       #include <vgagl.h>

       void gl_putboxmask(int x, int y, int w, int h, void *dp);

DESCRIPTION

       Copy  the  contents  of a memory buffer dp to a rectangular bitmap at position (x, y) with
       size (w, h).

       This function works like gl_putbox, but does not write pixmap pixels of color zero. If the
       same pixmap is used often you should consider using the faster gl_putboxmaskcompiled(3).

       Pixmaps  are  in  row-major  order.  The  source  pixmap  memory  has  the  size  w  * h *
       BYTESPERPIXEL.

SEE ALSO

       svgalib(7),  vgagl(7),  svgalib.conf(5),  threedkit(7),  testgl(1),  gl_compileboxmask(3),
       gl_compiledboxmasksize(3),             gl_copybox(3),            gl_copyboxfromcontext(3),
       gl_copyboxtocontext(3),         gl_fillbox(3),         gl_getbox(3),         gl_putbox(3),
       gl_putboxmaskcompiled(3), gl_putboxpart(3), gl_scalebox(3).

AUTHOR

       This  manual  page  was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The exact
       source of the referenced demo as well as of the original documentation is unknown.

       It is very likely that both are at least  to  some  extent  are  due  to  Harm  Hanemaayer
       <H.Hanemaayer@inter.nl.net>.

       Occasionally  this might be wrong. I hereby asked to be excused by the original author and
       will happily accept any additions or corrections to this  first  version  of  the  svgalib
       manual.