getscrbox(3G) getscrbox(3G)
NAME
getscrbox - read back the current computed screen bounding box
C SPECIFICATION
void getscrbox(long *left, long *right, long *bottom, long *top)
PARAMETERS
left returns the window coordinate of the left-most pixel drawn while
scrbox has been tracking.
right returns the window coordinate of the right-most pixel drawn
while scrbox has been tracking.
bottom returns the window coordinate of the lowest pixel drawn while
scrbox has been tracking.
top returns the window coordinate of the highest pixel drawn while
scrbox has been tracking.
DESCRIPTION
getscrbox returns the current screen bounding box. scrbox is the computed
bounding box of all geometry (points, lines, polygons) in screen-space.
The hardware updates the four values each time geometry is drawn (while
scrbox is tracking).
If left is greater than right, or bottom is greater than top, nothing has
been drawn since scrbox was reset.
SEE ALSO
scrbox
NOTE
This routine is available only in immediate mode.
IRIS-4D G, GT, and GTX models, and the Personal Iris, do not support
scrbox, and therefore do not support getscrbox. Use getgdesc to
determine whether scrbox is supported.
On the IRIS-4D RealityEngine model getscrbox returns the trivial
rectangle defined by scrmask.
Page 1