Package org.web3d.x3d.sai.Shape
Interface Material
- All Superinterfaces:
X3DAppearanceChildNode
,X3DMaterialNode
,X3DNode
,X3DOneSidedMaterialNode
- All Known Implementing Classes:
Material
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
Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
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:
-
Method Summary
Modifier and TypeMethodDescriptionfloat
Provide float value within allowed range of [0,1] from inputOutput SFFloat field named ambientIntensity.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field ambientTexture.Provide String value from inputOutput SFString field named ambientTextureMapping.float[]
Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named diffuseColor.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field diffuseTexture.Provide String value from inputOutput SFString field named diffuseTextureMapping.float[]
Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named emissiveColor.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field emissiveTexture.Provide String value from inputOutput SFString field named emissiveTextureMapping.Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.float
Provide float value within allowed range of [0,infinity) from inputOutput SFFloat field named normalScale.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field normalTexture.Provide String value from inputOutput SFString field named normalTextureMapping.float
Provide float value within allowed range of [0,1] from inputOutput SFFloat field named occlusionStrength.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field occlusionTexture.Provide String value from inputOutput SFString field named occlusionTextureMapping.float
Provide float value within allowed range of [0,1] from inputOutput SFFloat field named shininess.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field shininessTexture.Provide String value from inputOutput SFString field named shininessTextureMapping.float[]
Provide array of 3-tuple float results using RGB values [0..1] using RGB values [0..1] from inputOutput SFColor field named specularColor.Provide org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) from inputOutput SFNode field specularTexture.Provide String value from inputOutput SFString field named specularTextureMapping.float
Provide float value within allowed range of [0,1] from inputOutput SFFloat field named transparency.setAmbientIntensity
(float newValue) Accessor method to assign float value to inputOutput SFFloat field named ambientIntensity.setAmbientTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field ambientTexture.setAmbientTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named ambientTextureMapping.setDiffuseColor
(float[] newValue) Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named diffuseColor.setDiffuseTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field diffuseTexture.setDiffuseTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named diffuseTextureMapping.setEmissiveColor
(float[] newValue) Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named emissiveColor.setEmissiveTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field emissiveTexture.setEmissiveTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named emissiveTextureMapping.setMetadata
(X3DMetadataObject newValue) Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.setNormalScale
(float newValue) Accessor method to assign float value to inputOutput SFFloat field named normalScale.setNormalTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field normalTexture.setNormalTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named normalTextureMapping.setOcclusionStrength
(float newValue) Accessor method to assign float value to inputOutput SFFloat field named occlusionStrength.setOcclusionTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field occlusionTexture.setOcclusionTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named occlusionTextureMapping.setShininess
(float newValue) Accessor method to assign float value to inputOutput SFFloat field named shininess.setShininessTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field shininessTexture.setShininessTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named shininessTextureMapping.setSpecularColor
(float[] newValue) Accessor method to assign 3-tuple float array using RGB values [0..1] to inputOutput SFColor field named specularColor.setSpecularTexture
(X3DSingleTextureNode newValue) Accessor method to assign org.web3d.x3d.sai.Texturing.X3DSingleTextureNode instance (using a properly typed node) to inputOutput SFNode field specularTexture.setSpecularTextureMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named specularTextureMapping.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
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
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
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
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
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
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
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
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 interfaceX3DOneSidedMaterialNode
- Returns:
- value of emissiveTextureMapping field
-
setEmissiveTextureMapping
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 interfaceX3DOneSidedMaterialNode
- 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 interfaceX3DAppearanceChildNode
- Specified by:
getMetadata
in interfaceX3DMaterialNode
- Specified by:
getMetadata
in interfaceX3DNode
- Specified by:
getMetadata
in interfaceX3DOneSidedMaterialNode
- Returns:
- value of metadata field
- See Also:
-
setMetadata
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 interfaceX3DAppearanceChildNode
- Specified by:
setMetadata
in interfaceX3DMaterialNode
- Specified by:
setMetadata
in interfaceX3DNode
- Specified by:
setMetadata
in interfaceX3DOneSidedMaterialNode
- 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:
-
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 interfaceX3DOneSidedMaterialNode
- Returns:
- value of normalScale field
-
setNormalScale
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 interfaceX3DOneSidedMaterialNode
- 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
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 interfaceX3DOneSidedMaterialNode
- Returns:
- value of normalTextureMapping field
-
setNormalTextureMapping
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 interfaceX3DOneSidedMaterialNode
- 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
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
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
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
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
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
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
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
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
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
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).
-