sonormalbundle(3) [debian man page]
SoNormalBundle(3) Coin SoNormalBundle(3) NAME
SoNormalBundle - The SoNormalBundle class simplifies normal handling. This class is currently not used in Coin but is provided for API compatibility. SYNOPSIS
Inherits SoBundle. Public Member Functions SoNormalBundle (SoAction *action, SbBool forrendering) ~SoNormalBundle () SbBool shouldGenerate (int numneeded) void initGenerator (int initnum=100) void beginPolygon (void) void polygonVertex (const SbVec3f &v) void endPolygon (void) void triangle (const SbVec3f &p1, const SbVec3f &p2, const SbVec3f &p3) void generate (int startindex=0, SbBool addtostate=TRUE) const SbVec3f * getGeneratedNormals (void) const int getNumGeneratedNormals (void) const void set (int32_t num, const SbVec3f *normals) const SbVec3f & get (int index) const void send (int index) const Public Attributes SoNormalGenerator * generator Additional Inherited Members Detailed Description The SoNormalBundle class simplifies normal handling. This class is currently not used in Coin but is provided for API compatibility. Constructor &; Destructor Documentation SoNormalBundle::SoNormalBundle (SoAction *action, SbBoolforrendering) Constructor. SoNormalBundle::~SoNormalBundle () Destructor. Member Function Documentation SbBool SoNormalBundle::shouldGenerate (intnumneeded) Returns FALSE if there are normals on the state. Otherwise initGenerator() is called with numneeded as argument, and TRUE is returned. void SoNormalBundle::initGenerator (intinitnum = 100) Initializes the normal generator. initnum is a hint that should contain the approximate number of normals to be generated. void SoNormalBundle::beginPolygon (void) Start polygon specification. Call polygonVertex() for each vertex in the polygon, and then endPolygon() to close the polygon. See also: polygonVertex(), endPolygon() void SoNormalBundle::polygonVertex (const SbVec3f &v) Call for each vertex in a polygon. See also: beginPolygon(), endPolygon() void SoNormalBundle::endPolygon (void) Call to close a polygon. See also: beginPolygon(), polygonVertex() void SoNormalBundle::triangle (const SbVec3f &p1, const SbVec3f &p2, const SbVec3f &p3) Convenience method to specify a triangle. p1, p2, and p3 are the triangles vertices. void SoNormalBundle::generate (intstartindex = 0, SbBooladdtostate = TRUE) Generate normals for the shape. startindex should always be 0 (the SoNonIndexedShape::startIndex field is obsoleted). addtostate should be true if the generated normals should be pushed onto the current state. const SbVec3f * SoNormalBundle::getGeneratedNormals (void) const Returns the number of generated normals. int SoNormalBundle::getNumGeneratedNormals (void) const Returns a pointer to the generated normals. void SoNormalBundle::set (int32_tnum, const SbVec3f *normals) Can be used by nodes that generate their own normals. The state will be updated with the new normals, and the state will be popped again when the SoNormalBundle destructor is called. const SbVec3f & SoNormalBundle::get (intindex) const Returns the index'th normal from the state. void SoNormalBundle::send (intindex) const Send the index'th normal to OpenGL. Author Generated automatically by Doxygen for Coin from the source code. Version 3.1.3 Wed May 23 2012 SoNormalBundle(3)
Check Out this Related Man Page
SoNormalCache(3) Coin SoNormalCache(3) NAME
SoNormalCache - The SoNormalCache class is used to hold cached normals. As an extension to the original SGI Open Inventor v2.1 API, it is also possible to generate normals using this class. SYNOPSIS
#include <Inventor/caches/SoNormalCache.h> Inherits SoCache. Public Member Functions SoNormalCache (SoState *const state) virtual ~SoNormalCache () void set (const int num, const SbVec3f *const normals) void set (SoNormalGenerator *generator) int getNum (void) const const SbVec3f * getNormals (void) const int getNumIndices (void) const const int32_t * getIndices (void) const void generatePerVertex (const SbVec3f *const coords, const unsigned int numcoords, const int32_t *coordindices, const int numcoordindices, const float crease_angle, const SbVec3f *facenormals=NULL, const int numfacenormals=-1, const SbBool ccw=TRUE, const SbBool tristrip=FALSE) void generatePerFace (const SbVec3f *const coords, const unsigned int numcoords, const int32_t *coordindices, const int numcoorindices, const SbBool ccw) void generatePerFaceStrip (const SbVec3f *const coords, const unsigned int numcoords, const int32_t *coordindices, const int numcoorindices, const SbBool ccw) void generatePerStrip (const SbVec3f *const coords, const unsigned int numcoords, const int32_t *coordindices, const int numcoorindices, const SbBool ccw) void generatePerVertexQuad (const SbVec3f *const coords, const unsigned int numcoords, const int vPerRow, const int vPerColumn, const SbBool ccw) void generatePerFaceQuad (const SbVec3f *const coords, const unsigned int numcoords, const int vPerRow, const int vPerColumn, const SbBool ccw) void generatePerRowQuad (const SbVec3f *const coords, const unsigned int numcoords, const int vPerRow, const int vPerColumn, const SbBool ccw) Additional Inherited Members Detailed Description The SoNormalCache class is used to hold cached normals. As an extension to the original SGI Open Inventor v2.1 API, it is also possible to generate normals using this class. It is more powerful and easier to use than the SoNormalGenerator class. It is possible to generate normals per vertex with indices (using much less memory than plain per vertex normals), and it contains special methods to generate normals for triangle strips and quads. Constructor &; Destructor Documentation SoNormalCache::SoNormalCache (SoState *conststate) Contructor with state being the current state. SoNormalCache::~SoNormalCache () [virtual] Destructor Member Function Documentation void SoNormalCache::set (const intnum, const SbVec3f *constnormals) Sets an array of normals for this cache. The normals will not be deleted when the instance is deleted. void SoNormalCache::set (SoNormalGenerator *generator) Uses a normal generator in this cache. The normal generator will be deleted when the cache is deleted or reset. int SoNormalCache::getNum (void) const Returns the number of normals in the cache. const SbVec3f * SoNormalCache::getNormals (void) const Return a pointer to the normals in this cache. int SoNormalCache::getNumIndices (void) const Returns the number of indices in this cache. Normals are generated with PER_VERTEX_INDEXED binding. const int32_t * SoNormalCache::getIndices (void) const Returns the normal indices. void SoNormalCache::generatePerVertex (const SbVec3f *constcoords, const unsigned intnumcoords, const int32_t *vindex, const intnumvi, const floatcrease_angle, const SbVec3f *facenormals = NULL, const intnumfacenormals = -1, const SbBoolccw = TRUE, const SbBooltristrip = FALSE) Generates normals for each vertex for each face. It is possible to specify face normals if these have been calculated somewhere else, otherwise the face normals will be calculated before the vertex normals are calculated. tristrip should be TRUE if the geometry consists of triangle strips. void SoNormalCache::generatePerFace (const SbVec3f *constcoords, const unsigned intnumcoords, const int32_t *cind, const intnv, const SbBoolccw) Generates face normals for the faceset defined by coords and cind. void SoNormalCache::generatePerFaceStrip (const SbVec3f *constcoords, const unsigned intnumcoords, const int32_t *cind, const intnv, const SbBoolccw) Generates face normals for triangle strips. void SoNormalCache::generatePerStrip (const SbVec3f *constcoords, const unsigned intnumcoords, const int32_t *cind, const intnv, const SbBoolccw) Generates one normal per triangle strips (avarages all triangle normals). void SoNormalCache::generatePerVertexQuad (const SbVec3f *constcoords, const unsigned intnumcoords, const intvPerRow, const intvPerColumn, const SbBoolccw) Generates PER_VERTEX normals for quad data. void SoNormalCache::generatePerFaceQuad (const SbVec3f *constcoords, const unsigned intnumcoords, const intvPerRow, const intvPerColumn, const SbBoolccw) Generates per face normals for quad data. void SoNormalCache::generatePerRowQuad (const SbVec3f *constcoords, const unsigned intnumcoords, const intvPerRow, const intvPerColumn, const SbBoolccw) Generates per row normals for quad data. Author Generated automatically by Doxygen for Coin from the source code. Version 3.1.3 Wed May 23 2012 SoNormalCache(3)