osg::FaceIterator Class Reference
[Geometry Iterators]

Geometry Iterator for faces (tris and quads). See Geometry Iterators for a description. More...

#include <OSGFaceIterator.h>

Inheritance diagram for osg::FaceIterator:

List of all members.

Public Member Functions
Constructors
	FaceIterator (void)
	FaceIterator (const FaceIterator &source)
	FaceIterator (const GeometryPtr &geo)
	FaceIterator (const NodePtr &geo)
Destructors
virtual	~FaceIterator (void)
Access
Int32	getIndex (void) const
UInt32	getLength (void) const
Int32	getPositionIndex (Int32 which) const
Pnt3f	getPosition (Int32 which) const
Int32	getNormalIndex (Int32 which) const
Vec3f	getNormal (Int32 which) const
Int32	getColorIndex (Int32 which) const
Color3f	getColor (Int32 which) const
Int32	getSecondaryColorIndex (Int32 which) const
Color3f	getSecondaryColor (Int32 which) const
Int32	getTexCoordsIndex (Int32 which) const
Vec2f	getTexCoords (Int32 which) const
Int32	getTexCoordsIndex1 (Int32 which) const
Vec2f	getTexCoords1 (Int32 which) const
Int32	getTexCoordsIndex2 (Int32 which) const
Vec2f	getTexCoords2 (Int32 which) const
Int32	getTexCoordsIndex3 (Int32 which) const
Vec2f	getTexCoords3 (Int32 which) const
Int32	getTexCoordsIndex4 (Int32 which) const
Vec2f	getTexCoords4 (Int32 which) const
Int32	getTexCoordsIndex5 (Int32 which) const
Vec2f	getTexCoords5 (Int32 which) const
Int32	getTexCoordsIndex6 (Int32 which) const
Vec2f	getTexCoords6 (Int32 which) const
Int32	getTexCoordsIndex7 (Int32 which) const
Vec2f	getTexCoords7 (Int32 which) const
Int32	getIndexIndex (Int32 which) const
Operators
void	seek (Int32 index)
void	operator++ (void)
FaceIterator &	operator= (const FaceIterator &source)
bool	operator< (const FaceIterator &other) const
bool	operator== (const FaceIterator &other) const
bool	operator!= (const FaceIterator &other) const
Field Set
void	setToBegin (void)
void	setToEnd (void)
Set
void	setGeo (const GeometryPtr &geo)
void	setGeo (const NodePtr &geo)
Get
bool	isAtEnd (void) const
UInt32	getType (void) const
GeometryPtr	getGeometry (void) const
Operators
bool	operator< (const PrimitiveIterator &other) const
bool	operator== (const PrimitiveIterator &other) const
bool	operator!= (const PrimitiveIterator &other) const
Static Public Member Functions
Class Get
static const char *	getClassname (void)
Protected Types
typedef PrimitiveIterator	Inherited
Private Member Functions
void	startPrim (void)
Private Attributes
Int32	_faceIndex
UInt32	_actPrimIndex
Int32	_facePntIndex [4]
Static Private Attributes
static char	cvsid [] = "@(#)$Id: OSGFaceIterator.cpp,v 1.13 2001/11/01 09:03:28 vossg Exp $"

---

Detailed Description

The FaceIterator iterates through the geometry one face at a time. See Face Iterator for a description.

See also:

PrimitiveIterator FaceIterator

Definition at line 60 of file OSGFaceIterator.h.

---

Member Typedef Documentation

typedef PrimitiveIterator osg::FaceIterator::Inherited [protected]

Definition at line 152 of file OSGFaceIterator.h.

---

Constructor & Destructor Documentation

FaceIterator::FaceIterator

(

void

)

Definition at line 109 of file OSGFaceIterator.cpp.

                               :  PrimitiveIterator(),
    _faceIndex(0), _actPrimIndex(), _facePntIndex()
{
}

FaceIterator::FaceIterator

(

const FaceIterator &

source

)

Definition at line 114 of file OSGFaceIterator.cpp.

References _facePntIndex.

                                                     :
    PrimitiveIterator(source),
    _faceIndex(source._faceIndex),
    _actPrimIndex(source._actPrimIndex),
    _facePntIndex()
{
    _facePntIndex[0] = source._facePntIndex[0];
    _facePntIndex[1] = source._facePntIndex[1];
    _facePntIndex[2] = source._facePntIndex[2];
    _facePntIndex[3] = source._facePntIndex[3];
}

