man SoMaterial () - surface material definition node

NAME

SoMaterial - surface material definition node

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoMaterial

SYNOPSIS

#include <Inventor/nodes/SoMaterial.h> Fields from class SoMaterial: c } c } ambientColor

c } c } diffuseColor

c } c } specularColor

c } c } emissiveColor

c } c } shininess

c } c } transparency Methods from class SoMaterial: c } c } SoMaterial()

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 defines the current surface material properties for all subsequent shapes. SoMaterial sets several components of the current material during traversal. Multiple values can be specified for the diffuseColor and transparency. Different shapes interpret materials with multiple values differently. To bind materials to shapes, use an SoMaterialBinding node.

FIELDS

c } c } ambientColor

Ambient color of the surface. c } c } diffuseColor

Diffuse color(s) of the surface. c } c } specularColor

Specular color of the surface. c } c } emissiveColor

Emissive color of the surface. c } c } shininess

Shininess coefficient of the surface. Values can range from 0.0 for no shininess (a diffuse surface) to 1.0 for maximum shininess (a highly polished surface). c } c } transparency

Transparency value(s) of the surface. Values can range from 0.0 for opaque surfaces to 1.0 for completely transparent surfaces. If the transparency type is SoGLRenderAction::SCREEN_DOOR then only the first transparency value will be used. With other transparency types, multiple transparencies will be used, if the SoMaterial node contains as many transparencies as diffuse colors. If there are not as many transparencies as diffuse colors, only the first transparency will be used.

METHODS

c } c } SoMaterial()

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

Returns type identifier for this class.

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction

Sets the ambient color, the diffuse color, the specular color, the emissive color, the shininess, and the transparency of the current material.

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

SoBaseColor, SoLightModel, SoMaterialBinding, SoPackedColor