Rechercher une page de manuel

SoMaterial.3coin2

Langue: en

Version: 379197 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME
SYNOPSIS
Detailed Description
Constructor & Destructor Documentation
- SoMaterial::SoMaterial (void)Constructor.
- SoMaterial::~SoMaterial () [protected, virtual]Destructor.
Member Function Documentation
Member Data Documentation
Author

NAME

SoMaterial -

The SoMaterial class is a node type for setting up material values for scene geometry.

After traversing an SoMaterial node, subsequent shape nodes with geometry in the scene graph will use values from the material 'pool' of the traversal state set up from nodes of this type.

SYNOPSIS

#include <Inventor/nodes/SoMaterial.h>

Inherits SoNode.

Public Member Functions

SoMaterial (void)

virtual void doAction (SoAction *action)

virtual void GLRender (SoGLRenderAction *action)

virtual void callback (SoCallbackAction *action)

Static Public Member Functions

static void initClass (void)

Public Attributes

SoMFColor ambientColor

SoMFColor diffuseColor

SoMFColor specularColor

SoMFColor emissiveColor

SoMFFloat shininess

SoMFFloat transparency

Protected Member Functions

virtual ~SoMaterial ()

virtual void notify (SoNotList *list)

Detailed Description

The SoMaterial class is a node type for setting up material values for scene geometry.

After traversing an SoMaterial node, subsequent shape nodes with geometry in the scene graph will use values from the material 'pool' of the traversal state set up from nodes of this type.

For detailed information on the various components, see the OpenGL color model, presented in the chapter 'Colors and Coloring' (chapter 2.13 in the OpenGL 1.4 specification).

Note that values from a material node will replace the previous values from the traversal state, they will not accumulate. That's the case even when e.g. material changes are implicit in an iv-file, as illustrated by the following example:

 
   #Inventor V2.1 ascii
   
   Material { ambientColor 1 0 0 }
   Cone { }
   
   Translation { translation 5 0 0 }
   
   Material { }
   Sphere { }
   .fi
 
 
 (The SoSphere will not 'inherit' the SoMaterial::ambientColor from the first SoMaterial node, even though it is not explicitly set in the second material node. The default value of SoMaterial::ambientColor will be used.)
 
 Note that nodes imported as part of a VRML V1.0 file has a special case, where the fields SoMaterial::ambientColor, SoMaterial::diffuseColor and SoMaterial::specularColor contains zero values, and SoMaterial::emissiveColor contains one or more values. The values in SoMaterial::emissiveColor should then be treated as precalculated lighting, and the other fields should be ignored.
 
 You can detect this case by checking the values of the material elements when the scene graph is traversed using an SoCallbackAction. SoDiffuseColorElement, SoAmbientColorElement, and SoSpecularColorElement will contain one value with a completely black color (0.0f, 0.0f, 0.0f), SoShininessElement will contain one value of 0.0f, and SoEmissiveColorElement will contain one or more values. It is done like this to make rendering work correctly on systems that do not test for this specific case.
 
 You should only check for this case when you're traversing a VRML V1.0 file scene graph, of course. See SoNode::getNodeType() for information about how nodes can be tested for whether or not they have been imported or otherwise set up as of VRML1 type versus Inventor type.
 
 When the scene graph is rendered using an SoGLRenderAction, the elements will be set differently to optimize rendering. The SoDiffuseColorElement will be set to the values in SoMaterial::emissiveColor, and the light model will be set to SoLightModel::BASE_COLOR.
 
 The SoMaterial::transparency values will always be treated normally.
 
 Here is a very simple usage example:
 
 
 
   #Inventor V2.1 ascii
   
   Separator {
      Coordinate3 {
         point [ 0 0 0, 1 0 0, 1 1 0 ]
      }
   
      Material {
         diffuseColor [ 1 0 0, 1 1 0, 0 0 1 ]
      }
   
      MaterialBinding {
         value PER_VERTEX
      }
   
      IndexedFaceSet {
         coordIndex [ 0, 1, 2, -1 ]
      }
   }
   .fi
 
 
 FILE FORMAT/DEFAULTS: 
 
     Material {
         ambientColor 0.2 0.2 0.2
         diffuseColor 0.8 0.8 0.8
         specularColor 0 0 0
         emissiveColor 0 0 0
         shininess 0.2
         transparency 0
     }

See also:

SoMaterialBinding, SoBaseColor, SoPackedColor

Constructor & Destructor Documentation

SoMaterial::SoMaterial (void)Constructor.

References ambientColor, diffuseColor, emissiveColor, shininess, specularColor, and transparency.