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

FreeBSD Manual Pages


home | help
SoVertexShape(3IV)()					  SoVertexShape(3IV)()

       SoVertexShape --	abstract base class for	all vertex-based shape nodes

       SoBase >	SoFieldContainer > SoNode > SoShape > SoVertexShape

       #include	<Inventor/nodes/SoVertexShape.h>

	  Fields from class SoVertexShape:

     SoSFNode		 vertexProperty

	  Methods from class SoVertexShape:

     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)
     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

       This node is the	abstract base class for	all vertex-based shape (geome-
       try) nodes. It is used as a repository for  convenience	functions  for
       subclasses  and	to provide a type identifier to	make it	easy to	deter-
       mine whether a shape is vertex-based. It	contains one public field, the
       SoVertexProperty	field.

       All  subclasses of this node draw objects constructed from vertices. If
       the vertexProperty field	is non-null and	there are coordinates  in  the
       associated  vertex property node, then those coordinates	are used. Oth-
       erwise the objects are drawn  using  the	 current  coordinates  in  the
       state.  The  coordinates	 of  the  shape	are transformed	by the current
       transformation matrix and are drawn with	the current  light  model  and
       drawing style.

       Subclasses that construct polygons from vertices	may not	render or pick
       correctly if any	of their polygons are self-intersecting	or non-planar.

       All vertex shape	subclasses use the bounding box	of the shape to	deter-
       mine default texture coordinates. The longest dimension of the bounding
       box defines the S coordinates, and the next longest defines the T coor-
       dinates.	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.

       When a vertex-based shape is picked with	an SoRayPickAction,  a	detail
       is  always returned. If the shape is composed of	faces (such as SoFace-
       Set or SoTriangleStripSet), an SoFaceDetail is returned.	 If the	 shape
       is  composed  of	 line segments (such as	SoLineSet), an SoLineDetail is
       returned. If the	shape is composed of points (such as  SoPointSet),  an
       SoPointDetail is	returned. Note that the	type of	detail returned	is not
       affected	by the current drawing style.

       Similarly, each class of	vertex-based shape invokes  appropriate	 call-
       backs  if  those	 callbacks  are	 registered with the SoCallbackAction.
       Shapes made of faces invoke triangle callbacks for each generated  tri-
       angle.	(Faces	may be triangulated to create these triangles.)	Shapes
       made of line segments invoke line segment callbacks for	each  segment,
       and shapes made of points invoke	point callbacks.

       The  subclass  SoIndexedShape  is  a base class for vertex-based	shapes
       that index into the current set of coordinates. The  subclass  SoNonIn-
       dexedShape is a base class for vertex-based shapes that use the current
       coordinates in order.

     SoSFNode		 vertexProperty
	  vertex property node.

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

       This is an abstract class. See the reference page of  a	derived	 class
       for the format and default values.

       SoIndexedShape, SoNonIndexedShape, SoVertexProperty



Want to link to this manual page? Use this URL:

home | help