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.
Treatment of the current material, normal and tangent binding is as follows:
The current complexity value has no effect on the rendering of line sets.
Shape Antialiasing type is SoShape.LINES
.
Lighting:
SoLightModel
model = PER_VERTEX_PHONG). But... SoVertexProperty
or SoNormal
) or sets tangent vectors (using SoVertexProperty
). Normal vectors are not automatically computed for line shapes. SoFaceSet
, using LINES mode (SoDrawStyle
), the rules for polygonal shapes apply (if lighting is enabled and no normal vectors were specified, then normal vectors are automatically computed by Open Inventor). Limitations:
SoIndexedLineSet
.
File format/default:
LineSet {
vertexProperty | NULL |
startIndex | 0 |
numVertices | -1 |
Action behavior:
SoGLRenderAction
Draws lines based on the current coordinates, normals, tangents, 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.ShapeTypes
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoMFInt32 |
numVertices
Number of vertices per polyline.
|
startIndex
vertexProperty
boundingBoxIgnoring
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoLineSet()
Creates a line set node with default settings.
|
getNormalCache, getTangentCache
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
getNativeResourceHandle
public final SoMFInt32 numVertices
Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com