SoMaterialBinding

InventorModule

genre	InventorNodesAutomatic
author	Silicon Graphics Inc
package	MeVisLab/Standard
definition	inventor.def

Purpose

The node SoMaterialBinding 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, defined by the first value of all material fields. Since material fields may contain multiple values, the binding determines how these values are distributed over a shape.

Bindings for faces and vertices are meaningful only for shapes composed of faces and vertices. Similarly, indexed bindings are relevant only for shapes that allow indexing.

The bindings apply solely 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 transparency values is less than the number of diffuse colors, only the first transparency value will be used, irrespective of the material binding. If the number of diffuse colors in the state is less than required for the specified binding, a debug warning will be printed. Setting the number of diffuse colors incorrectly may result in unpredictable colors.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

Parameter Fields

Visible Fields

Value

name: value, type: Enum, default: OVERALL

Defines how to bind materials to shapes.

Values:

Title	Name	Description
Overall	OVERALL	The entire object has same material.
Per Part	PER_PART	One material for each part of object.
Per Part Indexed	PER_PART_INDEXED	One material for each part, indexed.
Per Face	PER_FACE	One material for each face of object.
Per Face Indexed	PER_FACE_INDEXED	One material for each face, indexed.
Per Vertex	PER_VERTEX	One material for each vertex of object.
Per Vertex Indexed	PER_VERTEX_INDEXED	One material for each vertex, indexed.
Default	DEFAULT	Use the current default setting.
None	NONE	No value.