FaceIterator::FaceIterator

(

const GeometryPtr &

geo

)

This constructor creates an iterator for the given geometry. It is useful to create an iterator to be used to seek() to a specific indexed face. Otherwise, use Geometry::beginFaces() resp. Geometry::endFaces() to create an iterator.

Definition at line 142 of file OSGFaceIterator.cpp.

References osg::PrimitiveIterator::setGeo().

                                                 : PrimitiveIterator(),
    _faceIndex(0), _actPrimIndex(), _facePntIndex()
{
    setGeo(geo);
}

FaceIterator::FaceIterator

(

const NodePtr &

geo

)

This constructor creates an iterator for the given node. It is useful to create an iterator to be used to seek() to a specific indexed face. Otherwise, use Geometry::beginFaces() resp. Geometry::endFaces() to create an iterator.

Definition at line 131 of file OSGFaceIterator.cpp.

References osg::PrimitiveIterator::setGeo().

                                             : PrimitiveIterator(),
    _faceIndex(0), _actPrimIndex(), _facePntIndex()
{
    setGeo(geo);
}

FaceIterator::~FaceIterator

(

void

)

[virtual]

Definition at line 149 of file OSGFaceIterator.cpp.

{
}

---

Member Function Documentation

static const char* osg::FaceIterator::getClassname

(

void

)

[inline, static]

Reimplemented from osg::PrimitiveIterator.

Definition at line 69 of file OSGFaceIterator.h.

{ return "FaceIterator"; }

Int32 osg::FaceIterator::getIndex

(

void

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 51 of file OSGFaceIterator.inl.

References _faceIndex.

Referenced by seek().

{
    return _faceIndex;
}

UInt32 osg::FaceIterator::getLength

(

void

)

const [inline]

Return the length of the current face. 3 or 4, depending on the current primitive.

Reimplemented from osg::PrimitiveIterator.

Definition at line 62 of file OSGFaceIterator.inl.

References _facePntIndex.

Referenced by osg::calcFaceNormals(), and osg::calcFaceNormalsGeo().

{
    return _facePntIndex[3] == -1 ? 3 : 4;
}

Int32 osg::FaceIterator::getPositionIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 68 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getPositionIndex().

Referenced by osg::calcFaceNormals(), getPosition(), and operator++().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getPositionIndex(_facePntIndex[which]);
    else 
        return -1;
}

Pnt3f osg::FaceIterator::getPosition

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 76 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getPositionIndex(), and osg::PointInterface< ValueTypeT, StorageInterfaceT >::Null.

Referenced by osg::calcFaceNormals(), and osg::calcFaceNormalsGeo().

                                                               { Int32 ind =
getPositionIndex(which);

    if(ind < 0)
        return Pnt3f::Null;
    
    return getGeometry()->getPositions()->getValue(ind);
}

Int32 osg::FaceIterator::getNormalIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 86 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getNormalIndex().

Referenced by getNormal().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getNormalIndex(_facePntIndex[which]);
    else 
        return -1;
}

Vec3f osg::FaceIterator::getNormal

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 95 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getNormalIndex(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

Referenced by osg::calcFaceNormalsGeo().

{   
    Int32 ind = getNormalIndex(which);
    
    if(ind < 0)
        return Vec3f::Null;
        
    return getGeometry()->getNormals()->getValue(ind);
}

Int32 osg::FaceIterator::getColorIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 106 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getColorIndex().

Referenced by getColor().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getColorIndex(_facePntIndex[which]);
    else 
        return -1;
}

Color3f osg::FaceIterator::getColor

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 115 of file OSGFaceIterator.inl.

References getColorIndex(), osg::PrimitiveIterator::getGeometry(), and osg::Color3< ValueTypeT >::Null.

{   
    Int32 ind = getColorIndex(which);
    
    if(ind < 0)
        return Color3f::Null;
        
    return getGeometry()->getColors()->getValue(ind);
}

Int32 osg::FaceIterator::getSecondaryColorIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 126 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getSecondaryColorIndex().

