Package org.web3d.x3d.sai.Followers

Interface OrientationChaser

All Superinterfaces:

X3DChaserNode, X3DChildNode, X3DFollowerNode, X3DNode

All Known Implementing Classes:

OrientationChaser

public interface OrientationChaser
extends X3DChaserNode

OrientationChaser generates a series of 4-tuple axis-angle SFRotation values that progressively change from initial value to destination value.

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. OrientationChaser node tooltip: (X3D version 3.2 or later) [X3DChaserNode] OrientationChaser generates a series of 4-tuple axis-angle SFRotation values that progressively change from initial value to destination value.

• Hint: ROUTE value_changed output events to a <Transform> node's rotation field, for example.

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

Method Summary

Modifier and Type	Method	Description
double	getDuration()	Provide double value in seconds within allowed range of [0,infinity) from initializeOnly SFTime field named duration.
float[]	getInitialDestination()	Provide array of 4-tuple float results unit axis, angle (in radians) from initializeOnly SFRotation field named initialDestination.
float[]	getInitialValue()	Provide array of 4-tuple float results unit axis, angle (in radians) from initializeOnly SFRotation field named initialValue.
boolean	getIsActive()	Provide boolean value from outputOnly SFBool field named isActive.
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 4-tuple float results unit axis, angle (in radians) from outputOnly SFRotation field named value_changed.
OrientationChaser	setDuration(double newValue)	Accessor method to assign double value in seconds to initializeOnly SFTime field named duration.
OrientationChaser	setInitialDestination(float[] newValue)	Accessor method to assign 4-tuple float array unit axis, angle (in radians) to initializeOnly SFRotation field named initialDestination.
OrientationChaser	setInitialValue(float[] newValue)	Accessor method to assign 4-tuple float array unit axis, angle (in radians) to initializeOnly SFRotation field named initialValue.
OrientationChaser	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

getDuration

double getDuration()

Provide double value in seconds within allowed range of [0,infinity) from initializeOnly SFTime field named duration.

Tooltip: [0,+infinity) duration is the time interval for filter response in seconds.

• Hint: duration is a nonnegative SFTime duration interval, not an absolute clock time.

Specified by:

getDuration in interface X3DChaserNode

Returns:

value of duration field

setDuration

OrientationChaser setDuration(double newValue)

Accessor method to assign double value in seconds to initializeOnly SFTime field named duration.

Tooltip: [0,+infinity) duration is the time interval for filter response in seconds.

• Hint: duration is a nonnegative SFTime duration interval, not an absolute clock time.

Specified by:

setDuration in interface X3DChaserNode

Parameters:

newValue - is new value for the duration field.

Returns:

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

getInitialDestination

float[] getInitialDestination()

Provide array of 4-tuple float results unit axis, angle (in radians) from initializeOnly SFRotation field named initialDestination.

Tooltip: Initial destination value for this node. *

Returns:

value of initialDestination field

setInitialDestination

OrientationChaser setInitialDestination(float[] newValue)

Accessor method to assign 4-tuple float array unit axis, angle (in radians) to initializeOnly SFRotation field named initialDestination.

Tooltip: Initial destination value for this node. *

Parameters:

newValue - is new value for the initialDestination field.

Returns:

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

getInitialValue

float[] getInitialValue()

Provide array of 4-tuple float results unit axis, angle (in radians) from initializeOnly SFRotation field named initialValue.

Tooltip: Initial starting value for this node. *

Returns:

value of initialValue field

setInitialValue

OrientationChaser setInitialValue(float[] newValue)

Accessor method to assign 4-tuple float array unit axis, angle (in radians) to initializeOnly SFRotation field named initialValue.

Tooltip: Initial starting value for this node. *

Parameters:

newValue - is new value for the initialValue field.

Returns:

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

getIsActive

boolean getIsActive()

Provide boolean value from outputOnly SFBool field named isActive.

Tooltip: isActive true/false events are sent when follower-node computation starts/stops.

• Warning: it is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.

Specified by:

getIsActive in interface X3DChaserNode

Specified by:

getIsActive in interface X3DFollowerNode

Returns:

value of isActive field

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 X3DChaserNode

Specified by:

getMetadata in interface X3DChildNode

Specified by:

getMetadata in interface X3DFollowerNode

Specified by:

getMetadata in interface X3DNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

OrientationChaser 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 X3DChaserNode

Specified by:

setMetadata in interface X3DChildNode

Specified by:

setMetadata in interface X3DFollowerNode

Specified by:

setMetadata in interface X3DNode

Parameters:

newValue - is new value for the metadata field.

Returns:

OrientationChaser - 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 4-tuple float results unit axis, angle (in radians) from outputOnly SFRotation field named value_changed.

Tooltip: Computed output value that approaches within tolerance of destination value, as determined by elapsed time, order and tau.

• 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