Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SoIndexedFaceSet(3IV)()				       SoIndexedFaceSet(3IV)()

NAME
       SoIndexedFaceSet	-- indexed polygonal face shape	node

INHERITS FROM
       SoBase  >  SoFieldContainer  > SoNode > SoShape > SoVertexShape > SoIn-
       dexedShape > SoIndexedFaceSet

SYNOPSIS
       #include	<Inventor/nodes/SoIndexedFaceSet.h>

	  Fields from class SoIndexedShape:

     SoMFInt32		 coordIndex
     SoMFInt32		 materialIndex
     SoMFInt32		 normalIndex
     SoMFInt32		 textureCoordIndex

	  Fields from class SoVertexShape:

     SoSFNode		 vertexProperty

	  Methods from class SoIndexedFaceSet:

			 SoIndexedFaceSet()
     static SoType	 getClassTypeId()

	  Methods from class SoNode:

     void		 setOverride(SbBool state)
     SbBool		 isOverride() const
     SoNode *		 copy(SbBool copyConnections = FALSE) const
     virtual SbBool	 affectsState()	const
     static SoNode *	 getByName(const SbName	&name)
     static int		 getByName(const SbName	&name, SoNodeList &list)

	  Methods from class SoFieldContainer:

     void		 setToDefaults()
     SbBool		 hasDefaultValues() const
     SbBool		 fieldsAreEqual(const SoFieldContainer *fc) const
     void		 copyFieldValues(const	SoFieldContainer  *fc,	SbBool
			      copyConnections =	FALSE)
     SbBool		 set(const char	*fieldDataString)
     void		 get(SbString &fieldDataString)
     virtual int	 getFields(SoFieldList &resultList) const
     virtual SoField *	 getField(const	SbName &fieldName) const
     SbBool		 getFieldName(const SoField *field, SbName &fieldName)
			      const
     SbBool		 isNotifyEnabled() const
     SbBool		 enableNotify(SbBool flag)

	  Methods from class SoBase:

     void		 ref()
     void		 unref() const
     void		 unrefNoDelete() const
     void		 touch()
     virtual SoType	 getTypeId() const
     SbBool		 isOfType(SoType type) const
     virtual void	 setName(const SbName &name)
     virtual SbName	 getName() const

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

       SoIndexedFaceSet	 uses  the indices in the coordIndex field (from SoIn-
       dexedShape) to specify the polygonal faces. An index of SO_END_FACE_IN-
       DEX (-1)	indicates that the current face	has ended and the next one be-
       gins. For improved performance, arrange all the faces with only 3  ver-
       tices at	beginning of the list, then all	faces with 4 vertices, and fi-
       nally all other faces.

       The vertices of the faces are transformed by the	current	transformation
       matrix.	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. PER_VERTEX	specifies a material or	normal for  each  vertex.  The
       corresponding _INDEXED bindings are the same, but use the materialIndex
       or normalIndex indices (see SoIndexedShape). The	default	material bind-
       ing is OVERALL. The default normal binding is PER_VERTEX_INDEXED.

       If  any normals (or materials) are specified, Inventor assumes you pro-
       vide 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.

       Textures	are applied as described for the SoIndexedShape	class.

METHODS
			 SoIndexedFaceSet()
	  Creates an indexed face set node with	default	settings.

     static SoType	 getClassTypeId()
	  Returns type identifier for this class.

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. De-
	  tails	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.

FILE FORMAT/DEFAULTS
       IndexedFaceSet {
	  vertexProperty     NULL
	  coordIndex	     0
	  materialIndex	     -1
	  normalIndex	     -1
	  textureCoordIndex  -1
     }

SEE ALSO
       SoCoordinate3, SoDrawStyle, SoFaceDetail, SoFaceSet, SoVertexProperty

						       SoIndexedFaceSet(3IV)()

NAME | INHERITS FROM | SYNOPSIS | DESCRIPTION | METHODS | ACTION BEHAVIOR | FILE FORMAT/DEFAULTS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SoIndexedFaceSet&sektion=3iv&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help