MirOS Manual: glDepthRange(3)


GLDEPTHRANGE(3G)    UNIX Programmer's Manual     GLDEPTHRANGE(3G)

NAME

     glDepthRange - specify mapping of depth values from normal-
     ized device coordinates to window coordinates

C SPECIFICATION

     void glDepthRange( GLclampd near_val,
                        GLclampd far_val )

PARAMETERS

     near_val  Specifies the mapping of the near clipping plane
               to window coordinates. The initial value is 0.

     far_val   Specifies the mapping of the far clipping plane to
               window coordinates. The initial value is 1.

DESCRIPTION

     After clipping and division by w, depth coordinates range
     from -1 to 1, corresponding to the near and far clipping
     planes. glDepthRange specifies a linear mapping of the nor-
     malized depth coordinates in this range to window depth
     coordinates. Regardless of the actual depth buffer implemen-
     tation, window coordinate depth values are treated as though
     they range from 0 through 1 (like color components). Thus,
     the values accepted by glDepthRange are both clamped to this
     range before they are accepted.

     The setting of (0,1) maps the near plane to 0 and the far
     plane to 1. With this mapping, the depth buffer range is
     fully utilized.

NOTES

     It is not necessary that near_val be less than far_val.
     Reverse mappings such as near_val = 1, and far_val = 0 are
     acceptable.

ERRORS

     GL_INVALID_OPERATION is generated if glDepthRange is exe-
     cuted between the execution of glBegin and the corresponding
     execution of glEnd.

ASSOCIATED GETS

     glGet with argument GL_DEPTH_RANGE

SEE ALSO

     glDepthFunc(3G), glPolygonOffset(3G), glViewport(3G)

MirOS BSD #10-current   Printed 20.2.2012                       1

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.