com.openinventor.inventor.vrmlnodes

Class SoVRMLMaterial

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.vrmlnodes.SoVRMLNode

com.openinventor.inventor.vrmlnodes.SoVRMLMaterial

All Implemented Interfaces:

SafeDisposable

Deprecated.

As of Open Inventor 9500 See documentation for more details

public class SoVRMLMaterial
extends SoVRMLNode

Surface material definition node. See the VRML97 Specification, below.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

VRML97 SPECIFICATION

This section describes the expected behavior of the node in a conforming VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.

This section may reference portions of the VRML97 specification that are not present in this help file. The complete VRML97 spec is available at http://www.web3d.org.

The SoVRMLMaterial node specifies surface material properties for associated geometry nodes and are used by the VRML lighting equations during rendering. See "Concepts - Lighting Model" for a detailed description of the VRML lighting model equations.

All of the fields in the SoVRMLMaterial node range from 0.0 to 1.0.

The fields in the SoVRMLMaterial node determine the way light reflects off an object to create color:

• The diffuseColor reflects all VRML light sources depending on the angle of the surface with respect to the light source. The more directly the surface faces the light, the more diffuse light reflects.
• The ambientIntensity field specifies how much ambient light from light sources this surface should reflect. Ambient light is omnidirectional and depends only on the number of light sources, not their positions with respect to the surface. Ambient color is calculated as ambientIntensity * diffuseColor.
• The specularColor and shininess determine the specular highlightsfor example, the shiny spots on an apple. When the angle from the light to the surface is close to the angle from the surface to the viewer, the specularColor is added to the diffuse and ambient color calculations. Lower shininess values produce soft glows, while higher values result in sharper, smaller highlights.
• Emissive color models "glowing" objects. This can be useful for displaying radiosity-based models (where the light energy of the room is computed explicitly), or for displaying scientific data.
• Transparency is how "clear" the object is, with 1.0 being completely transparent, and 0.0 completely opaque.

File format/default:

VRMLMaterial {

ambientIntensity	0.2
diffuseColor	0.8 0.8 0.8
emissiveColor	0 0 0
shininess	0.2
specularColor	0 0 0
transparency	0
metadata	NULL
reflectiveColor	0 0 0
receiveShadow	false

}

Action behavior:

SoGLRenderAction, SoCallbackAction

EVENTS

eventIn

SoSFFloat	set_ambientIntensity
SoSFColor	set_diffuseColor
SoSFColor	set_emissiveColor
SoSFFloat	set_shininess
SoSFColor	set_specularColor
SoSFFloat	set_transparency
SoSFNode	set_metadata

eventOut

SoSFFloat	ambientIntensity_changed
SoSFColor	diffuseColor_changed
SoSFColor	emissiveColor_changed
SoSFFloat	shininess_changed
SoSFColor	specularColor_changed
SoSFFloat	transparency_changed
SoSFNode	metadata_changed

Deprecated since Open Inventor 9500
The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

Nested Class Summary

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFFloat	ambientIntensity Deprecated. Specifies how much ambient light from the light sources this surface should reflect.
SoSFColor	diffuseColor Deprecated. Diffuse color of the surface.
SoSFColor	emissiveColor Deprecated. Emissive color of the surface.
SoSFBool	receiveShadow Deprecated. DirectViz parameter.
SoSFColor	reflectiveColor Deprecated. DirectViz parameter.
SoSFFloat	shininess Deprecated. Shininess coefficient of the surface.
SoSFColor	specularColor Deprecated. Specular color of the surface.
SoSFFloat	transparency Deprecated. Transparency value of the surface.

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLNode

metadata

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoVRMLMaterial() Deprecated. Constructor.

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

diffuseColor

public final SoSFColor diffuseColor

Deprecated.

Diffuse color of the surface.

ambientIntensity

public final SoSFFloat ambientIntensity

Deprecated.

Specifies how much ambient light from the light sources this surface should reflect.

specularColor

public final SoSFColor specularColor

Deprecated.

Specular color of the surface.

emissiveColor

public final SoSFColor emissiveColor

Deprecated.

Emissive color of the surface.

shininess

public final SoSFFloat shininess

Deprecated.

Shininess coefficient of the surface. Values range from 0.0 for no shininess to 1.0 for maximum shininess.

transparency

public final SoSFFloat transparency

Deprecated.

Transparency value of the surface. Values range from 0.0 for opaque to 1.0 for completely transparent surfaces.

reflectiveColor

public final SoSFColor reflectiveColor

Deprecated.

DirectViz parameter. Reflective color of the shape. When set to black, the object is not reflective. The reflective component is added to the overall color of the object. This field has no effect when not doing DirectViz rendering. NOTE: This field is not part of the VRML specification.

Since:

Open Inventor 6.1

receiveShadow

public final SoSFBool receiveShadow

Deprecated.

DirectViz parameter. Indicates that all the shapes using this material node will receive shadows from other shapes when doing DirectViz rendering. This field has no effect when not doing DirectViz rendering. NOTE: This field is not part of the VRML specification.

Since:

Open Inventor 6.1

Constructor Detail

SoVRMLMaterial

public SoVRMLMaterial()

Deprecated.

Constructor.