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.