public class SoLineSet extends SoNonIndexedShape
vertexProperty field (from SoVertexShape), or the current inherited coordinates. For optimal performance, the vertexProperty field is recommended.
Coordinates are used in order, starting with startIndex (zero by default).
If the numVertices field contains -1 (the default), then all the coordinates (starting with startIndex) are rendered as a single polyline.
Otherwise each polyline uses the number of vertices specified by a value in the numVertices field. For example, an SoLineSet with a numVertices of [3,4,2] would use the first three coordinates for the first polyline, the next four coordinates for the second polyline, and the next two coordinates for the third polyline. Thus the number of values in the numVertices field indicates the number of polylines in the set.
The coordinates of the line set are transformed by the current cumulative transformation.
The line width and pattern are controlled by fields in SoDrawStyle.
The lines are drawn with the current drawing style (see SoDrawStyle), but drawing style FILLED is treated as LINES.
Lighting is not applied to lines (i.e., they are rendered with light model BASE_COLOR) unless the application explicitly sets normal vectors using SoVertexProperty or SoNormal.
Treatment of the current material and normal binding is as follows: The PER_PART binding specifies a material or normal for each segment of the line. The PER_FACE binding specifies a material or normal for each polyline. The _INDEXED bindings are equivalent to their non-indexed counterparts. The default material binding is OVERALL. The default normal binding is PER_VERTEX.
The current complexity value has no effect on the rendering of line sets.
Shape Antialiasing type is SoShape.LINES.
Limitations:
SoIndexedLineSet.
File format/default:
LineSet {
| vertexProperty | NULL |
| startIndex | 0 |
| numVertices | -1 |
Action behavior:
SoGLRenderAction
Draws lines based on the current coordinates, normals, materials, drawing style, and so on.
SoRayPickAction
Picks lines based on the current coordinates and transformation. Details about the intersection are returned in an SoLineDetail.
SoGetBoundingBoxAction
Computes the bounding box that encloses all vertices of the line set with the current transformation applied to them. Sets the center to the average of the coordinates of all vertices.
SoCallbackAction
If any line segment callbacks are registered with the action, they will be invoked for each successive segment in the line set.
See also:
SoCoordinate3, SoDrawStyle, SoFullSceneAntialiasing, SoIndexedLineSet, SoLineDetail, SoVertexProperty
SoShape.ShapeTypesInventor.ConstructorCommand| Modifier and Type | Field and Description |
|---|---|
SoMFInt32 |
numVertices
Number of vertices per polyline.
|
startIndexvertexPropertyboundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXTVERBOSE_LEVEL, ZeroHandle| Constructor and Description |
|---|
SoLineSet()
Creates a line set node with default settings.
|
getNormalCachegetShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailableaffectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, writecopyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaultsdispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizablegetAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreadspublic final SoMFInt32 numVertices
Generated on July 23, 2025, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com