public class SoVRMLIndexedFaceSet extends SoVRMLIndexedShape
<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.
OpenGL vertex arrays are used
colorIndex
, normalIndex
, and texCoordIndex
fields are exactly identical to the coordIndex
field, or are set to their default value (i.e., 1).
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
The SoVRMLIndexedFaceSet
node represents a 3D shape formed by constructing faces (polygons) from vertices listed in the coord field. The coord field must contain an SoVRMLCoordinate
node. SoVRMLIndexedFaceSet
uses the indices in its coordIndex
field to specify the polygonal faces. An index of 1 indicates that the current face has ended and the next one begins. The last face may (but does not have to be) followed by a 1. If the greatest index in the coordIndex
field is N, then the SoVRMLCoordinate
node must contain N+1 coordinates (indexed as 0N). SoVRMLIndexedFaceSet
is specified in the local coordinate system and is affected by parent transformations.
For descriptions of the coord , normal , and texCoord fields, see the SoVRMLCoordinate
, SoVRMLNormal
, and SoVRMLTextureCoordinate
nodes.
See "Concepts  Lighting Model" for details on lighting equations and the interaction between textures, materials, and geometries.
If the color field is not NULL then it must contain an SoVRMLColor
node, whose colors are applied to the vertices or faces of the SoVRMLIndexedFaceSet
as follows:
SoVRMLIndexedFaceSet
. There must be at least as many indices in the colorIndex field as there are faces in the SoVRMLIndexedFaceSet
. 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.
SoVRMLIndexedFaceSet
in order. There must be at least as many colors in the SoVRMLColor
node as there are faces.
SoVRMLIndexedFaceSet
in exactly the same manner that the coordIndex
field is used to choose 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 endofface 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.
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 normal field is NULL, then the browser should automatically generate normals, using creaseAngle
to determine if and how normals are smoothed across shared vertices.
If the normal field is not NULL, then it must contain an SoVRMLNormal
node, whose normals are applied to the vertices or faces of the SoVRMLIndexedFaceSet
in a manner exactly equivalent to that described above for applying colors to vertices/faces.
If the texCoord field is not NULL, then it must contain an SoVRMLTextureCoordinate
node. The texture coordinates in that node are applied to the vertices of the SoVRMLIndexedFaceSet
as follows:
SoVRMLIndexedFaceSet
in exactly the same manner that the coordIndex
field is used to choose coordinates for each vertex from the SoVRMLCoordinate
node. The texCoordIndex field must contain at least as many indices as the coordIndex
field, and must contain endofface markers (1) in exactly the same places as the coordIndex
field. If the greatest index in the texCoordIndex field is N, then there must be N+1 texture coordinates in the SoVRMLTextureCoordinate
node.
coordIndex
array is used to choose texture coordinates from the SoVRMLTextureCoordinate
node. If the greatest index in the coordIndex
field is N, then there must be N+1 texture coordinates in the SoVRMLTextureCoordinate
node.
If the texCoord field is NULL, a default texture coordinate mapping is calculated using the bounding box of the shape. The longest dimension of the bounding box defines the S coordinates, and the next longest defines the T coordinates. If two or all three dimensions of the bounding box are equal, then ties should be broken by choosing the X, Y, or Z dimension in that order of preference. The value of the S coordinate ranges from 0 to 1, from one end of the bounding box to the other. The T coordinate ranges between 0 and the ratio of the second greatest dimension of the bounding box to the greatest dimension. See the figure below for an illustration of default texture coordinates for a simple box shaped SoVRMLIndexedFaceSet
with a bounding box with X dimension twice as large as the Z dimension which is twice as large as the Y dimension:
See the introductory "Concepts  Geometry" section for a description of the ccw
, solid
, convex
, and creaseAngle
fields.
NOTE: An indexed face set may not render or pick correctly if any of its polygons are selfintersecting or nonplanar.
File format/default:
VRMLIndexedFaceSet {
color  NULL 
coord  NULL 
normal  NULL 
texCoord  NULL 
ccw  true 
colorIndex  [] 
colorPerVertex  true 
convex  true 
coordIndex  [] 
creaseAngle  0 
normalIndex  [] 
normalPerVertex  true 
solid  true 
texCoordIndex  [] 
metadata  NULL 
Action behavior:
SoGLRenderAction
, SoRayPickAction
, SoGetBoundingBoxAction
, SoCallbackAction
SoMFint32  set_colorIndex 
SoMFint32  set_coordIndex 
SoMFint32  set_normalIndex 
SoMFint32  set_texCoordIndex 
SoSFNode  set_color 
SoSFNode  set_coord 
SoSFNode  set_normal 
SoSFNode  set_texCoord 
SoSFNode  set_metadata 
SoSFNode  color_changed 
SoSFNode  coord_changed 
SoSFNode  normal_changed 
SoSFNode  texCoord_changed 
SoSFNode  metadata_changed 
SoShape.ShapeTypes
Inventor.ConstructorCommand
Modifier and Type  Field and Description 

SoSFBool 
ccw
Deprecated.
Indicates whether the vertices are ordered in a counterclockwise direction when viewed from the outside (true) or in a clockwise direction (false).

SoSFBool 
convex
Deprecated.
Indicates whether faces of a shape are convex (true).

SoSFFloat 
creaseAngle
Deprecated.
Indicates the minimum angle (in radians) between two adjacent face normals required to form a sharp crease at the edge when default normals are computed and used.

SoSFBool 
solid
Deprecated.
If you know that the shape encloses a volume, set this value to true.

colorIndex, coordIndex, normalIndex, texCoordIndex
color, colorPerVertex, coord, normal, normalPerVertex, texCoord
metadata
boundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXT
VERBOSE_LEVEL, ZeroHandle
Constructor and Description 

SoVRMLIndexedFaceSet()
Deprecated.
Constructor.

getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
affectsState, 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, write
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable
getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads
public final SoSFBool ccw
public final SoSFBool solid
public final SoSFBool convex
public final SoSFFloat creaseAngle
Generated on January 29, 2020, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com