MirOS Manual: gluTessNormal(3)


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

NAME

     gluTessNormal - specify a normal for a polygon

C SPECIFICATION

     void gluTessNormal( GLUtesselator* tess,
                         GLdouble valueX,
                         GLdouble valueY,
                         GLdouble valueZ )

PARAMETERS

     tess    Specifies the tessellation object (created with
             gluNewTess).

     valueX  Specifies the first component of the normal.

     valueY  Specifies the second component of the normal.

     valueZ  Specifies the third component of the normal.

DESCRIPTION

     gluTessNormal describes a normal for a polygon that the pro-
     gram is defining. All input data will be projected onto a
     plane perpendicular to one of the three coordinate axes
     before tessellation and all output triangles will be
     oriented CCW with respect to the normal (CW orientation can
     be obtained by reversing the sign of the supplied normal).
     For example, if you know that all polygons lie in the x-y
     plane, call gluTessNormal(tess, 0.0, 0.0, 1.0) before
     rendering any polygons.

     If the supplied normal is (0.0, 0.0, 0.0) (the initial
     value), the normal is determined as follows. The direction
     of the normal, up to its sign, is found by fitting a plane
     to the vertices, without regard to how the vertices are con-
     nected. It is expected that the input data lies approxi-
     mately in the plane; otherwise, projection perpendicular to
     one of the three coordinate axes may substantially change
     the geometry. The sign of the normal is chosen so that the
     sum of the signed areas of all input contours is nonnegative
     (where a CCW contour has positive area).

     The supplied normal persists until it is changed by another
     call to gluTessNormal.

SEE ALSO

     gluTessBeginPolygon(3G), gluTessEndPolygon(3G)

MirOS BSD #10-current  Printed 09.04.2016                       1

Generated on 2016-04-09 20:35:54 by $MirOS: src/scripts/roff2htm,v 1.83 2016/03/26 23:38:28 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–2016 The MirOS Project, Germany.
This product includes material provided by mirabilos.

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