See the VRML97 Specification, below.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

VRML97 SPECIFICATION

This section describes the expected behavior of the node in a conforming VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.

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.

FILE FORMAT/DEFAULT

VRMLIndexedLineSet {

color	NULL
colorIndex	[]
colorPerVertex	true
coord	NULL
coordIndex	[]
metadata	NULL

}

ACTION BEHAVIOR

SoGLRenderAction, SoRayPickAction, SoGetBoundingBoxAction, SoCallbackAction

EVENTS

eventIn

SoSFNode	set_color
SoMFInt32	set_colorIndex
SoSFNode	set_coord
SoMFInt32	set_coordIndex
SoSFNode	set_metadata

eventOut

SoSFNode	color_changed
SoSFNode	coord_changed
SoSFNode	metadata_changed

Obsoletesince Open Inventor 9500 The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

Reference