Interface Material

All Superinterfaces:

X3DAppearanceChildNode, X3DMaterialNode, X3DNode, X3DOneSidedMaterialNode

All Known Implementing Classes:

Material

public interface Material
extends X3DOneSidedMaterialNode

Material specifies surface rendering properties for associated geometry nodes.

Warning: this is an abstract interface that cannot be instantiated as a concrete object. Java programmers typically only need to use concrete objects provided by the org.web3d.x3d.jsail classes. Material node tooltip: [X3DOneSidedMaterialNode] Material specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.

• Hint: insert Shape and Appearance nodes before adding material.
• Hint: DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
• Hint: X3D Scene Authoring Hints, Color https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color
• Hint: X3D Example Archives, Basic, Universal Media Materials https://www.web3d.org/x3d/content/examples/Basic/UniversalMediaMaterials
• Hint: X3D Architecture 17.2.2 Lighting model https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/lighting.html#Lightingmodel
• Hint: Rendering https://en.wikipedia.org/wiki/Rendering_(computer_graphics)
• Hint: 3D rendering https://en.wikipedia.org/wiki/3D_rendering
• Hint: Physically based rendering (PBR) https://en.wikipedia.org/wiki/Physically_based_rendering

Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).

See Also:

• SAI Java Specification
• X3D Abstract Specification: Material
• X3D Tooltips: Material
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
float	getAmbientIntensity()	Provide float value within allowed range of [0,1] from inputOutput SFFloat field named ambientIntensity.
X3DSingleTextureNode	getAmbientTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field ambientTexture.
String	getAmbientTextureMapping()	Provide String value from inputOutput SFString field named ambientTextureMapping.
float[]	getDiffuseColor()	Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named diffuseColor.
X3DSingleTextureNode	getDiffuseTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field diffuseTexture.
String	getDiffuseTextureMapping()	Provide String value from inputOutput SFString field named diffuseTextureMapping.
float[]	getEmissiveColor()	Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named emissiveColor.
X3DSingleTextureNode	getEmissiveTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field emissiveTexture.
String	getEmissiveTextureMapping()	Provide String value from inputOutput SFString field named emissiveTextureMapping.
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
float	getNormalScale()	Provide float value within allowed range of [0,infinity) from inputOutput SFFloat field named normalScale.
X3DSingleTextureNode	getNormalTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field normalTexture.
String	getNormalTextureMapping()	Provide String value from inputOutput SFString field named normalTextureMapping.
float	getOcclusionStrength()	Provide float value within allowed range of [0,1] from inputOutput SFFloat field named occlusionStrength.
X3DSingleTextureNode	getOcclusionTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field occlusionTexture.
String	getOcclusionTextureMapping()	Provide String value from inputOutput SFString field named occlusionTextureMapping.
float	getShininess()	Provide float value within allowed range of [0,1] from inputOutput SFFloat field named shininess.
X3DSingleTextureNode	getShininessTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field shininessTexture.
String	getShininessTextureMapping()	Provide String value from inputOutput SFString field named shininessTextureMapping.
float[]	getSpecularColor()	Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named specularColor.
X3DSingleTextureNode	getSpecularTexture()	Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field specularTexture.
String	getSpecularTextureMapping()	Provide String value from inputOutput SFString field named specularTextureMapping.
float	getTransparency()	Provide float value within allowed range of [0,1] from inputOutput SFFloat field named transparency.
Material	setAmbientIntensity(float newValue)	Accessor method to assign float value to inputOutput SFFloat field named ambientIntensity.
Material	setAmbientTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field ambientTexture.
Material	setAmbientTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named ambientTextureMapping.
Material	setDiffuseColor(float[] newValue)	Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named diffuseColor.
Material	setDiffuseTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field diffuseTexture.
Material	setDiffuseTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named diffuseTextureMapping.
Material	setEmissiveColor(float[] newValue)	Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named emissiveColor.
Material	setEmissiveTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field emissiveTexture.
Material	setEmissiveTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named emissiveTextureMapping.
Material	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
Material	setNormalScale(float newValue)	Accessor method to assign float value to inputOutput SFFloat field named normalScale.
Material	setNormalTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field normalTexture.
Material	setNormalTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named normalTextureMapping.
Material	setOcclusionStrength(float newValue)	Accessor method to assign float value to inputOutput SFFloat field named occlusionStrength.
Material	setOcclusionTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field occlusionTexture.
Material	setOcclusionTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named occlusionTextureMapping.
Material	setShininess(float newValue)	Accessor method to assign float value to inputOutput SFFloat field named shininess.
Material	setShininessTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field shininessTexture.
Material	setShininessTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named shininessTextureMapping.
Material	setSpecularColor(float[] newValue)	Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named specularColor.
Material	setSpecularTexture(X3DSingleTextureNode newValue)	Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field specularTexture.
Material	setSpecularTextureMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named specularTextureMapping.
Material	setTransparency(float newValue)	Accessor method to assign float value to inputOutput SFFloat field named transparency.

