SYNOPSIS

#include <Inventor/details/SoPointDetail.h>

Inherits SoDetail.

Public Member Functions

virtual SoType getTypeId (void) const

SoPointDetail (void)

virtual ~SoPointDetail ()

virtual SoDetail * copy (void) const

int getCoordinateIndex (void) const

int getMaterialIndex (void) const

int getNormalIndex (void) const

int getTextureCoordIndex (void) const

void setCoordinateIndex (const int idx)

void setMaterialIndex (const int idx)

void setNormalIndex (const int idx)

void setTextureCoordIndex (const int idx)

Static Public Member Functions

static SoType getClassTypeId (void)

static void cleanupClass (void)

static void initClass (void)

Additional Inherited Members

Detailed Description

The SoPointDetail class is for storing detailed information for a single 3D point.

Instances of this class are used among other things for storing information about the vertices of lines and polygons after pick operations, and for storing information returned to tessellation callbacks.

It contains indices into the vertex coordinate sets, along with indices into material, texture and normal coordinates for the point.

Constructor & Destructor Documentation

SoPointDetail::SoPointDetail (void)

Sets up an empty detail instance (all indices are equal to 0).

SoPointDetail::~SoPointDetail ()\fC [virtual]\fP

Destructor.

Member Function Documentation

\fBSoType\fP SoPointDetail::getTypeId (void) const\fC [virtual]\fP

Returns the type identification of a detail derived from a class inheriting SoDetail. This is used for run-time type checking and 'downward' casting.

Usage example:

void fuhbear(SoDetail * detail)
{
  if (detail->getTypeId() == SoFaceDetail::getClassTypeId()) {
    // safe downward cast, know the type
    SoFaceDetail * facedetail = (SoFaceDetail *)detail;
  }
  return; // ignore if not a SoFaceDetail
}

For application programmers wanting to extend the library with new detail classes: 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 Inventor/nodes/SoSubDetail.h: SO_DETAIL_SOURCE and SO_DETAIL_INIT_CLASS.

Implements SoDetail.

\fBSoDetail\fP * SoPointDetail::copy (void) const\fC [virtual]\fP

Return a deep copy of ourself.

Note that if the Coin library has been built as a DLL under Microsoft Windows and you use this method from application code, you must make sure that both the Coin DLL and the application executable is using the same instance of a C Run-Time (CRT) library. Otherwise, you will get memory heap corruption upon deallocating the returned instances, eventually leading to mysterious crashes.

Implements SoDetail.

int SoPointDetail::getCoordinateIndex (void) const

Returns index into coordinate set for the point's 3D coordinates.

int SoPointDetail::getMaterialIndex (void) const

Returns point's index into set of materials.

int SoPointDetail::getNormalIndex (void) const

Returns point's index into set of normals.

int SoPointDetail::getTextureCoordIndex (void) const

Returns point's index into set of texture coordinates.

void SoPointDetail::setCoordinateIndex (const intidx)

Used by client code for initializing the point detail instance.

void SoPointDetail::setMaterialIndex (const intidx)

Used by client code for initializing the point detail instance.

void SoPointDetail::setNormalIndex (const intidx)

Used by client code for initializing the point detail instance.

void SoPointDetail::setTextureCoordIndex (const intidx)

Used by client code for initializing the point detail instance.

Author

Generated automatically by Doxygen for Coin from the source code.