---
name: "gl_getbox"
section: "3"
platform: "linux"
package: "libsvga1-dev"
version: "1:1.4.3-33"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/gl_getbox"
---

# gl\_getbox(3)

copy a rectangular pixmap from the screen to a buffer

## NAME

gl\_getbox - copy a rectangular pixmap from the screen to a buffer

## SYNOPSIS

**#include \<vgagl.h\>**

**void gl\_getbox(int** *x***, int** *y***, int** *w***, int** *h***, void \****dp***);**

## DESCRIPTION

Copy a rectangular bitmap at position (*x*, *y*) with size (*w*, *h*) from the screen to a buffer *dp*.

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

## SEE ALSO

[**svgalib**(7)](/svgalib/7.md), [**vgagl**(7)](/vgagl/7.md), **svgalib.conf**(5), **threedkit**(7), **testgl**(1), [**gl\_compileboxmask**(3)](/gl_compileboxmask/3.md), [**gl\_compiledboxmasksize**(3)](/gl_compiledboxmasksize/3.md), [**gl\_copybox**(3)](/gl_copybox/3.md), [**gl\_copyboxfromcontext**(3)](/gl_copyboxfromcontext/3.md), [**gl\_copyboxtocontext**(3)](/gl_copyboxtocontext/3.md), [**gl\_putbox**(3)](/gl_putbox/3.md), [**gl\_putboxmask**(3)](/gl_putboxmask/3.md), [**gl\_putboxmaskcompiled**(3)](/gl_putboxmaskcompiled/3.md), [**gl\_putboxpart**(3)](/gl_putboxpart/3.md), [**gl\_scalebox**(3)](/gl_scalebox/3.md).

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