SoVRMLIndexedLineSet Class Reference
[VRML97 nodes]

Indexed polyline shape node. More...

#include <Inventor/VRMLnodes/SoVRMLIndexedLineSet.h>

Inheritance diagram for SoVRMLIndexedLineSet:

Public Member Functions
virtual SoType	getTypeId () const
	SoVRMLIndexedLineSet ()
Static Public Member Functions
static SoType	getClassTypeId ()

Detailed Description

Indexed polyline shape node.

See the VRML97 Specification, below.

NOTE: This class does not exist in Open Inventor 10.0 and later.

VRML97 SPECIFICATION

This section may reference portions of the VRML97 specification that are not present in this help file. The complete VRML97 spec is available at http://www.web3d.org .

The SoVRMLIndexedLineSet node represents a 3D geometry formed by constructing polylines from 3D points specified in the coord field. SoVRMLIndexedLineSet uses the indices in its coordIndex field to specify the polylines by connecting together points from the coord field. An index of -1 indicates that the current polyline has ended and the next one begins. The last polyline may (but does not have to be) followed by a -1. SoVRMLIndexedLineSet is specified in the local coordinate system and is affected by parent transformations.

The coord field specifies the 3D vertices of the line set and is specified by an SoVRMLCoordinate node.

Lines are not lit, not texture-mapped, or not collided with during collision detection.

If the color field is not NULL, it must contain an SoVRMLColor node, and the colors are applied to the line(s) as follows:

If colorPerVertex is FALSE:

If the colorIndex field is not empty, then one color is used for each polyline of the SoVRMLIndexedLineSet. There must be at least as many indices in the colorIndex field as there are polylines in the SoVRMLIndexedLineSet. If the greatest index in the colorIndex field is N, then there must be N+1 colors in the SoVRMLColor node. The colorIndex field must not contain any negative entries.

If the colorIndex field is empty, then the colors are applied to each polyline of the SoVRMLIndexedLineSet in order. There must be at least as many colors in the SoVRMLColor node as there are polylines.

If colorPerVertex is TRUE:

If the colorIndex field is not empty, then colors are applied to each vertex of the SoVRMLIndexedLineSet in exactly the same manner that the coordIndex field is used to supply coordinates for each vertex from the SoVRMLCoordinate node. The colorIndex field must contain at least as many indices as the coordIndex field and must contain end-of-polyline markers (-1) in exactly the same places as the coordIndex field. If the greatest index in the colorIndex field is N, then there must be N+1 colors in the SoVRMLColor node.

If the colorIndex field is empty, then the coordIndex field is used to choose colors from the SoVRMLColor node. If the greatest index in the coordIndex field is N, then there must be N+1 colors in the SoVRMLColor node.

If the color field is NULL and there is a Material defined for the SoVRMLAppearance affecting this IndexedLineSet, then use the emissiveColor of the Material to draw the lines. See "Concepts - Lighting Model, Lighting Off" for details on lighting equations.

Shape Antialiasing type is SoShape::LINES.