Method Details

getAmbientIntensity

float getAmbientIntensity()

Provide float value within allowed range of [0,1] from inputOutput SFFloat field named ambientIntensity.

Tooltip: [0,1] how much ambient omnidirectional light is reflected from all light sources. Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Returns:

value of ambientIntensity field

setAmbientIntensity

Material setAmbientIntensity(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named ambientIntensity.

Tooltip: [0,1] how much ambient omnidirectional light is reflected from all light sources. Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Parameters:

newValue - is new value for the ambientIntensity field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getAmbientTexture

X3DSingleTextureNode getAmbientTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field ambientTexture.

Tooltip: [X3DSingleTextureNode] When applying ambientIntensity for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='ambientTexture'.

Returns:

value of ambientTexture field

setAmbientTexture

Material setAmbientTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field ambientTexture.

Tooltip: [X3DSingleTextureNode] When applying ambientIntensity for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='ambientTexture'.

Parameters:

newValue - is new value for the ambientTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getAmbientTextureMapping

String getAmbientTextureMapping()

Provide String value from inputOutput SFString field named ambientTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Returns:

value of ambientTextureMapping field

setAmbientTextureMapping

Material setAmbientTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named ambientTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Parameters:

newValue - is new value for the ambientTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getDiffuseColor

float[] getDiffuseColor()

Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named diffuseColor.

Tooltip: [0,1] how much direct, angle-dependent light is reflected from all light sources.

• Hint: only emissiveColor affects IndexedLineSet, LineSet and PointSet.

Returns:

value of diffuseColor field

setDiffuseColor

Material setDiffuseColor(float[] newValue)

Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named diffuseColor.

Tooltip: [0,1] how much direct, angle-dependent light is reflected from all light sources.

• Hint: only emissiveColor affects IndexedLineSet, LineSet and PointSet.

Parameters:

newValue - is new value for the diffuseColor field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getDiffuseTexture

X3DSingleTextureNode getDiffuseTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field diffuseTexture.

Tooltip: [X3DSingleTextureNode] When applying diffuseColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='diffuseTexture'.

Returns:

value of diffuseTexture field

setDiffuseTexture

Material setDiffuseTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field diffuseTexture.

Tooltip: [X3DSingleTextureNode] When applying diffuseColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='diffuseTexture'.

Parameters:

newValue - is new value for the diffuseTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getDiffuseTextureMapping

String getDiffuseTextureMapping()

Provide String value from inputOutput SFString field named diffuseTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Returns:

value of diffuseTextureMapping field

setDiffuseTextureMapping

Material setDiffuseTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named diffuseTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Parameters:

newValue - is new value for the diffuseTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getEmissiveColor

float[] getEmissiveColor()

Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named emissiveColor.

Tooltip: [0,1] how much glowing light is emitted from this object.

• Hint: emissiveColors glow even when all lights are off.
• Hint: reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
• Hint: only emissiveColor affects IndexedLineSet, LineSet and PointSet.
• Warning: bright emissiveColor values can wash out other colors and some textures.

Returns:

value of emissiveColor field

setEmissiveColor

Material setEmissiveColor(float[] newValue)

Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named emissiveColor.

Tooltip: [0,1] how much glowing light is emitted from this object.

• Hint: emissiveColors glow even when all lights are off.
• Hint: reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
• Hint: only emissiveColor affects IndexedLineSet, LineSet and PointSet.
• Warning: bright emissiveColor values can wash out other colors and some textures.

Parameters:

newValue - is new value for the emissiveColor field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getEmissiveTexture

X3DSingleTextureNode getEmissiveTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field emissiveTexture.

Tooltip: [X3DSingleTextureNode] When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='emissiveTexture'.

Returns:

value of emissiveTexture field

setEmissiveTexture

Material setEmissiveTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field emissiveTexture.

Tooltip: [X3DSingleTextureNode] When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='emissiveTexture'.

Parameters:

newValue - is new value for the emissiveTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getEmissiveTextureMapping

String getEmissiveTextureMapping()

Provide String value from inputOutput SFString field named emissiveTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Specified by:

getEmissiveTextureMapping in interface X3DOneSidedMaterialNode

Returns:

value of emissiveTextureMapping field

setEmissiveTextureMapping

Material setEmissiveTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named emissiveTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Specified by:

setEmissiveTextureMapping in interface X3DOneSidedMaterialNode

Parameters:

newValue - is new value for the emissiveTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getMetadata

X3DMetadataObject getMetadata()

Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.

Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

• Hint: X3D Architecture 7.2.4 Metadata https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/core.html#Metadata

Specified by:

getMetadata in interface X3DAppearanceChildNode

Specified by:

getMetadata in interface X3DMaterialNode

Specified by:

getMetadata in interface X3DNode

Specified by:

getMetadata in interface X3DOneSidedMaterialNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

Material setMetadata(X3DMetadataObject newValue)

Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

• Hint: X3D Architecture 7.2.4 Metadata https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/core.html#Metadata

Specified by:

setMetadata in interface X3DAppearanceChildNode

Specified by:

setMetadata in interface X3DMaterialNode

Specified by:

setMetadata in interface X3DNode

Specified by:

setMetadata in interface X3DOneSidedMaterialNode

Parameters:

newValue - is new value for the metadata field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

getNormalScale

float getNormalScale()

Provide float value within allowed range of [0,infinity) from inputOutput SFFloat field named normalScale.

Tooltip: [0,infinity] normalScale controls the degree to which normalTexture RGB values apply XYZ-normal bump mapping to pixels in the parent material.

• Hint: normalScale only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
• Hint: normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping

Specified by:

getNormalScale in interface X3DOneSidedMaterialNode

Returns:

value of normalScale field

setNormalScale

Material setNormalScale(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named normalScale.

Tooltip: [0,infinity] normalScale controls the degree to which normalTexture RGB values apply XYZ-normal bump mapping to pixels in the parent material.

• Hint: normalScale only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
• Hint: normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping

Specified by:

setNormalScale in interface X3DOneSidedMaterialNode

Parameters:

newValue - is new value for the normalScale field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getNormalTexture

X3DSingleTextureNode getNormalTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field normalTexture.

Tooltip: [X3DSingleTextureNode] When applying normalScale for this material node, the contained texture modulates the texture across the surface.

• Hint: normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='normalTexture'

Returns:

value of normalTexture field

setNormalTexture

Material setNormalTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field normalTexture.

Tooltip: [X3DSingleTextureNode] When applying normalScale for this material node, the contained texture modulates the texture across the surface.

• Hint: normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='normalTexture'

Parameters:

newValue - is new value for the normalTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getNormalTextureMapping

String getNormalTextureMapping()

Provide String value from inputOutput SFString field named normalTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Specified by:

getNormalTextureMapping in interface X3DOneSidedMaterialNode

Returns:

value of normalTextureMapping field

setNormalTextureMapping

Material setNormalTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named normalTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Specified by:

setNormalTextureMapping in interface X3DOneSidedMaterialNode

Parameters:

newValue - is new value for the normalTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getOcclusionStrength

float getOcclusionStrength()

Provide float value within allowed range of [0,1] from inputOutput SFFloat field named occlusionStrength.

Tooltip: [0,1] occlusionStrength indicates areas of indirect lighting, typically called ambient occlusion. Higher values indicate areas that should receive full indirect lighting and lower values indicate no indirect lighting.

• Hint: only the Red channel of the texture is used for occlusion computations, other channels are ignored.
• Hint: https://en.wikipedia.org/wiki/Ambient_occlusion

Returns:

value of occlusionStrength field

setOcclusionStrength

Material setOcclusionStrength(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named occlusionStrength.

Tooltip: [0,1] occlusionStrength indicates areas of indirect lighting, typically called ambient occlusion. Higher values indicate areas that should receive full indirect lighting and lower values indicate no indirect lighting.

• Hint: only the Red channel of the texture is used for occlusion computations, other channels are ignored.
• Hint: https://en.wikipedia.org/wiki/Ambient_occlusion

Parameters:

newValue - is new value for the occlusionStrength field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getOcclusionTexture

X3DSingleTextureNode getOcclusionTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field occlusionTexture.

Tooltip: [X3DSingleTextureNode] When applying occlusionStrength for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='occlusionTexture'.

Returns:

value of occlusionTexture field

setOcclusionTexture

Material setOcclusionTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field occlusionTexture.

Tooltip: [X3DSingleTextureNode] When applying occlusionStrength for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='occlusionTexture'.

Parameters:

newValue - is new value for the occlusionTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getOcclusionTextureMapping

String getOcclusionTextureMapping()

Provide String value from inputOutput SFString field named occlusionTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Returns:

value of occlusionTextureMapping field

setOcclusionTextureMapping

Material setOcclusionTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named occlusionTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Parameters:

newValue - is new value for the occlusionTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getShininess

float getShininess()

Provide float value within allowed range of [0,1] from inputOutput SFFloat field named shininess.

Tooltip: [0,1] Lower shininess values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Returns:

value of shininess field

setShininess

Material setShininess(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named shininess.

Tooltip: [0,1] Lower shininess values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Parameters:

newValue - is new value for the shininess field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getShininessTexture

X3DSingleTextureNode getShininessTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field shininessTexture.

Tooltip: [X3DSingleTextureNode] When applying shininess for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='shininessTexture'.

Returns:

value of shininessTexture field

setShininessTexture

Material setShininessTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field shininessTexture.

Tooltip: [X3DSingleTextureNode] When applying shininess for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='shininessTexture'.

Parameters:

newValue - is new value for the shininessTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getShininessTextureMapping

String getShininessTextureMapping()

Provide String value from inputOutput SFString field named shininessTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Returns:

value of shininessTextureMapping field

setShininessTextureMapping

Material setShininessTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named shininessTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Parameters:

newValue - is new value for the shininessTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getSpecularColor

float[] getSpecularColor()

Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named specularColor.

Tooltip: [0,1] specular highlights are brightness reflections (example: shiny spots on an apple). Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Returns:

value of specularColor field

setSpecularColor

Material setSpecularColor(float[] newValue)

Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named specularColor.

Tooltip: [0,1] specular highlights are brightness reflections (example: shiny spots on an apple). Interchange profile

• Hint: this field may be ignored, applying the default value regardless.

Parameters:

newValue - is new value for the specularColor field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getSpecularTexture

X3DSingleTextureNode getSpecularTexture()

Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field specularTexture.

Tooltip: [X3DSingleTextureNode] When applying specularColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='specularTexture'.

Returns:

value of specularTexture field

setSpecularTexture

Material setSpecularTexture(X3DSingleTextureNode newValue)

Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field specularTexture.

Tooltip: [X3DSingleTextureNode] When applying specularColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.

• Hint: if texture node is NULL or unspecified, no effect is applied to material values.
• Hint: contained texture node must include containerField='specularTexture'.

Parameters:

newValue - is new value for the specularTexture field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getSpecularTextureMapping

String getSpecularTextureMapping()

Provide String value from inputOutput SFString field named specularTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Returns:

value of specularTextureMapping field

setSpecularTextureMapping

Material setSpecularTextureMapping(String newValue)

Accessor method to assign String value to inputOutput SFString field named specularTextureMapping.

Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.

• Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator

Parameters:

newValue - is new value for the specularTextureMapping field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getTransparency

float getTransparency()

Provide float value within allowed range of [0,1] from inputOutput SFFloat field named transparency.

Tooltip: [0,1] how "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile

• Hint: transparency < .5 opaque, transparency > .5 transparent.

Returns:

value of transparency field

setTransparency

Material setTransparency(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named transparency.

Tooltip: [0,1] how "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile

• Hint: transparency < .5 opaque, transparency > .5 transparent.

Parameters:

newValue - is new value for the transparency field.

Returns:

Material - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).