logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SoFaceSet — polygonal face shape node

Action Behavior

SoGLRenderAction
          Draws faces based on the current coordinates, normals, materials, drawing style, and so on.

     SoRayPickAction
          Picks  faces  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 face 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 generated from each face in the set.

Description

       This  node  represents  a  3D  shape formed by constructing faces (polygons) from vertices located at the
       coordinates specified in the vertexProperty field (from SoVertexShape), or the current  inherited  state.
       For optimal performance, the vertexProperty field is recommended.

       SoFaceSet  uses the coordinates in order, starting with the first one. Each face has a number of vertices
       specified by a value in the numVertices field. For example, an  SoFaceSet  with  numVertices  of  [3,4,4]
       would use coordinates 1, 2, and 3 for the first face, coordinates 4, 5, 6, and 7 for the second face, and
       coordinates  8,  9, 10, and 11 for the third. For improved performance, arrange all the faces with only 3
       vertices at beginning of the list, then all faces with 4 vertices, and finally all other faces.

       The number of values in the numVertices field indicates the number of faces in the set.

       The coordinates of the face set are transformed by the current cumulative transformation. The  faces  are
       drawn with the current light model and drawing style.

       Treatment  of  the  current material and normal binding is as follows: The PER_PART and PER_FACE bindings
       specify a material or normal for each face. The _INDEXED bindings are  equivalent  to  their  non-indexed
       counterparts. The default material binding is OVERALL. The default normal binding is PER_VERTEX.

       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

SoMFInt32numVertices
          Number of vertices per face.

File Format/Defaults

FaceSet{vertexPropertyNULLstartIndex0numVertices-1}

Inherits From

       SoBase > SoFieldContainer > SoNode > SoShape > SoVertexShape > SoNonIndexedShape > SoFaceSet

Methods

SoFaceSet()
          Creates a face set node with default settings.

     staticSoTypegetClassTypeId()
          Returns type identifier for this class.

Name

       SoFaceSet — polygonal face shape node

See Also

SoCoordinate3,SoDrawStyle,SoIndexedFaceSet,SoFaceDetail,SoVertexPropertySoFaceSet(3IV)()

Synopsis

#include<Inventor/nodes/SoFaceSet.h>

          Fields from class SoFaceSet:

     SoMFInt32numVertices

          Fields from class SoNonIndexedShape:

     SoSFInt32startIndex

          Fields from class SoVertexShape:

     SoSFNodevertexProperty

          Methods from class SoFaceSet:

                         SoFaceSet()staticSoTypegetClassTypeId()

          Methods from class SoNode:

     voidsetOverride(SbBoolstate)SbBoolisOverride()constSoNode*copy(SbBoolcopyConnections=FALSE)constvirtualSbBoolaffectsState()conststaticSoNode*getByName(constSbName&name)staticintgetByName(constSbName&name,SoNodeList&list)

          Methods from class SoFieldContainer:

     voidsetToDefaults()SbBoolhasDefaultValues()constSbBoolfieldsAreEqual(constSoFieldContainer*fc)constvoidcopyFieldValues(constSoFieldContainer*fc,SbBoolcopyConnections=FALSE)SbBoolset(constchar*fieldDataString)voidget(SbString&fieldDataString)virtualintgetFields(SoFieldList&resultList)constvirtualSoField*getField(constSbName&fieldName)constSbBoolgetFieldName(constSoField*field,SbName&fieldName)constSbBoolisNotifyEnabled()constSbBoolenableNotify(SbBoolflag)

          Methods from class SoBase:

     voidref()voidunref()constvoidunrefNoDelete()constvoidtouch()virtualSoTypegetTypeId()constSbBoolisOfType(SoTypetype)constvirtualvoidsetName(constSbName&name)virtualSbNamegetName()const

See Also