SoMaterialBundle(3)

NAME
SoMaterialBundle - The SoMaterialBundle class simplifies material handling.

SYNOPSIS

#include <Inventor/bundles/SoMaterialBundle.h>

Inherits SoBundle.

  Public Member Functions
SoMaterialBundle (SoAction *action)
~SoMaterialBundle ()
void setUpMultiple (void)
void sendFirst (void)
void forceSend (const int index)
SbBool isColorOnly (void) const
void send (const int index, const SbBool betweenbeginend)

  Additional Inherited Members
Protected Member Functions inherited from SoBundle
SoBundle (SoAction *action)
~SoBundle ()
Protected Attributes inherited from SoBundle
SoState * state
The state of the current action.

Detailed Description

The SoMaterialBundle class simplifies material handling. Every shape node should create (on the stack) an instance of this class and call sendFirst() before sending anything to GL. During rendering, send() should be used to send material values to GL.

Constructor & Destructor Documentation

  SoMaterialBundle::SoMaterialBundle (SoAction * action)
Constructor with action being the action applied to the geometry node.

  SoMaterialBundle::~SoMaterialBundle ()
Destructor

Member Function Documentation

  void SoMaterialBundle::setUpMultiple (void )
Currently not in use. It is only provided for OIV compliance.

  void SoMaterialBundle::sendFirst (void )
Sends the initial material values to GL. Must be done once in all geometry nodes before the rendering begins.

  void SoMaterialBundle::forceSend (const int index)
Will send the material to GL even though index equals the current index.

Provided for compatibility with the SGI Open Inventor v2.1 API.

  SbBool SoMaterialBundle::isColorOnly (void ) const
Returns TRUE if the current light model is BASE_COLOR.

  void SoMaterialBundle::send (const int index, const SbBool betweenbeginend)
Sends material values with index index to GL. Will test whether the current index equals index before sending.

betweenbeginend should be TRUE if your program is between a glBegin() and glEnd() (it is illegal to change the polygon stipple between a glBegin() and glEnd()).

Author

Generated automatically by Doxygen for Coin from the source code.