Package org.web3d.x3d.sai.Sound
Interface PeriodicWave
- All Superinterfaces:
X3DChildNode
,X3DNode
,X3DSoundNode
- All Known Implementing Classes:
PeriodicWave
PeriodicWave defines a periodic waveform that can be used to shape the output of an Oscillator.
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.
PeriodicWave node tooltip: [X3DNode] PeriodicWave defines a periodic waveform that can be used to shape the output of an Oscillator.#10;
- Hint: W3C Web Audio API https://www.w3.org/TR/webaudio/#periodicwave
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 TypeMethodDescriptionProvide String value from inputOutput SFString field named description.boolean
Provide boolean value from inputOutput SFBool field named enabled.Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.float[]
Provide array of float results from inputOutput MFFloat field named optionsImag.float[]
Provide array of float results from inputOutput MFFloat field named optionsReal.getType()
Provide String enumeration value (baseType SFString) ["SINE" | "SQUARE" | "SAWTOOTH" | "TRIANGLE" | "CUSTOM"] from inputOutput SFString field named type.setDescription
(String newValue) Accessor method to assign String value to inputOutput SFString field named description.setEnabled
(boolean newValue) Accessor method to assign boolean value to inputOutput SFBool field named enabled.setMetadata
(X3DMetadataObject newValue) Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.setOptionsImag
(float[] newValue) Accessor method to assign float array to inputOutput MFFloat field named optionsImag.setOptionsReal
(float[] newValue) Accessor method to assign float array to inputOutput MFFloat field named optionsReal.Accessor method to assign String enumeration value ("SINE" | "SQUARE" | "SAWTOOTH" | "TRIANGLE" | "CUSTOM") to inputOutput SFString field named type.
-
Method Details
-
getDescription
String getDescription()Provide String value from inputOutput SFString field named description.
Tooltip: Author-provided prose that describes intended purpose of the url asset.- Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as & for & ampersand character, or " for " quotation-mark character).
- Specified by:
getDescription
in interfaceX3DSoundNode
- Returns:
- value of description field
-
setDescription
Accessor method to assign String value to inputOutput SFString field named description.
Tooltip: Author-provided prose that describes intended purpose of the url asset.- Hint: many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as & for & ampersand character, or " for " quotation-mark character).
- Specified by:
setDescription
in interfaceX3DSoundNode
- Parameters:
newValue
- is new value for the description field.- Returns:
PeriodicWave
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
getEnabled
boolean getEnabled()Provide boolean value from inputOutput SFBool field named enabled.
Tooltip: Enables/disables node operation. *- Specified by:
getEnabled
in interfaceX3DSoundNode
- Returns:
- value of enabled field
-
setEnabled
Accessor method to assign boolean value to inputOutput SFBool field named enabled.
Tooltip: Enables/disables node operation. *- Specified by:
setEnabled
in interfaceX3DSoundNode
- Parameters:
newValue
- is new value for the enabled field.- Returns:
PeriodicWave
- 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 interfaceX3DChildNode
- Specified by:
getMetadata
in interfaceX3DNode
- Specified by:
getMetadata
in interfaceX3DSoundNode
- 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 interfaceX3DChildNode
- Specified by:
setMetadata
in interfaceX3DNode
- Specified by:
setMetadata
in interfaceX3DSoundNode
- Parameters:
newValue
- is new value for the metadata field.- Returns:
PeriodicWave
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).- See Also:
-
getOptionsImag
float[] getOptionsImag()Provide array of float results from inputOutput MFFloat field named optionsImag.
Tooltip: imaginary coefficients for defining a waveform.- Warning: array lengths for optionsReal and optionsImag must match.
- Returns:
- value of optionsImag field
-
setOptionsImag
Accessor method to assign float array to inputOutput MFFloat field named optionsImag.
Tooltip: imaginary coefficients for defining a waveform.- Warning: array lengths for optionsReal and optionsImag must match.
- Parameters:
newValue
- is new value for the optionsImag field.- Returns:
PeriodicWave
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
getOptionsReal
float[] getOptionsReal()Provide array of float results from inputOutput MFFloat field named optionsReal.
Tooltip: real coefficients for defining a waveform.- Warning: array lengths for optionsReal and optionsImag must match.
- Returns:
- value of optionsReal field
-
setOptionsReal
Accessor method to assign float array to inputOutput MFFloat field named optionsReal.
Tooltip: real coefficients for defining a waveform.- Warning: array lengths for optionsReal and optionsImag must match.
- Parameters:
newValue
- is new value for the optionsReal field.- Returns:
PeriodicWave
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
getType
String getType()Provide String enumeration value (baseType SFString) ["SINE" | "SQUARE" | "SAWTOOTH" | "TRIANGLE" | "CUSTOM"] from inputOutput SFString field named type.
Tooltip: The type field specifies shape of waveform to play, which can be one of several provided values or else 'custom' to indicate that real and imaginary coefficient arrays define a custom waveform.- Hint: W3C Web Audio API https://www.w3.org/TR/webaudio/#dictdef-periodicwaveoptions
- Returns:
- value of type field
-
setType
Accessor method to assign String enumeration value ("SINE" | "SQUARE" | "SAWTOOTH" | "TRIANGLE" | "CUSTOM") to inputOutput SFString field named type.
Tooltip: The type field specifies shape of waveform to play, which can be one of several provided values or else 'custom' to indicate that real and imaginary coefficient arrays define a custom waveform.- Hint: W3C Web Audio API https://www.w3.org/TR/webaudio/#dictdef-periodicwaveoptions
- Parameters:
newValue
- is new value for the type field.- Returns:
PeriodicWave
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-