[x3d-public] problem: omissions in X3D4 nodes implementing Web Audio API

Brutzman, Donald (Don) (CIV) brutzman at nps.edu
Fri Jan 13 19:02:04 PST 2023


Hi guys, hope you are well.

 

I'm applying X3D naming conventions to Web Audio API enumerations.
capitalizing constant names, changing hyphens to underscores.

 

Problem report: during this effort have uncovered some apparent omissions in
our specification.

 

We have support for only 5 of 10 sets of enumerations.  The following
enumeration sets are omissions.  This implies that corresponding fields in
nodes are missing too.

 

 

*	1.1. The BaseAudioContext
<https://www.w3.org/TR/webaudio/#baseaudiocontext>  Interface
*	https://www.w3.org/TR/webaudio/#BaseAudioContext

 

*        enum AudioContextState {
   <https://www.w3.org/TR/webaudio/#dom-audiocontextstate-suspended>
"suspended",
   <https://www.w3.org/TR/webaudio/#dom-audiocontextstate-running>
"running",
   <https://www.w3.org/TR/webaudio/#dom-audiocontextstate-closed> "closed"
};

*	https://www.w3.org/TR/webaudio/#enumdef-audiocontextstate

 

 

*	1.2. The AudioContext <https://www.w3.org/TR/webaudio/#audiocontext>
Interface
*	https://www.w3.org/TR/webaudio/#AudioContext

 
*        enum AudioContextLatencyCategory {
 
<https://www.w3.org/TR/webaudio/#dom-audiocontextlatencycategory-balanced>
"balanced",
 
<https://www.w3.org/TR/webaudio/#dom-audiocontextlatencycategory-interactive
> "interactive",
 
<https://www.w3.org/TR/webaudio/#dom-audiocontextlatencycategory-playback>
"playback"
};

*	https://www.w3.org/TR/webaudio/#enumdef-audiocontextlatencycategory

 

 

*	1.6. The AudioParam <https://www.w3.org/TR/webaudio/#audioparam>
Interface
*	https://www.w3.org/TR/webaudio/#AudioParam

*        enum AutomationRate {
   <https://www.w3.org/TR/webaudio/#dom-automationrate-a-rate> "a-rate",
   <https://www.w3.org/TR/webaudio/#dom-automationrate-k-rate> "k-rate"
};

*	https://www.w3.org/TR/webaudio/#enumdef-automationrate

 

 

*	1.27. The PannerNode <https://www.w3.org/TR/webaudio/#pannernode>
Interface
*	https://www.w3.org/TR/webaudio/#PannerNode

 
*        enum PanningModelType {
     <https://www.w3.org/TR/webaudio/#dom-panningmodeltype-equalpower>
"equalpower",
     <https://www.w3.org/TR/webaudio/#dom-panningmodeltype-hrtf> "HRTF"
};

*	https://www.w3.org/TR/webaudio/#enumdef-panningmodeltype

 
*        enum DistanceModelType {
   <https://www.w3.org/TR/webaudio/#dom-distancemodeltype-linear> "linear",
   <https://www.w3.org/TR/webaudio/#dom-distancemodeltype-inverse>
"inverse",
   <https://www.w3.org/TR/webaudio/#dom-distancemodeltype-exponential>
"exponential"
};

*	https://www.w3.org/TR/webaudio/#enumdef-distancemodeltype

 

 

Looks like we might have already uncovered some X3D4 omissions.  ouch.

 

Discussion here on mailing list please.  Tracking issue as

*	Mantis 1420: Missing 5 enumeration sets (and likely fields) from Web
Audio interfaces
*	https://www.web3d.org/member-only/mantis/view.php?id=1420

 

Please look over these missing interfaces, and where they belong, and then
let's figure out next steps.

 

p.s. X3D XML Schema and DOCTYPE revised, updated the other already-existing
interfaces with capitalized enumeration names:

 

*
https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0_biqua
dTypeFilterChoices.html
*
https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0_chann
elCountModeChoices.html
*
https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0_chann
elInterpretationChoices.html
*
https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0_dista
nceModelChoices.html
*
https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0_perio
dicWaveTypeChoices.html

 

Thanks in advance for another round of close scrutiny on this important
capability for spatialized high-fidelity computational sound in X3D4.

 

all the best, Don

-- 

Don Brutzman  Naval Postgraduate School, Code USW/Br        brutzman at nps.edu

Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA    +1.831.656.2149

X3D graphics, virtual worlds, Navy robotics https://
faculty.nps.edu/brutzman

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20230114/5d2edafd/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5353 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20230114/5d2edafd/attachment-0001.p7s>


More information about the x3d-public mailing list