bionic (3) gleSuperExtrusion.3gle.gz

NAME

       gleSuperExtrusion  -  Extrude  arbitrary  2D  contour  along  arbitrary  3D path, specifying local affine
       transformations.

SYNTAX

       void gleSuperExtrusion (int ncp,
                       gleDouble contour[][2],
                       gleDouble cont_normal[][2],
                       gleDouble up[3],
                       int npoints,
                       gleDouble point_array[][3],
                       float color_array[][3],
                 gleDouble xform_array[][2][3]);

ARGUMENTS

       ncp       number of contour points

       contour   2D contour

       cont_normal
                 2D contour normals

       up        up vector for contour

       npoints   numpoints in poly-line

       point_array
                 polyline vertices

       color_array
                 colors at polyline verts

       xform_array
                 2D contour affine transforms

DESCRIPTION

       Extrude arbitrary 2D contour along arbitrary 3D path, specifying local  affine  transformations.  As  the
       contour is extruded, the affine will be applied to the points in the contour.

       The  argument  "contour"  specifies  the  2D  contour  to  be  extruded, while the argument "point_array"
       specifies the path along which to extrude.  The vector "up" defines the orientation of the contour y-axis
       in real 3D space.

       Note  that  neither  the  very  first  segment,  nor  the very last segment are drawn. The first and last
       segments serve only to define the angle of the join at the very ends of the polyline. Thus, to  draw  one
       segment, three must be specified. To draw two segments, four must be specified, etc.

       The  normal  array  may  be  NULL.  If it is, normal vectors will NOT be automatically generated, and the
       object will look terrible when lit.

       The color array may be NULL. If NULL, the current color is used. If not NULL, the glColor3f() routine  is
       used  to  set the color; therefore, specifying the glColorMaterial() subroutine before this primitive can
       be used to set diffuse, specular, ambient, etc. colors.

SEE ALSO

       gleExtrusion, gleTwistExtrusion

AUTHOR

       Linas Vepstas (linas@linas.org)