man SoMaterialBinding () - node that specifies how multiple materials are bound to shapes

NAME

SoMaterialBinding - node that specifies how multiple materials are bound to shapes

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoMaterialBinding

SYNOPSIS

#include <Inventor/nodes/SoMaterialBinding.h> enum Binding { c } c } Whole object has same material

c } c } One material for each part of object

c } c } One material for each part, indexed

c } c } One material for each face of object

c } c } One material for each face, indexed

c } c } One material for each vertex of object

c } c } One material for each vertex, indexed

} Fields from class SoMaterialBinding: c } c } value Methods from class SoMaterialBinding: c } c } SoMaterialBinding()

c } c } getClassTypeId() Methods from class SoNode: c } c } setOverride(SbBool state)

c } c } isOverride() const

c } c } copy(SbBool copyConnections = FALSE) const

c } c } affectsState() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoNodeList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

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.

FIELDS

c } c } value

Specifies how to bind materials to shapes.

METHODS

c } c } SoMaterialBinding()

Creates a material binding node with default settings. c } c } getClassTypeId()

Returns type identifier for this class.

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction

Sets the current material binding type.

FILE FORMAT/DEFAULTS

MaterialBinding {
value	OVERALL
}

SEE ALSO

SoMaterial, SoNormalBinding, SoShape, SoTextureCoordinateBinding