com.openinventor.inventor.nodes

Class SoMaterialBinding

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoMaterialBinding

All Implemented Interfaces:

SafeDisposable

public class SoMaterialBinding
extends SoNode

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoMaterialBinding.Bindings

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	OVERALL Deprecated. Use SoMaterialBinding.Bindings.OVERALL instead.
static int	PER_FACE Deprecated. Use SoMaterialBinding.Bindings.PER_FACE instead.
static int	PER_FACE_INDEXED Deprecated. Use SoMaterialBinding.Bindings.PER_FACE_INDEXED instead.
static int	PER_PART Deprecated. Use SoMaterialBinding.Bindings.PER_PART instead.
static int	PER_PART_INDEXED Deprecated. Use SoMaterialBinding.Bindings.PER_PART_INDEXED instead.
static int	PER_VERTEX Deprecated. Use SoMaterialBinding.Bindings.PER_VERTEX instead.
static int	PER_VERTEX_INDEXED Deprecated. Use SoMaterialBinding.Bindings.PER_VERTEX_INDEXED instead.
SoSFEnum<SoMaterialBinding.Bindings>	value Specifies how to bind materials to shapes.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoMaterialBinding() Creates a material binding node with default settings.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OVERALL

@Deprecated
public static final int OVERALL

Deprecated. Use SoMaterialBinding.Bindings.OVERALL instead.

PER_PART

@Deprecated
public static final int PER_PART

Deprecated. Use SoMaterialBinding.Bindings.PER_PART instead.

PER_PART_INDEXED

@Deprecated
public static final int PER_PART_INDEXED

Deprecated. Use SoMaterialBinding.Bindings.PER_PART_INDEXED instead.

PER_FACE

@Deprecated
public static final int PER_FACE

Deprecated. Use SoMaterialBinding.Bindings.PER_FACE instead.

PER_FACE_INDEXED

@Deprecated
public static final int PER_FACE_INDEXED

Deprecated. Use SoMaterialBinding.Bindings.PER_FACE_INDEXED instead.

PER_VERTEX

@Deprecated
public static final int PER_VERTEX

Deprecated. Use SoMaterialBinding.Bindings.PER_VERTEX instead.

PER_VERTEX_INDEXED

@Deprecated
public static final int PER_VERTEX_INDEXED

Deprecated. Use SoMaterialBinding.Bindings.PER_VERTEX_INDEXED instead.

value

public final SoSFEnum<SoMaterialBinding.Bindings> value

Specifies how to bind materials to shapes. . Default is OVERALL.

Constructor Detail

SoMaterialBinding

public SoMaterialBinding()

Creates a material binding node with default settings.