Referenced by getSecondaryColor().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getSecondaryColorIndex(_facePntIndex[which]);
    else 
        return -1;
}

Color3f osg::FaceIterator::getSecondaryColor

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 135 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getSecondaryColorIndex(), and osg::Color3< ValueTypeT >::Null.

{   
    Int32 ind = getSecondaryColorIndex(which);
    
    if(ind < 0)
        return Color3f::Null;
        
    return getGeometry()->getSecondaryColors()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 146 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex().

Referenced by getTexCoords().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 155 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex1

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 167 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex1().

Referenced by getTexCoords1().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex1(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords1

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 176 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex1(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex1(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords1()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex2

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 187 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex2().

Referenced by getTexCoords2().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex2(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords2

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 196 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex2(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex2(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords2()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex3

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 207 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex3().

Referenced by getTexCoords3().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex3(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords3

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 216 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex3(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex3(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords3()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex4

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 227 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex4().

Referenced by getTexCoords4().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex4(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords4

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 236 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex4(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex4(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords4()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex5

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 247 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex5().

Referenced by getTexCoords5().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex5(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords5

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 256 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex5(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex5(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords5()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex6

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 267 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex6().

Referenced by getTexCoords6().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex6(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords6

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 276 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex6(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex6(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords6()->getValue(ind);
}

Int32 osg::FaceIterator::getTexCoordsIndex7

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 287 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getTexCoordsIndex7().

Referenced by getTexCoords7().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getTexCoordsIndex7(_facePntIndex[which]);
    else 
        return -1;
}

Vec2f osg::FaceIterator::getTexCoords7

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 296 of file OSGFaceIterator.inl.

References osg::PrimitiveIterator::getGeometry(), getTexCoordsIndex7(), and osg::VectorInterface< ValueTypeT, StorageInterfaceT >::Null.

{   
    Int32 ind = getTexCoordsIndex7(which);
    
    if(ind < 0)
        return Vec2f::Null;
        
    return getGeometry()->getTexCoords7()->getValue(ind);
}

Int32 osg::FaceIterator::getIndexIndex

(

Int32

which

)

const [inline]

Reimplemented from osg::PrimitiveIterator.

Definition at line 307 of file OSGFaceIterator.inl.

References _facePntIndex, and osg::PrimitiveIterator::getIndexIndex().

Referenced by osg::calcFaceNormals().

{
    if(_facePntIndex[which] >= 0)
        return Inherited::getIndexIndex(_facePntIndex[which]);
    else 
        return -1;
}

void FaceIterator::seek

(

Int32

index

)

Seek the iterator to a specific face indicated by its index.

This is primarily used in conjunction with osg::FaceIterator::getIndex to record a position in the iteration and later return to it.

Reimplemented from osg::PrimitiveIterator.

Definition at line 307 of file OSGFaceIterator.cpp.

References getIndex(), and setToBegin().

{
    setToBegin();
    
    while(getIndex() != index)
        ++(*this);
}

void FaceIterator::operator++

(

void

)

The increment operator steps the iterator to the next face. If it is already beyond the last face it does not change.

Dev: This is the central function of the whole iterator. It changes _facePntIndex to contain the data for the next face, depending on the type of the currently active primitive and steps to the next primitive if the current one is exhausted. The only tricky part is the left/right swap for triangle strips, the rest is pretty simple.

Reimplemented from osg::PrimitiveIterator.

Definition at line 164 of file OSGFaceIterator.cpp.

References _actPrimIndex, _faceIndex, _facePntIndex, osg::PrimitiveIterator::getLength(), getPositionIndex(), osg::PrimitiveIterator::getType(), osg::PrimitiveIterator::isAtEnd(), startPrim(), and SWARNING.

{
    // already at end?
    if(isAtEnd())
        return;
    
    ++_faceIndex;

    // at end of primitive?
    if(_actPrimIndex >= PrimitiveIterator::getLength())
    {
        ++(static_cast<PrimitiveIterator&>(*this));
        
        startPrim();
        
        return;
    }

    switch(getType())
    {
    case GL_TRIANGLES:      _facePntIndex[0] = _actPrimIndex++;
                            _facePntIndex[1] = _actPrimIndex++;
                            _facePntIndex[2] = _actPrimIndex++;
                            _facePntIndex[3] = -1;
                            break;
    case GL_QUAD_STRIP:     _facePntIndex[0] = _facePntIndex[3];
                            _facePntIndex[1] = _facePntIndex[2];
                            _facePntIndex[3] = _actPrimIndex++;
                            _facePntIndex[2] = _actPrimIndex++;
                            break;
    case GL_TRIANGLE_STRIP: if(_actPrimIndex & 1)
                            {
                                _facePntIndex[0] = _facePntIndex[2];
                            }
                            else
                            {
                                _facePntIndex[1] = _facePntIndex[2];
                            }                           
                            _facePntIndex[2] = _actPrimIndex++;
                            
                            if(getPositionIndex(0) == getPositionIndex(1) ||
                               getPositionIndex(0) == getPositionIndex(2) ||
                               getPositionIndex(1) == getPositionIndex(2))
                            {
                                --_faceIndex;
                                ++(*this);
                            }
                               
                            break;
    case GL_POLYGON:
    case GL_TRIANGLE_FAN:   _facePntIndex[1] = _facePntIndex[2];
                            _facePntIndex[2] = _actPrimIndex++;
                            break;
    case GL_QUADS:          _facePntIndex[0] = _actPrimIndex++;
                            _facePntIndex[1] = _actPrimIndex++;
                            _facePntIndex[2] = _actPrimIndex++;
                            _facePntIndex[3] = _actPrimIndex++;
                            break;
    default:                SWARNING << "FaceIterator::++: encountered " 
                                      << "unknown primitive type " 
                                      << getType()
                                      << ", ignoring!" << std::endl;
                            startPrim();
                            break;
    }           
}

FaceIterator & FaceIterator::operator=

(

const FaceIterator &

source

)

Seek the iterator to a specific face indicated by its index.

This is primarily used in conjunction with osg::FaceIterator::getIndex to record a position in the iteration and later return to it.

Definition at line 338 of file OSGFaceIterator.cpp.

References _actPrimIndex, _faceIndex, and _facePntIndex.

{
    if(this == &source)
        return *this;
    
    *static_cast<Inherited *>(this) = source;

    this->_faceIndex            = source._faceIndex;
    this->_actPrimIndex         = source._actPrimIndex;
    this->_facePntIndex[0]      = source._facePntIndex[0];
    this->_facePntIndex[1]      = source._facePntIndex[1];
    this->_facePntIndex[2]      = source._facePntIndex[2];
    this->_facePntIndex[3]      = source._facePntIndex[3];

    return *this;
}

bool FaceIterator::operator<

(

const FaceIterator &

other

)

const

Seek the iterator to a specific face indicated by its index.

This is primarily used in conjunction with osg::FaceIterator::getIndex to record a position in the iteration and later return to it.

Definition at line 357 of file OSGFaceIterator.cpp.

References _actPrimIndex.

{
    return 
          (*static_cast<const Inherited *>(this) <  other) ||
        ( (*static_cast<const Inherited *>(this) == other)             &&
          _actPrimIndex                          <  other._actPrimIndex);
}

bool FaceIterator::operator==

(

const FaceIterator &

other

)

const

Seek the iterator to a specific face indicated by its index.

This is primarily used in conjunction with osg::FaceIterator::getIndex to record a position in the iteration and later return to it.

Definition at line 365 of file OSGFaceIterator.cpp.

References _actPrimIndex, and osg::PrimitiveIterator::isAtEnd().

{
    if(isAtEnd() && other.isAtEnd())
        return true;

    if(isAtEnd() || other.isAtEnd())
        return false;

    return 
        (*static_cast<const Inherited *>(this) == other              ) &&
        _actPrimIndex                          == other._actPrimIndex;
}

bool FaceIterator::operator!=

(

const FaceIterator &

other

)

const

Seek the iterator to a specific face indicated by its index.

This is primarily used in conjunction with osg::FaceIterator::getIndex to record a position in the iteration and later return to it.

Definition at line 378 of file OSGFaceIterator.cpp.

{
    return !(*this == other);
}

void FaceIterator::setToBegin

(

void

)

Set the iterator to the beginning of the geometry. Is primarily used by osg::Geometry::beginFaces, but can also be used to quickly recycle an iterator.

Reimplemented from osg::PrimitiveIterator.

Definition at line 319 of file OSGFaceIterator.cpp.

References _faceIndex, osg::PrimitiveIterator::setToBegin(), and startPrim().

Referenced by osg::Geometry::beginFaces(), and seek().

{
    PrimitiveIterator::setToBegin();
    _faceIndex = 0;
    startPrim();
}

void FaceIterator::setToEnd

(

void

)

Set the iterator to the end of the geometry. Is primarily used by osg::Geometry::endFaces, but can also be used to quickly recycle an iterator.

Reimplemented from osg::PrimitiveIterator.

Definition at line 330 of file OSGFaceIterator.cpp.

References _actPrimIndex, and osg::PrimitiveIterator::setToEnd().

Referenced by osg::Geometry::endFaces().

{
    PrimitiveIterator::setToEnd();
    _actPrimIndex = 0;
}

void FaceIterator::startPrim

(

void

)

[private]

Helper function to reset all state to the beginning of a new primitive. Also skips non-polygonal primitives(lines, points) and primtiives with less than 3 points.

Definition at line 236 of file OSGFaceIterator.cpp.

References _actPrimIndex, _facePntIndex, osg::PrimitiveIterator::getLength(), osg::PrimitiveIterator::getType(), osg::PrimitiveIterator::isAtEnd(), and SWARNING.

Referenced by operator++(), and setToBegin().

{
    // already at end?
    if(isAtEnd())
        return;

    _facePntIndex[0] = 0;
    _facePntIndex[1] = 1;
    _facePntIndex[2] = 2;
    _facePntIndex[3] = -1;
    _actPrimIndex = 3;
    
    // loop until you find a useful primitive or run out
    while(! isAtEnd())
    {
        switch(getType())
        {
        case GL_POINTS:     // non-polygon types: ignored
        case GL_LINES:
        case GL_LINE_STRIP: 
        case GL_LINE_LOOP:  
                            break;
        case GL_TRIANGLES: 
        case GL_TRIANGLE_STRIP:
        case GL_TRIANGLE_FAN:   
                                if(PrimitiveIterator::getLength() >= 3)
                                    return;
                                break;
        case GL_POLYGON:        switch(PrimitiveIterator::getLength())
                                {
                                case 0: 
                                case 1: 
                                case 2: 
                                            break;
                                case 4:
                                            _facePntIndex[3] = _actPrimIndex++;     
                                            return;
                                default:
                                            return;
                                }
                                break;
        case GL_QUADS:          if(PrimitiveIterator::getLength() >= 4)
                                {
                                    _facePntIndex[3] = _actPrimIndex++;                         
                                    return;
                                }
                                break;
        case GL_QUAD_STRIP:         if(PrimitiveIterator::getLength() >= 4)
                                {
                                    _facePntIndex[3] = _facePntIndex[2];                        
                                    _facePntIndex[2] = _actPrimIndex++;                         
                                    return;
                                }
                                break;
        default:            SWARNING << "FaceIterator::startPrim: encountered " 
                                     << "unknown primitive type " 
                                     << getType()
                                     << ", ignoring!" << std::endl;
                            break;
        }   
        
        ++(static_cast<PrimitiveIterator&>(*this));   
    }       
}

void PrimitiveIterator::setGeo

(

const GeometryPtr &

geo

)

[inherited]

Switch the iterator to a new geometry. Automatically sets it to the beginning.

Definition at line 339 of file OSGPrimitiveIterator.cpp.

References osg::PrimitiveIterator::_geo, osg::PrimitiveIterator::_indices, osg::PrimitiveIterator::_lengths, osg::PrimitiveIterator::_types, osg::NullFC, OSG_ASSERT, and osg::PrimitiveIterator::setToBegin().

Referenced by osg::EdgeIterator::EdgeIterator(), FaceIterator(), osg::LineIterator::LineIterator(), osg::PrimitiveIterator::PrimitiveIterator(), osg::PrimitiveIterator::setGeo(), and osg::TriangleIterator::TriangleIterator().

{
    OSG_ASSERT(geo != NullFC);

    _geo     = geo;
    _types   = geo->getTypes();
    _lengths = geo->getLengths();
    _indices = geo->getIndices();
    
    setToBegin();
}

void PrimitiveIterator::setGeo

(

const NodePtr &

geo

)

[inherited]

Switch the iterator to a new geometry. Automatically sets it to the beginning.

Definition at line 355 of file OSGPrimitiveIterator.cpp.

References osg::AttachmentContainerPtr::dcast(), FWARNING, osg::NodePtr::getCore(), osg::NullFC, and osg::PrimitiveIterator::setGeo().

{
    GeometryPtr gc = GeometryPtr::dcast(geo->getCore());
    
    if(gc == NullFC)
    {
        FWARNING(("PrimitiveIterator::setGeo: called for NodePtr which "
                  "is not a Geometry!\n"));
    }
    else
    {
        setGeo(gc);
    }
}

bool osg::PrimitiveIterator::isAtEnd

(

void

)

const [inline, inherited]

Check if the iterator has already reached the end of the geometry.

Definition at line 55 of file OSGPrimitiveIterator.inl.

References osg::PrimitiveIterator::_ended.

Referenced by osg::TriangleIterator::operator++(), osg::PrimitiveIterator::operator++(), osg::LineIterator::operator++(), operator++(), osg::EdgeIterator::operator++(), osg::TriangleIterator::operator==(), osg::LineIterator::operator==(), operator==(), osg::EdgeIterator::operator==(), osg::SplitGraphOp::splitNode(), osg::TriangleIterator::startPrim(), osg::LineIterator::startPrim(), startPrim(), and osg::EdgeIterator::startPrim().

{
    return _ended;
}

UInt32 osg::PrimitiveIterator::getType

(

void

)

const [inline, inherited]

Return the type of the current primitive.

Definition at line 81 of file OSGPrimitiveIterator.inl.

References osg::PrimitiveIterator::_actPrimType.

Referenced by osg::calcFaceNormals(), osg::calcFaceNormalsGeo(), osg::createConvexPrimitives(), osg::EdgeIterator::getColorIndex(), osg::EdgeIterator::getIndexIndex(), osg::EdgeIterator::getLength(), osg::EdgeIterator::getNormalIndex(), osg::EdgeIterator::getPositionIndex(), osg::EdgeIterator::getSecondaryColorIndex(), osg::EdgeIterator::getTexCoordsIndex(), osg::EdgeIterator::getTexCoordsIndex1(), osg::EdgeIterator::getTexCoordsIndex2(), osg::EdgeIterator::getTexCoordsIndex3(), osg::EdgeIterator::getTexCoordsIndex4(), osg::EdgeIterator::getTexCoordsIndex5(), osg::EdgeIterator::getTexCoordsIndex6(), osg::EdgeIterator::getTexCoordsIndex7(), osg::TriangleIterator::operator++(), osg::LineIterator::operator++(), operator++(), osg::EdgeIterator::operator++(), osg::SplitGraphOp::splitNode(), osg::TriangleIterator::startPrim(), osg::LineIterator::startPrim(), startPrim(), osg::EdgeIterator::startPrim(), osg::VRMLWriteAction::writeGeoEnter(), and osg::VRMLWriteAction::writeLineIndex().

{
    return _actPrimType;
}

GeometryPtr osg::PrimitiveIterator::getGeometry

(

void

)

const [inline, inherited]

Return the geometry the iterator is currently attached to.

Definition at line 676 of file OSGPrimitiveIterator.inl.

References osg::PrimitiveIterator::_geo.

Referenced by osg::TriangleIterator::getColor(), osg::LineIterator::getColor(), getColor(), osg::EdgeIterator::getColor(), osg::TriangleIterator::getNormal(), osg::LineIterator::getNormal(), getNormal(), osg::EdgeIterator::getNormal(), osg::TriangleIterator::getPosition(), osg::LineIterator::getPosition(), getPosition(), osg::EdgeIterator::getPosition(), osg::TriangleIterator::getSecondaryColor(), osg::LineIterator::getSecondaryColor(), getSecondaryColor(), osg::EdgeIterator::getSecondaryColor(), osg::TriangleIterator::getTexCoords(), osg::LineIterator::getTexCoords(), getTexCoords(), osg::EdgeIterator::getTexCoords(), osg::TriangleIterator::getTexCoords1(), osg::LineIterator::getTexCoords1(), getTexCoords1(), osg::EdgeIterator::getTexCoords1(), osg::TriangleIterator::getTexCoords2(), osg::LineIterator::getTexCoords2(), getTexCoords2(), osg::EdgeIterator::getTexCoords2(), osg::TriangleIterator::getTexCoords3(), osg::LineIterator::getTexCoords3(), getTexCoords3(), osg::EdgeIterator::getTexCoords3(), osg::TriangleIterator::getTexCoords4(), osg::LineIterator::getTexCoords4(), getTexCoords4(), osg::EdgeIterator::getTexCoords4(), osg::TriangleIterator::getTexCoords5(), osg::LineIterator::getTexCoords5(), getTexCoords5(), osg::EdgeIterator::getTexCoords5(), osg::TriangleIterator::getTexCoords6(), osg::LineIterator::getTexCoords6(), getTexCoords6(), osg::EdgeIterator::getTexCoords6(), osg::TriangleIterator::getTexCoords7(), osg::LineIterator::getTexCoords7(), getTexCoords7(), and osg::EdgeIterator::getTexCoords7().

{
    return _geo;
}

bool PrimitiveIterator::operator<

(

const PrimitiveIterator &

other

)

const [inherited]

Compare two iterators. If the iterators are attached to different geometries a comparison in senseless, in that case false will be returned.

Definition at line 539 of file OSGPrimitiveIterator.cpp.

References osg::PrimitiveIterator::_geo, and osg::PrimitiveIterator::_primIndex.

{
    return _geo       == other._geo &&
           _primIndex <= other._primIndex;
}

bool PrimitiveIterator::operator==

(

const PrimitiveIterator &

other

)

const [inherited]

Compare two iterators. If the iterators are attached to different geometries a comparison in senseless, in that case false will be returned.

Definition at line 548 of file OSGPrimitiveIterator.cpp.

References osg::PrimitiveIterator::_ended, osg::PrimitiveIterator::_geo, and osg::PrimitiveIterator::_primIndex.

{
    return _ended     == other._ended &&
           _geo       == other._geo &&
           _primIndex == other._primIndex;
}

bool PrimitiveIterator::operator!=

(

const PrimitiveIterator &

other

)

const [inherited]

Compare two iterators. If the iterators are attached to different geometries a comparison in senseless, in that case false will be returned.

Definition at line 558 of file OSGPrimitiveIterator.cpp.

{
    return !(*this == other);
}

---

Member Data Documentation

char FaceIterator::cvsid = "@(#)$Id: OSGFaceIterator.cpp,v 1.13 2001/11/01 09:03:28 vossg Exp $" [static, private]

Reimplemented from osg::PrimitiveIterator.

Definition at line 156 of file OSGFaceIterator.h.

osg::FaceIterator::_faceIndex [private]

Simple runing face count. Returned by getIndex() and can be used as the input to seek();

Definition at line 158 of file OSGFaceIterator.h.

Referenced by getIndex(), operator++(), operator=(), and setToBegin().

osg::FaceIterator::_actPrimIndex [private]

The next unused point in the current primitive. Starts at 0 and indicates that the primitive is exhausted when it goes over the length of the primitive.

Definition at line 159 of file OSGFaceIterator.h.

Referenced by operator++(), operator<(), operator=(), operator==(), setToEnd(), and startPrim().

osg::FaceIterator::_facePntIndex [private]

Keeps the indices of the currently active face vertices. If the face is a tri the fourth index is -1.

This variable is accessed via the getIndexIndex() method.

Definition at line 160 of file OSGFaceIterator.h.

Referenced by FaceIterator(), getColorIndex(), getIndexIndex(), getLength(), getNormalIndex(), getPositionIndex(), getSecondaryColorIndex(), getTexCoordsIndex(), getTexCoordsIndex1(), getTexCoordsIndex2(), getTexCoordsIndex3(), getTexCoordsIndex4(), getTexCoordsIndex5(), getTexCoordsIndex6(), getTexCoordsIndex7(), operator++(), operator=(), and startPrim().

---

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

• OSGFaceIterator.h
• OSGFaceIterator.cpp
• OSGFaceIterator.inl