SoTriangleStripSet(3IV)NAMESoTriangleStripSet (SoTriStripSet) - triangle strip set shape node
INHERITS FROM
SoBase > SoFieldContainer > SoNode > SoShape > SoVertexShape >
SoNonIndexedShape > SoTriangleStripSetSYNOPSIS
#include <Inventor_c/nodes/SoTriangleStripSet.h>
typedef SoTriangleStripSet SoTriStripSet
Fields from class SoTriangleStripSet:
SoMFInt32 numVertices
Fields from class SoNonIndexedShape:
SoSFInt32 startIndex
Fields from class SoVertexShape:
SoSFNode vertexProperty
Functions from class SoTriangleStripSet:
SoTriangleStripSet * SoTriStripSetCreate()
SoType SoTriStripSetGetClassTypeId()
Functions from class SoNode:
void SoTriStripSetSetOverride(SoTriStripSet *this, SbBool
state)
SbBool SoTriStripSetIsOverride(const SoTriStripSet *this)
SoNode * SoTriStripSetCopy(const SoTriStripSet *this, SbBool
copyConnections = FALSE)
SbBool SoTriStripSetAffectsState(const SoTriStripSet *this)
SoNode * SoTriStripSetGetByName(const char *name)
int SoTriStripSetGetByNameList(const char *name,
SoNodeList *list)
Functions from class SoFieldContainer:
void SoTriStripSetSetToDflts(SoTriStripSet *this)
SbBool SoTriStripSetHasDfltVals(const SoTriStripSet *this)
SbBool SoTriStripSetFldsAreEq(const SoTriStripSet *this,
const SoFieldContainer *fc)
void SoTriStripSetCopyFieldVals(SoTriStripSet *this, const
SoFieldContainer *fc, SbBool copyConnections =
FALSE)
SbBool SoTriStripSetSet(SoTriStripSet *this, const char
*fieldDataString)
Page 1SoTriangleStripSet(3IV)
void SoTriStripSetGet(SoTriStripSet *this, SbString
*fieldDataString)
int SoTriStripSetGetFields(const SoTriStripSet *this,
SoFieldList *resultList)
SoField * SoTriStripSetGetField(const SoTriStripSet *this,
const char *fieldName)
SbBool SoTriStripSetGetFieldName(const SoTriStripSet *this,
const SoField *field, SbName *fieldName)
SbBool SoTriStripSetIsNotifyEnabled(const SoTriStripSet
*this)
SbBool SoTriStripSetEnableNotify(SoTriStripSet *this, SbBool
flag)
Functions from class SoBase:
void SoTriStripSetRef(SoTriStripSet *this)
void SoTriStripSetUnref(const SoTriStripSet *this)
void SoTriStripSetUnrefNoDelete(const SoTriStripSet *this)
void SoTriStripSetTouch(SoTriStripSet *this)
SoType SoTriStripSetGetTypeId(const SoTriStripSet *this)
SbBool SoTriStripSetIsOfType(const SoTriStripSet *this,
SoType type)
void SoTriStripSetSetName(SoTriStripSet *this, const char
*name)
SbName SoTriStripSetGetName(const SoTriStripSet *this)
DESCRIPTION
This shape node constructs triangle strips out of vertices. The vertices
may be specified in the vertexProperty field (from SoVertexShape), or by
the current inherited coordinates. For optimal performance, the
vertexProperty field is recommended.
SoTriangleStripSet is one of the fastest ways of drawing polygonal
objects in Inventor. It uses the current coordinates, in order, starting
with the first one. The values in the numVertices field indicate the
number of vertices to use for each triangle strip in the set. The number
of values in this field determines the number of strips.
For example, if numVertices has the values [3,5], coordinates 1, 2, and 3
would be used for the first triangle strip and coordinates 4, 5, 6, 7,
and 8 would be used for the second strip. This would result in 1 triangle
in the first strip and 3 in the second.
The coordinates of the strips are transformed by the current cumulative
transformation. The strips are drawn with the current light model and
drawing style.
Treatment of the current material and normal binding is as follows: The
PER_PART binding specifies a material or normal for each strip of the
set. The PER_FACE binding specifies a material or normal for each
triangle. The _INDEXED bindings are equivalent to their non-indexed
Page 2SoTriangleStripSet(3IV)
counterparts. The default normal binding is PER_VERTEX. The default
material binding is OVERALL.
If any normals (or materials) are specified, Inventor assumes you provide
the correct number of them, as indicated by the binding. You will see
unexpected results if you specify fewer normals (or materials) than the
shape requires. If no normals are specified, they will be generated
automatically.
FIELDS
SoMFInt32 numVertices
Number of vertices in each triangle strip. The number of strips is
equal to the number of values in this field.
FUNCTIONSSoTriangleStripSet * SoTriStripSetCreate()
Creates a triangle strip set node with default settings.
SoType SoTriStripSetGetClassTypeId()
Returns type identifier for this class.
ACTION BEHAVIOR
SoGLRenderAction
Draws a strip set based on the current coordinates, normals,
materials, drawing style, and so on.
SoRayPickAction
Picks on the strip set based on the current coordinates and
transformation. Details about the intersection are returned in an
SoFaceDetail.
SoGetBoundingBoxAction
Computes the bounding box that encloses all vertices of the strip
set with the current transformation applied to them. Sets the center
to the average of the coordinates of all vertices.
SoCallbackAction
If any triangle callbacks are registered with the action, they will
be invoked for each successive triangle forming the strips of the
set.
FILE FORMAT/DEFAULTS
TriangleStripSet {
vertexProperty NULL
startIndex 0
numVertices -1
}
Page 3SoTriangleStripSet(3IV)SEE ALSO
SoCoordinate3, SoDrawStyle, SoFaceDetail, SoFaceSet,
SoIndexedTriangleStripSet, SoQuadMesh, SoVertexProperty
Page 4
