Coin Logo http://www.sim.no
http://www.coin3d.org

SoNonIndexedShape Class Reference
[Nodes]

The SoNonIndexedShape class is the superclass for all non-indexed vertex based shapes.

It contains the (now obsoleted) startIndex field and a convenience method for calculating the bounding box. More...

#include <Inventor/nodes/SoNonIndexedShape.h>

Inheritance diagram for SoNonIndexedShape:

SoVertexShape SoShape SoNode SoFieldContainer SoBase SoFaceSet SoLineSet SoPointSet SoQuadMesh SoTriangleStripSet SoMarkerSet

List of all members.

Public Member Functions

virtual SoType getTypeId (void) const

Static Public Member Functions

static SoType getClassTypeId (void)
static void initClass (void)

Public Attributes

SoSFInt32 startIndex

Protected Member Functions

virtual const SoFieldDatagetFieldData (void) const
 SoNonIndexedShape (void)
virtual ~SoNonIndexedShape ()
void computeCoordBBox (SoAction *action, int numVertices, SbBox3f &box, SbVec3f &center)
void fixNumVerticesPointers (SoState *state, const int32_t *&start, const int32_t *&end, int32_t *dummyarray) const

Static Protected Member Functions

static const SoFieldData ** getFieldDataPtr (void)


Detailed Description

The SoNonIndexedShape class is the superclass for all non-indexed vertex based shapes.

It contains the (now obsoleted) startIndex field and a convenience method for calculating the bounding box.


Constructor & Destructor Documentation

SoNonIndexedShape::SoNonIndexedShape ( void   )  [protected]

Constructor.

References startIndex.

SoNonIndexedShape::~SoNonIndexedShape (  )  [protected, virtual]

Destructor.


Member Function Documentation

SoType SoNonIndexedShape::getClassTypeId ( void   )  [static]

This static method returns the SoType object associated with objects of this class.

Reimplemented from SoVertexShape.

Reimplemented in SoFaceSet, SoLineSet, SoMarkerSet, SoPointSet, SoQuadMesh, and SoTriangleStripSet.

SoType SoNonIndexedShape::getTypeId ( void   )  const [virtual]

Returns the type identification of an object derived from a class inheriting SoBase. This is used for run-time type checking and "downward" casting.

Usage example:

  void foo(SoNode * node)
  {
    if (node->getTypeId() == SoFile::getClassTypeId()) {
      SoFile * filenode = (SoFile *)node;  // safe downward cast, knows the type
    }
    else if (node->getTypeId().isOfType(SoGroup::getClassTypeId())) {
      SoGroup * group = (SoGroup *)node;  // safe downward cast, knows the type
    }
  }

For application programmers wanting to extend the library with new nodes, engines, nodekits, draggers or others: this method needs to be overridden in all subclasses. This is typically done as part of setting up the full type system for extension classes, which is usually accomplished by using the pre-defined macros available through for instance Inventor/nodes/SoSubNode.h (SO_NODE_INIT_CLASS and SO_NODE_CONSTRUCTOR for node classes), Inventor/engines/SoSubEngine.h (for engine classes) and so on.

For more information on writing Coin extensions, see the class documentation of the toplevel superclasses for the various class groups.

Reimplemented from SoVertexShape.

Reimplemented in SoFaceSet, SoLineSet, SoMarkerSet, SoPointSet, SoQuadMesh, and SoTriangleStripSet.

const SoFieldData ** SoNonIndexedShape::getFieldDataPtr ( void   )  [static, protected]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Reimplemented from SoVertexShape.

Reimplemented in SoFaceSet, SoLineSet, SoMarkerSet, SoPointSet, SoQuadMesh, and SoTriangleStripSet.

const SoFieldData * SoNonIndexedShape::getFieldData ( void   )  const [protected, virtual]

Returns a pointer to the class-wide field data storage object for this instance. If no fields are present, returns NULL.

Reimplemented from SoVertexShape.

Reimplemented in SoFaceSet, SoLineSet, SoMarkerSet, SoPointSet, SoQuadMesh, and SoTriangleStripSet.

void SoNonIndexedShape::initClass ( void   )  [static]

Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.

Reimplemented from SoVertexShape.

Reimplemented in SoFaceSet, SoLineSet, SoMarkerSet, SoPointSet, SoQuadMesh, and SoTriangleStripSet.

void SoNonIndexedShape::computeCoordBBox ( SoAction action,
int  numVertices,
SbBox3f box,
SbVec3f center 
) [protected]

This method is provided as a convenient means for the subclasses of this class to find their bounding box and center value.

The returned bounding box will enclose all vertices from startIndex up to startIndex + numVertices. If numVertices is less than zero, all vertices in the current coordinate element or vertex property node will be used in the calculation.

The center point will be calculated as the average of all the vertices in the bounding box.

References SbBox3f::extendBy(), SoVertexProperty::getClassTypeId(), SoMField::getNum(), SbVec4f::getReal(), SoAction::getState(), SoSFInt32::getValue(), SoSFNode::getValue(), SoMFVec3f::getValues(), SbVec3f::setValue(), startIndex, SoVertexProperty::vertex, and SoVertexShape::vertexProperty.

Referenced by SoTriangleStripSet::computeBBox(), SoQuadMesh::computeBBox(), SoPointSet::computeBBox(), SoLineSet::computeBBox(), and SoFaceSet::computeBBox().

void SoNonIndexedShape::fixNumVerticesPointers ( SoState state,
const int32_t *&  start,
const int32_t *&  end,
int32_t *  dummyarray 
) const [protected]

Convenience method that might adjust start and end pointers, which should point at the start and end of the numVertices array when calling this method. This takes care of the case where numVertices contains a single -1, and all coordinates in the state (or in the vertexProperty field) should be rendered as one primitive.

dummyarray should be a temporary array, with room for one integer.

Not part of the OIV API.

References SoMField::getNum(), SoSFInt32::getValue(), SoSFNode::getValue(), startIndex, SoVertexProperty::vertex, and SoVertexShape::vertexProperty.

Referenced by SoTriangleStripSet::generateDefaultNormals(), SoFaceSet::generateDefaultNormals(), SoTriangleStripSet::generatePrimitives(), SoLineSet::generatePrimitives(), SoFaceSet::generatePrimitives(), SoTriangleStripSet::getPrimitiveCount(), SoLineSet::getPrimitiveCount(), SoFaceSet::getPrimitiveCount(), SoTriangleStripSet::GLRender(), SoLineSet::GLRender(), and SoFaceSet::GLRender().


Member Data Documentation


The documentation for this class was generated from the following files:

Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.

Generated on Mon Feb 23 16:33:55 2009 for Coin by Doxygen. 1.5.8