SoMaterialBinding Class Reference
[Properties]

Node that specifies how multiple materials are bound to shapes. More...

#include <Inventor/nodes/SoMaterialBinding.h>

Inheritance diagram for SoMaterialBinding:

List of all members.

Public Types
enum	Binding {   OVERALL = SoMaterialBindingElement::OVERALL,   PER_PART = SoMaterialBindingElement::PER_PART,   PER_PART_INDEXED = SoMaterialBindingElement::PER_PART_INDEXED,   PER_FACE = SoMaterialBindingElement::PER_FACE,   PER_FACE_INDEXED = SoMaterialBindingElement::PER_FACE_INDEXED,   PER_VERTEX = SoMaterialBindingElement::PER_VERTEX,   PER_VERTEX_INDEXED = SoMaterialBindingElement::PER_VERTEX_INDEXED,   DEFAULT = OVERALL,   NONE = OVERALL }
Public Member Functions
virtual SoType	getTypeId () const
	SoMaterialBinding ()
virtual void	setOverride (const SbBool state)
virtual SbBool	isOverride () const
Static Public Member Functions
static SoType	getClassTypeId ()
Public Attributes
SoSFEnum	value

---

Detailed Description

Node that specifies how multiple materials are bound to shapes.

This node specifies how the current materials are bound to shapes that follow in the scene graph. Each shape node may interpret bindings differently. The current material always has a base value, which is defined by the first value of all material fields. Since material fields may have multiple values, the binding determines how these values are distributed over a shape.

The bindings for faces and vertices are meaningful only for shapes that are made from faces and vertices. Similarly, the indexed bindings are only used by the shapes that allow indexing.

The bindings apply only to diffuse colors and transparency. Other materials (emissive, specular, ambient, shininess) will have the first value applied to the entire shape, regardless of the material binding or the number provided.

If the number of transparencies is less than the number of diffuse colors, only the first transparency value will be used, regardless of the material binding. If the number of diffuse colors in the state is less than the number required for the given binding, a debug warning will be printed and unpredictable colors will result.

FILE FORMAT/DEFAULT

MaterialBinding {

value

OVERALL

}

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction
Sets the current material binding type. Sets: SoMaterialBindingElement

SEE ALSO

SoMaterial, SoNormalBinding, SoShape, SoVertexProperty, SoTextureCoordinateBinding

---

Member Enumeration Documentation

enum SoMaterialBinding::Binding

Enumerator:

OVERALL	Whole object has same material.
PER_PART	One material for each part of object.
PER_PART_INDEXED	One material for each part, indexed.
PER_FACE	One material for each face of object.
PER_FACE_INDEXED	One material for each face, indexed.
PER_VERTEX	One material for each vertex of object.
PER_VERTEX_INDEXED	One material for each vertex, indexed.
DEFAULT
NONE

---

Constructor & Destructor Documentation

SoMaterialBinding::SoMaterialBinding

(

)

Creates a material binding node with default settings.

---

Member Function Documentation

static SoType SoMaterialBinding::getClassTypeId

(

)

[static]

Returns the type identifier for this class.

Reimplemented from SoNode.

virtual SoType SoMaterialBinding::getTypeId

(

)

const [virtual]

Returns the type identifier for this specific instance.

Reimplemented from SoNode.

virtual SbBool SoMaterialBinding::isOverride

(

)

const [inline, virtual]

Returns the state of the override field.

Reimplemented from SoNode.

virtual void SoMaterialBinding::setOverride

(

const SbBool

state

)

[inline, virtual]

Set the state of the override field.

see SoNode::setOverride doc.

Reimplemented from SoNode.

---

Member Data Documentation

SoSFEnum SoMaterialBinding::value

Specifies how to bind materials to shapes.

Use enum Binding. Default is OVERALL.

---

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

• Inventor/nodes/SoMaterialBinding.h