Package org.web3d.x3d.sai.Interpolation

Interface CoordinateInterpolator

All Superinterfaces:

X3DChildNode, X3DInterpolatorNode, X3DNode

All Known Implementing Classes:

CoordinateInterpolator

public interface CoordinateInterpolator
extends X3DInterpolatorNode

CoordinateInterpolator linearly interpolates among a list of 3-tuple MFVec3f arrays, producing a single MFVec3f array that is fractional average between two nearest arrays in the list.

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. CoordinateInterpolator node tooltip: [X3DInterpolatorNode] CoordinateInterpolator linearly interpolates among a list of 3-tuple MFVec3f arrays, producing a single MFVec3f array that is fractional average between two nearest arrays in the list. Authors can ROUTE value_changed output events (an array of 3-tuple SFVec3f values) to a Coordinate node's point field, or to another MFVec3f field.

• Hint: typical input connection is ROUTE someTimeSensorDEF.fraction_changed TO thisInterpolatorDEF.set_fraction.
• Hint: typical output connection is ROUTE thisInterpolatorDEF.value_changed TO someDestinationNodeDEF.set_someAttribute.
• Hint: example scenes and authoring assets at https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation

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: CoordinateInterpolator
• X3D Tooltips: CoordinateInterpolator
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
float[]	getKey()	Provide array of float results from inputOutput MFFloat field named key.
float[]	getKeyValue()	Provide array of 3-tuple float results from inputOutput MFVec3f field named keyValue.
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
float[]	getValue()	Provide array of 3-tuple float results from outputOnly MFVec3f field named value_changed.
CoordinateInterpolator	setKey(float[] newValue)	Accessor method to assign float array to inputOutput MFFloat field named key.
CoordinateInterpolator	setKeyValue(float[] newValue)	Accessor method to assign 3-tuple float array to inputOutput MFVec3f field named keyValue.
CoordinateInterpolator	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

Method Details

getKey

float[] getKey()

Provide array of float results from inputOutput MFFloat field named key.

Tooltip: Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.

• Hint: number of keyValues must be an integer multiple of the number of keys!
• Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
• Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
• Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.

Specified by:

getKey in interface X3DInterpolatorNode

Returns:

value of key field

setKey

CoordinateInterpolator setKey(float[] newValue)

Accessor method to assign float array to inputOutput MFFloat field named key.

Tooltip: Definition values for linear-interpolation function input intervals, listed in non-decreasing order and corresponding to a value in the keyValue array.

• Hint: number of keyValues must be an integer multiple of the number of keys!
• Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
• Warning: values in key array shall be monotonically non-decreasing, meaning that each value is greater than or equal to the preceding value.
• Hint: typical interval for values in key array is within range of 0 to 1, but larger intervals can be defined with arbitrary bounds.

Specified by:

setKey in interface X3DInterpolatorNode

Parameters:

newValue - is new value for the key field.

Returns:

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

getKeyValue

float[] getKeyValue()

Provide array of 3-tuple float results from inputOutput MFVec3f field named keyValue.

Tooltip: Output values for linear interpolation, each corresponding to an input-fraction value in the key array.

• Hint: identical adjacent entries in keyValue array have the effect of defining constant-value step functions. https://en.wikipedia.org/wiki/Step_function
• Hint: number of keyValues must be an integer multiple of the number of keys!
• Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.

Returns:

value of keyValue field

setKeyValue

CoordinateInterpolator setKeyValue(float[] newValue)

Accessor method to assign 3-tuple float array to inputOutput MFVec3f field named keyValue.

Tooltip: Output values for linear interpolation, each corresponding to an input-fraction value in the key array.

• Hint: identical adjacent entries in keyValue array have the effect of defining constant-value step functions. https://en.wikipedia.org/wiki/Step_function
• Hint: number of keyValues must be an integer multiple of the number of keys!
• Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.

Parameters:

newValue - is new value for the keyValue field.

Returns:

CoordinateInterpolator - 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 X3DChildNode

Specified by:

getMetadata in interface X3DInterpolatorNode

Specified by:

getMetadata in interface X3DNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

CoordinateInterpolator 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 X3DChildNode

Specified by:

setMetadata in interface X3DInterpolatorNode

Specified by:

setMetadata in interface X3DNode

Parameters:

newValue - is new value for the metadata field.

Returns:

CoordinateInterpolator - 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

getValue

float[] getValue()

Provide array of 3-tuple float results from outputOnly MFVec3f field named value_changed.

Tooltip: Linearly interpolated output value determined by current key time and corresponding keyValue pair.

• Hint: X3D players might not send unchanging intermediate values, thus avoiding excessive superfluous events that have no effect.
• Hint: keyValue/key integer multiple defines how many coordinates are sent in value_changed outputOnlys.
• Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

Returns:

value of value_changed field