# IndexedLineSet

IndexedLineSet is a geometry node that can contain a Coordinate|CoordinateDouble node and an (optional) Color|ColorRGBA node. Color values or a sibling Material emissiveColor is used to draw lines and points. Lines are not lit, are not texture-mapped, and do not participate in collision detection.

The IndexedLineSet node belongs to the **Rendering** component and its container field is *geometry.* It is available since X3D version 3.0 or later.

# Fields

### SFNode [in, out] **metadata** NULL [X3DMetadataObject]

Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.

### MFInt32 [in] **set_colorIndex** [0,∞) or -1

ColorIndex indices provide order in which colors are applied.

#### Hints

If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included. If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions. If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.

### MFInt32 [in] **set_coordIndex **[0,∞) or -1

CoordIndex indices provide the order in which coordinates are applied to construct each polyline. Order starts at index 0, commas are optional between sets.

#### Hint

Sentinel value -1 is used to separate indices for each successive polyline.

### SFBool [ ] **colorPerVertex** TRUE

Whether Color node color values are applied to each vertex (true) or per polyline (false).

#### See Also

### MFInt32 [ ] **colorIndex** [ ] [0,∞) or -1

ColorIndex indices provide order in which colors are applied.

#### Hints

If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included. If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions. If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.

### MFInt32 [ ] **coordIndex** [ ] [0,∞) or -1

CoordIndex indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets, use -1 to separate indices for each polyline.

#### Hint

If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.

### MFNode [in, out] **attrib** [ ] [X3DVertexAttributeNode]

Input/Output field attrib.

### SFNode [in, out] **fogCoord** NULL [FogCoordinate]

Input/Output field fogCoord.

### SFNode [in, out] **color** NULL [X3DColorNode]

Input/Output field color.

### SFNode [in, out] **coord** NULL [X3DCoordinateNode]

Input/Output field coord.

# Description

## Hints

- Use a different color (or emissiveColor) than the background color.
- If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat each initial vertex to close each polygon outline. Step-wise colors or linear interpolation of colors can be used as a good scientific visualization technique to map arbitrary function values to a color map.
- Insert a Shape node before adding geometry or Appearance.
- You can also substitute a type-matched ProtoInstance node for contained content.
- Consider including Fog to provide further depth cueing for IndexedLineSet (ILS).