NAME
SoPrimitiveVertex -
The SoPrimitiveVertex class represents a single vertex of a generated
primitive.
Instances of SoPrimitiveVertex are constructed when generating
primitive data, primarily during an SoCallbackAction traversal.
Depending on the context the vertex could represent a single 3D point,
one of the two vertices in a line or one of the three vertices in a
triangle.
SYNOPSIS
#include <Inventor/SoPrimitiveVertex.h>
Public Member Functions
SoPrimitiveVertex (void)
SoPrimitiveVertex (const SoPrimitiveVertex &pv)
~SoPrimitiveVertex (void)
SoPrimitiveVertex & operator= (const SoPrimitiveVertex &pv)
const SbVec3f & getPoint (void) const
const SbVec3f & getNormal (void) const
const SbVec4f & getTextureCoords (void) const
int getMaterialIndex (void) const
uint32_t getPackedColor (void) const
const SoDetail * getDetail (void) const
void setPoint (const SbVec3f &pt)
void setPoint (float x, float y, float z)
void setNormal (const SbVec3f &n)
void setNormal (float nx, float ny, float nz)
void setTextureCoords (const SbVec2f &tex)
void setTextureCoords (float tx, float ty)
void setTextureCoords (const SbVec3f &tex)
void setTextureCoords (float tx, float ty, float tz)
void setTextureCoords (const SbVec4f &tex)
void setTextureCoords (float tx, float ty, float tz, float tw)
void setMaterialIndex (int index)
void setPackedColor (uint32_t rgba)
void setDetail (SoDetail *d)
Detailed Description
The SoPrimitiveVertex class represents a single vertex of a generated
primitive.
Instances of SoPrimitiveVertex are constructed when generating
primitive data, primarily during an SoCallbackAction traversal.
Depending on the context the vertex could represent a single 3D point,
one of the two vertices in a line or one of the three vertices in a
triangle.
Constructor & Destructor Documentation
SoPrimitiveVertex::SoPrimitiveVertex (void) Default constructor, sets up a
’void’ instance.
SoPrimitiveVertex::SoPrimitiveVertex (const SoPrimitiveVertex & pv) Copy
constructor. Does a shallow copy.
See also:
SoPrimitiveVertex::operator=()
SoPrimitiveVertex::~SoPrimitiveVertex (void) Destructor. The detail
instance is owned by client code and will not be destructed here.
Member Function Documentation
SoPrimitiveVertex & SoPrimitiveVertex::operator= (const SoPrimitiveVertex &
pv) Copy operator.
When pv is copied into this instance, a shallow copy is made. Ie, only
the reference to the detail instance is copied (if any), not the detail
itself.
const SbVec3f & SoPrimitiveVertex::getPoint (void) const [inline] Returns
vertex coordinates, positioned in object space.
const SbVec3f & SoPrimitiveVertex::getNormal (void) const [inline] Returns
normal vector, oriented in object space.
const SbVec4f & SoPrimitiveVertex::getTextureCoords (void) const [inline]
Returns texture coordinates for vertex, specified in object space.
int SoPrimitiveVertex::getMaterialIndex (void) const [inline] Returns index
of the vertex into the currently active material, if any.
uint32_t SoPrimitiveVertex::getPackedColor (void) const [inline] Returns
the rgba packed color for the given vertex.
Since:
Coin 3.0
const SoDetail * SoPrimitiveVertex::getDetail (void) const [inline] Returns
pointer to detail instance with more information about the vertex. A
detail instance may not be available, and if so NULL is returned.
void SoPrimitiveVertex::setPoint (const SbVec3f & pt) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
void SoPrimitiveVertex::setPoint (float x, float y, float z) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
void SoPrimitiveVertex::setNormal (const SbVec3f & n) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
void SoPrimitiveVertex::setNormal (float nx, float ny, float nz) [inline]
Used internally from library client code setting up an
SoPrimitiveVertex instance.
void SoPrimitiveVertex::setTextureCoords (const SbVec2f & texcoords)
[inline] Used internally from library client code setting up an
SoPrimitiveVertex instance.
Covenience function. Will fill in 0 and 1 in the last two texture
coords in the internal SbVec4f texture coordinate instance.
void SoPrimitiveVertex::setTextureCoords (float tx, float ty) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
Covenience function. Will fill in 0 and 1 in the last two texture
coords in the internal SbVec4f texture coordinate instance.
void SoPrimitiveVertex::setTextureCoords (const SbVec3f & texcoords)
[inline] Covenience function. Will fill in 1 in the last coord.
This function is an extension for Coin, and it is not available in the
original SGI Open Inventor v2.1 API.
Since:
Coin 2.0
void SoPrimitiveVertex::setTextureCoords (float tx, float ty, float tz)
[inline] Covenience function. Will fill in 1 in the last coord.
This function is an extension for Coin, and it is not available in the
original SGI Open Inventor v2.1 API.
Since:
Coin 2.5
void SoPrimitiveVertex::setTextureCoords (const SbVec4f & texcoords)
[inline] Used internally from library client code setting up an
SoPrimitiveVertex instance.
void SoPrimitiveVertex::setMaterialIndex (int index) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
void SoPrimitiveVertex::setPackedColor (uint32_t rgba) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
void SoPrimitiveVertex::setDetail (SoDetail * detail) [inline] Used
internally from library client code setting up an SoPrimitiveVertex
instance.
Note that it’s the client’s responsibility to do the deallocation of
the detail instance after the SoPrimitiveVertex instance has gone out
of scope.
Author
Generated automatically by Doxygen for Coin from the source code.