x_ite 8.8.7 → 8.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (352) hide show
  1. package/Makefile +6 -0
  2. package/README.md +3 -7
  3. package/build/docs/nodes.pl +434 -0
  4. package/dist/assets/components/Annotation.js +13 -13
  5. package/dist/assets/components/Annotation.min.js +1 -1
  6. package/dist/assets/components/CADGeometry.js +13 -13
  7. package/dist/assets/components/CADGeometry.min.js +1 -1
  8. package/dist/assets/components/CubeMapTexturing.js +26 -26
  9. package/dist/assets/components/CubeMapTexturing.min.js +1 -1
  10. package/dist/assets/components/DIS.js +14 -14
  11. package/dist/assets/components/DIS.min.js +1 -1
  12. package/dist/assets/components/EventUtilities.js +9 -9
  13. package/dist/assets/components/EventUtilities.min.js +1 -1
  14. package/dist/assets/components/Geometry2D.js +19 -19
  15. package/dist/assets/components/Geometry2D.min.js +1 -1
  16. package/dist/assets/components/Geospatial.js +33 -33
  17. package/dist/assets/components/Geospatial.min.js +1 -1
  18. package/dist/assets/components/HAnim.js +129 -90
  19. package/dist/assets/components/HAnim.min.js +1 -1
  20. package/dist/assets/components/KeyDeviceSensor.js +8 -8
  21. package/dist/assets/components/KeyDeviceSensor.min.js +1 -1
  22. package/dist/assets/components/Layout.js +27 -27
  23. package/dist/assets/components/Layout.min.js +1 -1
  24. package/dist/assets/components/NURBS.js +24 -24
  25. package/dist/assets/components/NURBS.min.js +1 -1
  26. package/dist/assets/components/ParticleSystems.js +24 -24
  27. package/dist/assets/components/ParticleSystems.min.js +1 -1
  28. package/dist/assets/components/Picking.js +18 -18
  29. package/dist/assets/components/Picking.min.js +1 -1
  30. package/dist/assets/components/RigidBodyPhysics.js +18 -18
  31. package/dist/assets/components/RigidBodyPhysics.min.js +1 -1
  32. package/dist/assets/components/Scripting.js +37 -37
  33. package/dist/assets/components/Scripting.min.js +1 -1
  34. package/dist/assets/components/Text.js +24 -24
  35. package/dist/assets/components/Text.min.js +1 -1
  36. package/dist/assets/components/TextureProjector.js +14 -14
  37. package/dist/assets/components/TextureProjector.min.js +1 -1
  38. package/dist/assets/components/Texturing3D.js +30 -30
  39. package/dist/assets/components/Texturing3D.min.js +1 -1
  40. package/dist/assets/components/VolumeRendering.js +18 -18
  41. package/dist/assets/components/VolumeRendering.min.js +1 -1
  42. package/dist/assets/components/X_ITE.js +9 -9
  43. package/dist/assets/components/X_ITE.min.js +1 -1
  44. package/dist/x_ite.css +1 -1
  45. package/dist/x_ite.js +1320 -166
  46. package/dist/x_ite.min.js +1 -1
  47. package/dist/x_ite.zip +0 -0
  48. package/docs/_config.yml +2 -2
  49. package/docs/_posts/components/CADGeometry/CADAssembly.md +45 -19
  50. package/docs/_posts/components/CADGeometry/CADFace.md +44 -18
  51. package/docs/_posts/components/CADGeometry/CADLayer.md +48 -19
  52. package/docs/_posts/components/CADGeometry/CADPart.md +54 -24
  53. package/docs/_posts/components/CADGeometry/IndexedQuadSet.md +55 -26
  54. package/docs/_posts/components/CADGeometry/QuadSet.md +52 -20
  55. package/docs/_posts/components/Core/MetadataBoolean.md +29 -18
  56. package/docs/_posts/components/Core/MetadataDouble.md +31 -16
  57. package/docs/_posts/components/Core/MetadataFloat.md +31 -16
  58. package/docs/_posts/components/Core/MetadataInteger.md +31 -16
  59. package/docs/_posts/components/Core/MetadataSet.md +30 -15
  60. package/docs/_posts/components/Core/MetadataString.md +31 -16
  61. package/docs/_posts/components/Core/WorldInfo.md +21 -10
  62. package/docs/_posts/components/CubeMapTexturing/ComposedCubeMapTexture.md +30 -25
  63. package/docs/_posts/components/CubeMapTexturing/GeneratedCubeMapTexture.md +19 -10
  64. package/docs/_posts/components/CubeMapTexturing/ImageCubeMapTexture.md +22 -18
  65. package/docs/_posts/components/DIS/DISEntityManager.md +40 -15
  66. package/docs/_posts/components/DIS/DISEntityTypeMapping.md +34 -25
  67. package/docs/_posts/components/DIS/EspduTransform.md +174 -41
  68. package/docs/_posts/components/DIS/ReceiverPdu.md +77 -27
  69. package/docs/_posts/components/DIS/SignalPdu.md +82 -28
  70. package/docs/_posts/components/DIS/TransmitterPdu.md +86 -36
  71. package/docs/_posts/components/EnvironmentalEffects/Background.md +80 -39
  72. package/docs/_posts/components/EnvironmentalEffects/Fog.md +39 -18
  73. package/docs/_posts/components/EnvironmentalEffects/FogCoordinate.md +10 -6
  74. package/docs/_posts/components/EnvironmentalEffects/LocalFog.md +21 -14
  75. package/docs/_posts/components/EnvironmentalEffects/TextureBackground.md +83 -31
  76. package/docs/_posts/components/EnvironmentalSensor/ProximitySensor.md +36 -8
  77. package/docs/_posts/components/EnvironmentalSensor/TransformSensor.md +31 -7
  78. package/docs/_posts/components/EnvironmentalSensor/VisibilitySensor.md +23 -7
  79. package/docs/_posts/components/EventUtilities/BooleanFilter.md +23 -10
  80. package/docs/_posts/components/EventUtilities/BooleanSequencer.md +46 -17
  81. package/docs/_posts/components/EventUtilities/BooleanToggle.md +29 -8
  82. package/docs/_posts/components/EventUtilities/BooleanTrigger.md +24 -7
  83. package/docs/_posts/components/EventUtilities/IntegerSequencer.md +46 -17
  84. package/docs/_posts/components/EventUtilities/IntegerTrigger.md +34 -9
  85. package/docs/_posts/components/EventUtilities/TimeTrigger.md +30 -9
  86. package/docs/_posts/components/Followers/ColorChaser.md +35 -11
  87. package/docs/_posts/components/Followers/ColorDamper.md +32 -12
  88. package/docs/_posts/components/Followers/CoordinateChaser.md +33 -9
  89. package/docs/_posts/components/Followers/CoordinateDamper.md +30 -10
  90. package/docs/_posts/components/Followers/OrientationChaser.md +34 -10
  91. package/docs/_posts/components/Followers/OrientationDamper.md +31 -11
  92. package/docs/_posts/components/Followers/PositionChaser.md +33 -9
  93. package/docs/_posts/components/Followers/PositionChaser2D.md +33 -9
  94. package/docs/_posts/components/Followers/PositionDamper.md +30 -10
  95. package/docs/_posts/components/Followers/PositionDamper2D.md +30 -10
  96. package/docs/_posts/components/Followers/ScalarChaser.md +33 -9
  97. package/docs/_posts/components/Followers/ScalarDamper.md +30 -10
  98. package/docs/_posts/components/Followers/TexCoordChaser2D.md +33 -9
  99. package/docs/_posts/components/Followers/TexCoordDamper2D.md +30 -10
  100. package/docs/_posts/components/Geometry2D/Arc2D.md +39 -14
  101. package/docs/_posts/components/Geometry2D/ArcClose2D.md +43 -19
  102. package/docs/_posts/components/Geometry2D/Circle2D.md +21 -10
  103. package/docs/_posts/components/Geometry2D/Disk2D.md +32 -14
  104. package/docs/_posts/components/Geometry2D/Polyline2D.md +24 -9
  105. package/docs/_posts/components/Geometry2D/Polypoint2D.md +16 -8
  106. package/docs/_posts/components/Geometry2D/Rectangle2D.md +23 -12
  107. package/docs/_posts/components/Geometry2D/TriangleSet2D.md +23 -12
  108. package/docs/_posts/components/Geometry3D/Box.md +26 -13
  109. package/docs/_posts/components/Geometry3D/Cone.md +30 -22
  110. package/docs/_posts/components/Geometry3D/Cylinder.md +30 -26
  111. package/docs/_posts/components/Geometry3D/ElevationGrid.md +73 -29
  112. package/docs/_posts/components/Geometry3D/Extrusion.md +100 -48
  113. package/docs/_posts/components/Geometry3D/IndexedFaceSet.md +92 -38
  114. package/docs/_posts/components/Geometry3D/Sphere.md +25 -13
  115. package/docs/_posts/components/Geospatial/GeoCoordinate.md +30 -14
  116. package/docs/_posts/components/Geospatial/GeoElevationGrid.md +82 -37
  117. package/docs/_posts/components/Geospatial/GeoLOD.md +66 -27
  118. package/docs/_posts/components/Geospatial/GeoLocation.md +64 -26
  119. package/docs/_posts/components/Geospatial/GeoMetadata.md +28 -22
  120. package/docs/_posts/components/Geospatial/GeoOrigin.md +34 -19
  121. package/docs/_posts/components/Geospatial/GeoPositionInterpolator.md +64 -18
  122. package/docs/_posts/components/Geospatial/GeoProximitySensor.md +67 -18
  123. package/docs/_posts/components/Geospatial/GeoTouchSensor.md +63 -18
  124. package/docs/_posts/components/Geospatial/GeoTransform.md +72 -28
  125. package/docs/_posts/components/Geospatial/GeoViewpoint.md +79 -40
  126. package/docs/_posts/components/Grouping/Group.md +32 -16
  127. package/docs/_posts/components/Grouping/StaticGroup.md +37 -16
  128. package/docs/_posts/components/Grouping/Switch.md +39 -20
  129. package/docs/_posts/components/Grouping/Transform.md +45 -28
  130. package/docs/_posts/components/HAnim/HAnimDisplacer.md +38 -27
  131. package/docs/_posts/components/HAnim/HAnimHumanoid.md +215 -56
  132. package/docs/_posts/components/HAnim/HAnimJoint.md +104 -38
  133. package/docs/_posts/components/HAnim/HAnimMotion.md +120 -10
  134. package/docs/_posts/components/HAnim/HAnimSegment.md +72 -32
  135. package/docs/_posts/components/HAnim/HAnimSite.md +75 -32
  136. package/docs/_posts/components/Interpolation/ColorInterpolator.md +41 -11
  137. package/docs/_posts/components/Interpolation/CoordinateInterpolator.md +39 -13
  138. package/docs/_posts/components/Interpolation/CoordinateInterpolator2D.md +43 -14
  139. package/docs/_posts/components/Interpolation/EaseInEaseOut.md +36 -12
  140. package/docs/_posts/components/Interpolation/NormalInterpolator.md +40 -10
  141. package/docs/_posts/components/Interpolation/OrientationInterpolator.md +40 -10
  142. package/docs/_posts/components/Interpolation/PositionInterpolator.md +40 -10
  143. package/docs/_posts/components/Interpolation/PositionInterpolator2D.md +43 -14
  144. package/docs/_posts/components/Interpolation/ScalarInterpolator.md +39 -13
  145. package/docs/_posts/components/Interpolation/SplinePositionInterpolator.md +41 -16
  146. package/docs/_posts/components/Interpolation/SplinePositionInterpolator2D.md +41 -16
  147. package/docs/_posts/components/Interpolation/SplineScalarInterpolator.md +40 -24
  148. package/docs/_posts/components/Interpolation/SquadOrientationInterpolator.md +35 -11
  149. package/docs/_posts/components/KeyDeviceSensor/KeySensor.md +51 -9
  150. package/docs/_posts/components/KeyDeviceSensor/StringSensor.md +31 -9
  151. package/docs/_posts/components/Layering/Layer.md +27 -14
  152. package/docs/_posts/components/Layering/LayerSet.md +19 -13
  153. package/docs/_posts/components/Layering/Viewport.md +31 -15
  154. package/docs/_posts/components/Layout/Layout.md +27 -16
  155. package/docs/_posts/components/Layout/LayoutGroup.md +34 -18
  156. package/docs/_posts/components/Layout/LayoutLayer.md +28 -15
  157. package/docs/_posts/components/Layout/ScreenFontStyle.md +72 -45
  158. package/docs/_posts/components/Layout/ScreenGroup.md +32 -16
  159. package/docs/_posts/components/Lighting/DirectionalLight.md +19 -11
  160. package/docs/_posts/components/Lighting/EnvironmentLight.md +2 -6
  161. package/docs/_posts/components/Lighting/PointLight.md +23 -11
  162. package/docs/_posts/components/Lighting/SpotLight.md +32 -19
  163. package/docs/_posts/components/NURBS/Contour2D.md +17 -9
  164. package/docs/_posts/components/NURBS/ContourPolyline2D.md +10 -6
  165. package/docs/_posts/components/NURBS/CoordinateDouble.md +13 -9
  166. package/docs/_posts/components/NURBS/NurbsCurve.md +15 -11
  167. package/docs/_posts/components/NURBS/NurbsCurve2D.md +14 -10
  168. package/docs/_posts/components/NURBS/NurbsOrientationInterpolator.md +28 -12
  169. package/docs/_posts/components/NURBS/NurbsPatchSurface.md +19 -13
  170. package/docs/_posts/components/NURBS/NurbsPositionInterpolator.md +27 -11
  171. package/docs/_posts/components/NURBS/NurbsSet.md +48 -14
  172. package/docs/_posts/components/NURBS/NurbsSurfaceInterpolator.md +31 -11
  173. package/docs/_posts/components/NURBS/NurbsSweptSurface.md +31 -14
  174. package/docs/_posts/components/NURBS/NurbsSwungSurface.md +25 -14
  175. package/docs/_posts/components/NURBS/NurbsTextureCoordinate.md +11 -7
  176. package/docs/_posts/components/NURBS/NurbsTrimmedSurface.md +26 -16
  177. package/docs/_posts/components/Navigation/Billboard.md +33 -17
  178. package/docs/_posts/components/Navigation/Collision.md +59 -22
  179. package/docs/_posts/components/Navigation/LOD.md +53 -23
  180. package/docs/_posts/components/Navigation/NavigationInfo.md +68 -25
  181. package/docs/_posts/components/Navigation/OrthoViewpoint.md +80 -37
  182. package/docs/_posts/components/Navigation/Viewpoint.md +86 -39
  183. package/docs/_posts/components/Navigation/ViewpointGroup.md +28 -17
  184. package/docs/_posts/components/Networking/Anchor.md +54 -56
  185. package/docs/_posts/components/Networking/Inline.md +42 -29
  186. package/docs/_posts/components/Networking/LoadSensor.md +41 -9
  187. package/docs/_posts/components/ParticleSystems/BoundedPhysicsModel.md +16 -8
  188. package/docs/_posts/components/ParticleSystems/ConeEmitter.md +25 -10
  189. package/docs/_posts/components/ParticleSystems/ExplosionEmitter.md +18 -11
  190. package/docs/_posts/components/ParticleSystems/ForcePhysicsModel.md +15 -8
  191. package/docs/_posts/components/ParticleSystems/ParticleSystem.md +92 -46
  192. package/docs/_posts/components/ParticleSystems/PointEmitter.md +19 -12
  193. package/docs/_posts/components/ParticleSystems/PolylineEmitter.md +23 -15
  194. package/docs/_posts/components/ParticleSystems/SurfaceEmitter.md +21 -14
  195. package/docs/_posts/components/ParticleSystems/VolumeEmitter.md +25 -18
  196. package/docs/_posts/components/ParticleSystems/WindPhysicsModel.md +11 -7
  197. package/docs/_posts/components/Picking/LinePickSensor.md +37 -15
  198. package/docs/_posts/components/Picking/PickableGroup.md +40 -22
  199. package/docs/_posts/components/Picking/PointPickSensor.md +29 -12
  200. package/docs/_posts/components/Picking/PrimitivePickSensor.md +25 -17
  201. package/docs/_posts/components/Picking/VolumePickSensor.md +25 -12
  202. package/docs/_posts/components/PointingDeviceSensor/CylinderSensor.md +43 -18
  203. package/docs/_posts/components/PointingDeviceSensor/PlaneSensor.md +40 -17
  204. package/docs/_posts/components/PointingDeviceSensor/SphereSensor.md +35 -13
  205. package/docs/_posts/components/PointingDeviceSensor/TouchSensor.md +48 -14
  206. package/docs/_posts/components/Rendering/ClipPlane.md +20 -15
  207. package/docs/_posts/components/Rendering/Color.md +14 -14
  208. package/docs/_posts/components/Rendering/ColorRGBA.md +13 -9
  209. package/docs/_posts/components/Rendering/Coordinate.md +11 -7
  210. package/docs/_posts/components/Rendering/IndexedLineSet.md +58 -24
  211. package/docs/_posts/components/Rendering/IndexedTriangleFanSet.md +44 -23
  212. package/docs/_posts/components/Rendering/IndexedTriangleSet.md +45 -24
  213. package/docs/_posts/components/Rendering/IndexedTriangleStripSet.md +45 -20
  214. package/docs/_posts/components/Rendering/LineSet.md +26 -14
  215. package/docs/_posts/components/Rendering/Normal.md +28 -6
  216. package/docs/_posts/components/Rendering/PointSet.md +24 -11
  217. package/docs/_posts/components/Rendering/TriangleFanSet.md +44 -19
  218. package/docs/_posts/components/Rendering/TriangleSet.md +44 -19
  219. package/docs/_posts/components/Rendering/TriangleStripSet.md +45 -20
  220. package/docs/_posts/components/RigidBodyPhysics/BallJoint.md +22 -10
  221. package/docs/_posts/components/RigidBodyPhysics/CollidableOffset.md +37 -14
  222. package/docs/_posts/components/RigidBodyPhysics/CollidableShape.md +34 -16
  223. package/docs/_posts/components/RigidBodyPhysics/CollisionCollection.md +17 -12
  224. package/docs/_posts/components/RigidBodyPhysics/CollisionSensor.md +21 -12
  225. package/docs/_posts/components/RigidBodyPhysics/CollisionSpace.md +31 -12
  226. package/docs/_posts/components/RigidBodyPhysics/Contact.md +19 -15
  227. package/docs/_posts/components/RigidBodyPhysics/DoubleAxisHingeJoint.md +33 -27
  228. package/docs/_posts/components/RigidBodyPhysics/MotorJoint.md +63 -11
  229. package/docs/_posts/components/RigidBodyPhysics/RigidBody.md +22 -12
  230. package/docs/_posts/components/RigidBodyPhysics/RigidBodyCollection.md +30 -14
  231. package/docs/_posts/components/RigidBodyPhysics/SingleAxisHingeJoint.md +26 -14
  232. package/docs/_posts/components/RigidBodyPhysics/SliderJoint.md +24 -12
  233. package/docs/_posts/components/RigidBodyPhysics/UniversalJoint.md +23 -15
  234. package/docs/_posts/components/Scripting/Script.md +43 -27
  235. package/docs/_posts/components/Shaders/ComposedShader.md +30 -17
  236. package/docs/_posts/components/Shaders/FloatVertexAttribute.md +18 -9
  237. package/docs/_posts/components/Shaders/Matrix3VertexAttribute.md +17 -8
  238. package/docs/_posts/components/Shaders/Matrix4VertexAttribute.md +17 -8
  239. package/docs/_posts/components/Shaders/PackagedShader.md +36 -30
  240. package/docs/_posts/components/Shaders/ProgramShader.md +35 -15
  241. package/docs/_posts/components/Shaders/ShaderPart.md +27 -18
  242. package/docs/_posts/components/Shaders/ShaderProgram.md +28 -17
  243. package/docs/_posts/components/Shape/AcousticProperties.md +34 -6
  244. package/docs/_posts/components/Shape/Appearance.md +29 -22
  245. package/docs/_posts/components/Shape/FillProperties.md +19 -12
  246. package/docs/_posts/components/Shape/LineProperties.md +18 -10
  247. package/docs/_posts/components/Shape/Material.md +64 -38
  248. package/docs/_posts/components/Shape/PhysicalMaterial.md +49 -25
  249. package/docs/_posts/components/Shape/PointProperties.md +21 -14
  250. package/docs/_posts/components/Shape/Shape.md +35 -17
  251. package/docs/_posts/components/Shape/TwoSidedMaterial.md +35 -36
  252. package/docs/_posts/components/Shape/UnlitMaterial.md +29 -17
  253. package/docs/_posts/components/Sound/Analyser.md +133 -4
  254. package/docs/_posts/components/Sound/AudioClip.md +64 -30
  255. package/docs/_posts/components/Sound/AudioDestination.md +76 -4
  256. package/docs/_posts/components/Sound/BiquadFilter.md +143 -4
  257. package/docs/_posts/components/Sound/BufferAudioSource.md +165 -13
  258. package/docs/_posts/components/Sound/ChannelMerger.md +62 -4
  259. package/docs/_posts/components/Sound/ChannelSelector.md +64 -4
  260. package/docs/_posts/components/Sound/ChannelSplitter.md +68 -4
  261. package/docs/_posts/components/Sound/Convolver.md +124 -4
  262. package/docs/_posts/components/Sound/Delay.md +119 -4
  263. package/docs/_posts/components/Sound/DynamicsCompressor.md +127 -4
  264. package/docs/_posts/components/Sound/Gain.md +115 -4
  265. package/docs/_posts/components/Sound/ListenerPointSource.md +109 -4
  266. package/docs/_posts/components/Sound/MicrophoneSource.md +91 -4
  267. package/docs/_posts/components/Sound/OscillatorSource.md +95 -4
  268. package/docs/_posts/components/Sound/PeriodicWave.md +43 -5
  269. package/docs/_posts/components/Sound/Sound.md +53 -20
  270. package/docs/_posts/components/Sound/SpatialSound.md +120 -4
  271. package/docs/_posts/components/Sound/StreamAudioDestination.md +80 -4
  272. package/docs/_posts/components/Sound/StreamAudioSource.md +91 -4
  273. package/docs/_posts/components/Sound/WaveShaper.md +123 -4
  274. package/docs/_posts/components/Text/FontStyle.md +73 -47
  275. package/docs/_posts/components/Text/Text.md +48 -26
  276. package/docs/_posts/components/TextureProjector/TextureProjector.md +55 -6
  277. package/docs/_posts/components/TextureProjector/TextureProjectorParallel.md +56 -6
  278. package/docs/_posts/components/Texturing/ImageTexture.md +28 -20
  279. package/docs/_posts/components/Texturing/MovieTexture.md +69 -38
  280. package/docs/_posts/components/Texturing/MultiTexture.md +47 -19
  281. package/docs/_posts/components/Texturing/MultiTextureCoordinate.md +27 -10
  282. package/docs/_posts/components/Texturing/MultiTextureTransform.md +32 -10
  283. package/docs/_posts/components/Texturing/PixelTexture.md +34 -14
  284. package/docs/_posts/components/Texturing/TextureCoordinate.md +20 -10
  285. package/docs/_posts/components/Texturing/TextureCoordinateGenerator.md +22 -12
  286. package/docs/_posts/components/Texturing/TextureProperties.md +44 -19
  287. package/docs/_posts/components/Texturing/TextureTransform.md +17 -8
  288. package/docs/_posts/components/Texturing3D/ComposedTexture3D.md +21 -13
  289. package/docs/_posts/components/Texturing3D/ImageTexture3D.md +32 -23
  290. package/docs/_posts/components/Texturing3D/ImageTextureAtlas.md +22 -16
  291. package/docs/_posts/components/Texturing3D/PixelTexture3D.md +25 -13
  292. package/docs/_posts/components/Texturing3D/TextureCoordinate3D.md +22 -10
  293. package/docs/_posts/components/Texturing3D/TextureCoordinate4D.md +21 -9
  294. package/docs/_posts/components/Texturing3D/TextureTransform3D.md +17 -8
  295. package/docs/_posts/components/Texturing3D/TextureTransformMatrix3D.md +20 -10
  296. package/docs/_posts/components/Time/TimeSensor.md +66 -23
  297. package/docs/_posts/components/VolumeRendering/BlendedVolumeStyle.md +36 -15
  298. package/docs/_posts/components/VolumeRendering/BoundaryEnhancementVolumeStyle.md +15 -5
  299. package/docs/_posts/components/VolumeRendering/CartoonVolumeStyle.md +20 -17
  300. package/docs/_posts/components/VolumeRendering/ComposedVolumeStyle.md +15 -7
  301. package/docs/_posts/components/VolumeRendering/EdgeEnhancementVolumeStyle.md +16 -8
  302. package/docs/_posts/components/VolumeRendering/IsoSurfaceVolumeData.md +43 -21
  303. package/docs/_posts/components/VolumeRendering/OpacityMapVolumeStyle.md +16 -8
  304. package/docs/_posts/components/VolumeRendering/ProjectionVolumeStyle.md +17 -7
  305. package/docs/_posts/components/VolumeRendering/SegmentedVolumeData.md +50 -17
  306. package/docs/_posts/components/VolumeRendering/ShadedVolumeStyle.md +18 -10
  307. package/docs/_posts/components/VolumeRendering/SilhouetteEnhancementVolumeStyle.md +16 -8
  308. package/docs/_posts/components/VolumeRendering/ToneMappedVolumeStyle.md +20 -11
  309. package/docs/_posts/components/VolumeRendering/VolumeData.md +32 -15
  310. package/docs/_posts/components/X_ITE/BlendMode.md +9 -2
  311. package/docs/_posts/getting-started.md +4 -7
  312. package/docs/_posts/laboratory/x3d-file-converter.md +1 -1
  313. package/docs/laboratory/gltf-sample-viewer.html +52 -4
  314. package/package.json +2 -1
  315. package/src/standard/Math/Geometry/Box2.js +12 -2
  316. package/src/standard/Math/Geometry/Box3.js +12 -2
  317. package/src/x_ite/Base/X3DObjectArrayField.js +3 -2
  318. package/src/x_ite/Base/X3DTypedArrayField.js +3 -2
  319. package/src/x_ite/Browser/Core/X3DCoreContext.js +10 -3
  320. package/src/x_ite/Browser/DOMIntegration.js +13 -8
  321. package/src/x_ite/Browser/VERSION.js +1 -1
  322. package/src/x_ite/Components/CubeMapTexturing/ComposedCubeMapTexture.js +1 -1
  323. package/src/x_ite/Components/DIS/DISEntityManager.js +1 -1
  324. package/src/x_ite/Components/Grouping/Switch.js +1 -1
  325. package/src/x_ite/Components/HAnim/HAnimHumanoid.js +105 -68
  326. package/src/x_ite/Components/HAnim/HAnimMotion.js +3 -3
  327. package/src/x_ite/Components/Layering/X3DLayerNode.js +1 -1
  328. package/src/x_ite/Components/Lighting/DirectionalLight.js +1 -1
  329. package/src/x_ite/Components/Navigation/Collision.js +1 -1
  330. package/src/x_ite/Components/Navigation/LOD.js +1 -1
  331. package/src/x_ite/Components/Navigation/X3DViewpointNode.js +1 -1
  332. package/src/x_ite/Components/Networking/LoadSensor.js +1 -1
  333. package/src/x_ite/Components/ParticleSystems/ParticleSystem.js +1 -1
  334. package/src/x_ite/Components/Rendering/X3DComposedGeometryNode.js +1 -1
  335. package/src/x_ite/Components/Shape/AcousticProperties.js +1 -1
  336. package/src/x_ite/Components/Shape/Appearance.js +1 -1
  337. package/src/x_ite/Components/Shape/Material.js +1 -1
  338. package/src/x_ite/Components/Shape/TwoSidedMaterial.js +1 -1
  339. package/src/x_ite/Components/Sound/PeriodicWave.js +1 -1
  340. package/src/x_ite/Components/Texturing/TextureProperties.js +1 -1
  341. package/src/x_ite/Fields/ArrayFields.js +9 -7
  342. package/src/x_ite/Fields/SFColor.js +1 -1
  343. package/src/x_ite/Fields/SFMatrixPrototypeTemplate.js +1 -1
  344. package/src/x_ite/Fields/SFRotation.js +3 -3
  345. package/src/x_ite/Fields/SFVecPrototypeTemplate.js +1 -1
  346. package/src/x_ite/Parser/GLTF2Parser.js +316 -55
  347. package/src/x_ite/Parser/GoldenGate.js +16 -5
  348. package/src/x_ite/Parser/PLYAParser.js +615 -0
  349. package/src/x_ite/Parser/PLYBParser.js +222 -0
  350. package/src/x_ite/Parser/STLAParser.js +0 -1
  351. package/src/x_ite/Parser/SVGParser.js +1 -1
  352. /package/build/{bin → docs}/components.js +0 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Sound
3
- date: 2022-01-07
3
+ date: 2023-01-07
4
4
  nav: components-Sound
5
5
  categories: [components, Sound]
6
6
  tags: [Sound, Sound]
@@ -15,7 +15,7 @@ tags: [Sound, Sound]
15
15
 
16
16
  The Sound node controls the 3D spatialization of sound playback by a child AudioClip or MovieTexture node. Sound intensity includes stereo support, varying according to user location and view direction in the scene.
17
17
 
18
- The Sound node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 2.0 or later.
18
+ The Sound node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
19
19
 
20
20
  ## Hierarchy
21
21
 
@@ -30,15 +30,20 @@ The Sound node belongs to the **Sound** component and its default container fiel
30
30
 
31
31
  ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
32
32
 
33
- Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
33
+ Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
34
+
35
+ #### Hint
36
+
37
+ - [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
34
38
 
35
39
  ### SFString [in, out] **description** ""
36
40
 
37
- Author-provided prose that describes intended purpose of the url asset.
41
+ Author-provided prose that describes intended purpose of this node.
38
42
 
39
- #### Hint
43
+ #### Hints
40
44
 
41
- - Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
45
+ - Include space characters since a *description* is not a DEF identifier. Write short phrases that make descriptions clear and readable.
46
+ - Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
42
47
 
43
48
  ### SFBool [in, out] **enabled** TRUE
44
49
 
@@ -46,11 +51,11 @@ Enables/disables node operation.
46
51
 
47
52
  ### SFBool [ ] **spatialize** TRUE
48
53
 
49
- Whether to spatialize sound playback relative to viewer.
54
+ Whether to *spatialize* sound playback relative to viewer.
50
55
 
51
56
  #### Hint
52
57
 
53
- - Only effective between minimum and maximum ellipsoids.
58
+ - Only effective within the auralization volume.
54
59
 
55
60
  ### SFFloat [in, out] **intensity** 1 <small>[0,1]</small>
56
61
 
@@ -58,7 +63,11 @@ Factor [0,1] adjusting loudness (decibels) of emitted sound.
58
63
 
59
64
  ### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
60
65
 
61
- Position of sound center, relative to local coordinate system.
66
+ Position of sound ellipsoid center, relative to local coordinate system.
67
+
68
+ #### Hint
69
+
70
+ - Improve audibility by setting *location*='0 1.6 0' so that center height of sound ellipsoid matches typical NavigationInfo avatarSize height.
62
71
 
63
72
  ### SFVec3f [in, out] **direction** 0 0 1 <small>(-∞,∞)</small>
64
73
 
@@ -66,19 +75,35 @@ Position of sound center, relative to local coordinate system.
66
75
 
67
76
  ### SFFloat [in, out] **minBack** 1 <small>[0,∞)</small>
68
77
 
69
- Inner (full volume) ellipsoid distance along back direction. Ensure minBack \<= maxBack.
78
+ Inner (full loudness) ellipsoid distance along back direction.
79
+
80
+ #### Warning
81
+
82
+ - Ensure *minBack* \<= maxBack.
70
83
 
71
84
  ### SFFloat [in, out] **minFront** 1 <small>[0,∞)</small>
72
85
 
73
- Inner (full volume) ellipsoid distance along front direction. Ensure minFront \<= maxFront.
86
+ Inner (full loudness) ellipsoid distance along front direction.
87
+
88
+ #### Warning
89
+
90
+ - Ensure *minFront* \<= maxFront.
74
91
 
75
92
  ### SFFloat [in, out] **maxBack** 10 <small>[0,∞)</small>
76
93
 
77
- Outer (zero volume) ellipsoid distance along back direction. Ensure minBack \<= maxBack.
94
+ Outer (zero loudness)ellipsoid distance along back direction.
95
+
96
+ #### Warning
97
+
98
+ - Ensure minBack \<= *maxBack*.
78
99
 
79
100
  ### SFFloat [in, out] **maxFront** 10 <small>[0,∞)</small>
80
101
 
81
- Outer (zero volume) ellipsoid distance along front direction. Ensure minFront \<= maxFront.
102
+ Outer (zero loudness)ellipsoid distance along front direction.
103
+
104
+ #### Warning
105
+
106
+ - Ensure minFront \<= *maxFront*.
82
107
 
83
108
  ### SFFloat [in, out] **priority** 0 <small>[0,1]</small>
84
109
 
@@ -86,21 +111,29 @@ Player hint [0,1] if needed to choose which sounds to play.
86
111
 
87
112
  ### SFNode [in, out] **source** NULL <small>[X3DSoundSourceNode]</small>
88
113
 
89
- Input/Output field source.
114
+ Sound *source* for the Sound node, either an AudioClip node or a MovieTexture node.
115
+
116
+ #### Warning
117
+
118
+ - If *source* field is not specified, the Sound node does not emit audio.
90
119
 
91
120
  ### MFNode [in, out] **children** [ ] <small>[X3DSoundChannelNode,X3DSoundProcessingNode,X3DSoundSourceNode]</small>
92
121
 
93
- ## Description
122
+ Input/Output field *children*.
123
+
124
+ ## Advisories
94
125
 
95
- ### Hint
126
+ ### Hints
96
127
 
97
128
  - If the audio source is stereo or multi-channel, channel separation is retained during playback.
129
+ - [X3D Sound component Figure 16.2 Sound Node Geometry](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/sound.html#f-Soundnodegeometry){:target="_blank"}
130
+ - [X3D Scene Authoring Hints:Audio](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Audio){:target="_blank"}
131
+ - [Wikipedia 3D sound localization](https://en.wikipedia.org/wiki/3D_sound_localization){:target="_blank"}
98
132
 
99
133
  ### Warning
100
134
 
101
- - While providing sounds on the ground plane, ensure that the audible auralization ellipse is sufficiently elevated to match avatar height.
135
+ - While providing sounds on the ground plane, ensure that the audible auralization volume is sufficiently elevated to match avatar height.
102
136
 
103
- ## External Links
137
+ ## See Also
104
138
 
105
- - [X3D Specification of Sound](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#Sound){:target="_blank"}
106
- - [X3D Scene Authoring Hints:Audio](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Audio){:target="_blank"}
139
+ - [X3D Specification of Sound node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#Sound){:target="_blank"}
@@ -13,9 +13,9 @@ tags: [SpatialSound, Sound]
13
13
 
14
14
  ## Overview
15
15
 
16
- SpatialSound ...
16
+ The SpatialSound node controls the 3D spatialization of sound playback by a child AudioClip or MovieTexture node. Sound intensity includes stereo support, varying according to user location and view direction in the scene.
17
17
 
18
- The SpatialSound node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 4.0 or later.
18
+ The SpatialSound node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
19
19
 
20
20
  ## Hierarchy
21
21
 
@@ -30,42 +30,158 @@ The SpatialSound node belongs to the **Sound** component and its default contain
30
30
 
31
31
  ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
32
32
 
33
+ Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
34
+
35
+ #### Hint
36
+
37
+ - [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
38
+
33
39
  ### SFString [in, out] **description** ""
34
40
 
41
+ Author-provided prose that describes intended purpose of the url asset.
42
+
43
+ #### Hint
44
+
45
+ - Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
46
+
35
47
  ### SFBool [in, out] **enabled** TRUE
36
48
 
49
+ Enables/disables node operation.
50
+
37
51
  ### SFBool [ ] **spatialize** TRUE
38
52
 
53
+ Whether to *spatialize* sound playback relative to viewer.
54
+
55
+ #### Hint
56
+
57
+ - Only effective within the auralization volume.
58
+
39
59
  ### SFFloat [in, out] **coneInnerAngle** 6.2832 <small>[0,2π]</small>
40
60
 
61
+ *coneInnerAngle* is centered along direction and defines the inner conical volume, inside of which no source gain reduction occurs.
62
+
63
+ #### Hints
64
+
65
+ - ConeOuterAngle value is greater than or equal to *coneInnerAngle*.
66
+ - [X3D4 Architecture Figure 16.3, SpatialSound Panning Gain Relationships](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/sound.html#f-AudioPannerListenerRelationships){:target="_blank"}
67
+
41
68
  ### SFFloat [in, out] **coneOuterAngle** 6.2832 <small>[0,2π]</small>
42
69
 
70
+ *coneOuterAngle* is centered along direction and defines an outer conical volume, within which the sound gain decreases linearly from full gain to coneOuterGain. Outside of *coneOuterAngle*, gain equals coneOuterGain.
71
+
72
+ #### Hints
73
+
74
+ - *coneOuterAngle* value is greater than or equal to coneInnerAngle.
75
+ - [X3D4 Architecture Figure 16.3, SpatialSound Panning Gain Relationships](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/sound.html#f-AudioPannerListenerRelationships){:target="_blank"}
76
+
43
77
  ### SFFloat [in, out] **coneOuterGain** 0 <small>(-∞,∞)</small>
44
78
 
79
+ *coneOuterGain* is minimum gain value found outside coneOuterAngle.
80
+
45
81
  ### SFVec3f [in, out] **direction** 0 0 1 <small>(-∞,∞)</small>
46
82
 
83
+ *direction* of sound axis, relative to local coordinate system.
84
+
47
85
  ### SFString [in, out] **distanceModel** "INVERSE" <small>["LINEAR" "INVERSE" "EXPONENTIAL"]</small>
48
86
 
87
+ *distanceModel* determines how field specifies which algorithm to use for sound attenuation, corresponding to distance between an audio source and a listener, as it moves away from the listener.
88
+
89
+ #### Hint
90
+
91
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#enumdef-distancemodeltype){:target="_blank"}
92
+
49
93
  ### SFBool [in, out] **dopplerEnabled** FALSE
50
94
 
95
+ *dopplerEnabled* enables/disables whether real-time Doppler effects (due to relation motion between sources and listeners) are computed by browser between virtual sound sources and active listening locations, then applied to received frequency at active listening locations.
96
+
97
+ #### Hints
98
+
99
+ - Functional support requires player support for Sound component level 3.
100
+ - [Wikipedia Doppler effect](https://en.wikipedia.org/wiki/Doppler_effect){:target="_blank"}
101
+
51
102
  ### SFBool [in, out] **enableHRTF** FALSE
52
103
 
104
+ *enableHRTF* enables/disables Head Related Transfer Function (HRTF) auralization, if available. SpatialSound enabledHRTF=true corresponds to panningModelType HRTF, enabledHRTF=false corresponds to panningModelType equalpower.
105
+
106
+ #### Hints
107
+
108
+ - [W3C Audio API](https://www.w3.org/TR/webaudio/#enumdef-panningmodeltype){:target="_blank"}
109
+ - [Wikipedia HRTF](https://en.wikipedia.org/wiki/3D_sound_localization#Head-related_Transfer_Function_(HRTF)){:target="_blank"}
110
+
53
111
  ### SFFloat [in, out] **gain** 1 <small>(-∞,∞)</small>
54
112
 
113
+ The *gain* field is a factor that represents the amount of linear amplification to apply to the output of the node.
114
+
115
+ #### Hint
116
+
117
+ - Negative *gain* factors negate the input signal.
118
+
119
+ #### Warning
120
+
121
+ - Decibel values shall not be used.
122
+
55
123
  ### SFFloat [in, out] **intensity** 1 <small>[0,1]</small>
56
124
 
125
+ Factor [0,1] adjusting loudness (decibels) of emitted sound.
126
+
57
127
  ### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
58
128
 
129
+ Position of sound ellipsoid center, relative to local coordinate system.
130
+
131
+ #### Hint
132
+
133
+ - Improve audibility by setting *location*='0 1.6 0' so that center height of sound ellipsoid matches typical NavigationInfo avatarSize height.
134
+
59
135
  ### SFFloat [in, out] **maxDistance** 10000 <small>[0,∞)</small>
60
136
 
137
+ *maxDistance* is the maximum distance where sound is renderable between source and listener, after which no reduction in sound volume occurs.
138
+
61
139
  ### SFFloat [in, out] **priority** 0 <small>[0,1]</small>
62
140
 
141
+ Player hint [0,1] if needed to choose which sounds to play.
142
+
63
143
  ### SFFloat [in, out] **referenceDistance** 1 <small>[0,∞)</small>
64
144
 
145
+ *referenceDistance* for reducing volume as source moves further from the listener. For distances less than this value, volume is not reduced.
146
+
147
+ #### Hint
148
+
149
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-pannernode-refdistance){:target="_blank"}
150
+
65
151
  ### SFFloat [in, out] **rolloffFactor** 1 <small>[0,∞)</small>
66
152
 
153
+ *rolloffFactor* indicates how quickly volume is reduced as source moves further from listener.
154
+
155
+ #### Hint
156
+
157
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-pannernode-rollofffactor){:target="_blank"}
158
+
67
159
  ### MFNode [in, out] **children** [ ] <small>[X3DSoundChannelNode,X3DSoundProcessingNode,X3DSoundSourceNode]</small>
68
160
 
69
- ## External Links
161
+ The *children* field specifies audio-graph sound sources providing input signals for this node. If multiple input signals are provided by the inputs *children* field, all channels are mixed together and merged prior to presentation.
162
+
163
+ #### Hint
164
+
165
+ - Can be original (DEF) or referenced (USE) nodes.
166
+
167
+ #### Warning
168
+
169
+ - Contained AudioClip or MovieTexture nodes must have `containerField='children'` to override otherwise-incorrect defaults.
170
+
171
+ ## Advisories
172
+
173
+ ### Hints
174
+
175
+ - If the audio source is stereo or multi-channel, channel separation is retained during playback.
176
+ - [X3D Sound component Figure 16.2 Sound Node Geometry](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/sound.html#f-Soundnodegeometry){:target="_blank"}
177
+ - [W3C Web Audio API, PannerNode Interface](https://www.w3.org/TR/webaudio/#pannernode){:target="_blank"}
178
+ - [X3D Scene Authoring Hints:Audio](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Audio){:target="_blank"}
179
+ - [Wikipedia 3D sound localization](https://en.wikipedia.org/wiki/3D_sound_localization){:target="_blank"}
180
+
181
+ ### Warning
182
+
183
+ - While providing sounds on the ground plane, ensure that the audible auralization volume is sufficiently elevated to match avatar height.
184
+
185
+ ## See Also
70
186
 
71
- - [X3D Specification of SpatialSound](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#SpatialSound){:target="_blank"}
187
+ - [X3D Specification of SpatialSound node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#SpatialSound){:target="_blank"}
@@ -13,9 +13,9 @@ tags: [StreamAudioDestination, Sound]
13
13
 
14
14
  ## Overview
15
15
 
16
- StreamAudioDestination ...
16
+ StreamAudioDestination node represents the final audio destination via a media stream.
17
17
 
18
- The StreamAudioDestination node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 4.0 or later.
18
+ The StreamAudioDestination node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
19
19
 
20
20
  ## Hierarchy
21
21
 
@@ -31,26 +31,102 @@ The StreamAudioDestination node belongs to the **Sound** component and its defau
31
31
 
32
32
  ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
33
33
 
34
+ Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
35
+
36
+ #### Hint
37
+
38
+ - [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
39
+
34
40
  ### SFString [in, out] **description** ""
35
41
 
42
+ Author-provided prose that describes intended purpose of the url asset.
43
+
44
+ #### Hint
45
+
46
+ - Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
47
+
36
48
  ### SFBool [in, out] **enabled** TRUE
37
49
 
50
+ Enables/disables node operation.
51
+
38
52
  ### SFFloat [in, out] **gain** 1 <small>(-∞,∞)</small>
39
53
 
54
+ The *gain* field is a factor that represents the amount of linear amplification to apply to the output of the node.
55
+
56
+ #### Hint
57
+
58
+ - Negative *gain* factors negate the input signal.
59
+
60
+ #### Warning
61
+
62
+ - Decibel values shall not be used.
63
+
40
64
  ### MFString [in, out] **streamIdentifier** [ ]
41
65
 
66
+ Stream identification TBD
67
+
68
+ #### Hint
69
+
70
+ - [W3C Media Capture and Streams](https://www.w3.org/TR/mediacapture-streams){:target="_blank"}
71
+
42
72
  ### SFInt32 [out] **channelCount**
43
73
 
74
+ *channelCount* reports number of channels provided by input nodes.
75
+
76
+ #### Hint
77
+
78
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelcount){:target="_blank"}
79
+
44
80
  ### SFString [in, out] **channelCountMode** "MAX" <small>["MAX", "CLAMPED-MAX", "EXPLICIT"]</small>
45
81
 
82
+ *channelCountMode* determines how individual channels are counted when up-mixing and down-mixing connections to any inputs.
83
+
84
+ #### Hint
85
+
86
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelcountmode){:target="_blank"}
87
+
46
88
  ### SFString [in, out] **channelInterpretation** "SPEAKERS" <small>["SPEAKERS", "DISCRETE"]</small>
47
89
 
90
+ *channelInterpretation* determines how individual channels are treated when up-mixing and down-mixing connections to any inputs.
91
+
92
+ #### Hint
93
+
94
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelinterpretation){:target="_blank"}
95
+
48
96
  ### SFString [out] **mediaDeviceID**
49
97
 
98
+ *mediaDeviceID* field provides ID parameter functionality. (TODO experimental)
99
+
50
100
  ### SFBool [out] **isActive**
51
101
 
102
+ *isActive* true/false events are sent when playback starts/stops.
103
+
104
+ #### Warning
105
+
106
+ - It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
107
+
52
108
  ### MFNode [in, out] **children** [ ] <small>[X3DSoundChannelNode,X3DSoundProcessingNode,X3DSoundSourceNode]</small>
53
109
 
54
- ## External Links
110
+ The *children* field specifies audio-graph sound sources providing input signals for this node. If multiple input signals are provided by the inputs *children* field, all channels are mixed together and merged prior to presentation.
111
+
112
+ #### Hint
113
+
114
+ - Can be original (DEF) or referenced (USE) nodes.
115
+
116
+ #### Warning
117
+
118
+ - Contained AudioClip or MovieTexture nodes must have `containerField='children'` to override otherwise-incorrect defaults.
119
+
120
+ ## Advisories
121
+
122
+ ### Hint
123
+
124
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#mediastreamaudiodestinationnode){:target="_blank"}
125
+
126
+ ### Warning
127
+
128
+ - Stream-identification parameters are not fully defined and subject to change.
129
+
130
+ ## See Also
55
131
 
56
- - [X3D Specification of StreamAudioDestination](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#StreamAudioDestination){:target="_blank"}
132
+ - [X3D Specification of StreamAudioDestination node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#StreamAudioDestination){:target="_blank"}
@@ -13,9 +13,9 @@ tags: [StreamAudioSource, Sound]
13
13
 
14
14
  ## Overview
15
15
 
16
- StreamAudioSource ...
16
+ StreamAudioSource operates as an audio source whose media is received from a MediaStream obtained using the WebRTC or Media Capture and Streams APIs. This media source might originate from a remote microphone or sound-processing channed provided by a remote peer on a WebRTC call.\.
17
17
 
18
- The StreamAudioSource node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 4.0 or later.
18
+ The StreamAudioSource node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
19
19
 
20
20
  ## Hierarchy
21
21
 
@@ -31,28 +31,115 @@ The StreamAudioSource node belongs to the **Sound** component and its default co
31
31
 
32
32
  ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
33
33
 
34
+ Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
35
+
36
+ #### Hint
37
+
38
+ - [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
39
+
34
40
  ### SFString [in, out] **description** ""
35
41
 
42
+ Author-provided prose that describes intended purpose of the url asset.
43
+
44
+ #### Hint
45
+
46
+ - Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
47
+
36
48
  ### SFBool [in, out] **enabled** TRUE
37
49
 
50
+ Enables/disables node operation.
51
+
38
52
  ### SFFloat [in, out] **gain** 1 <small>(-∞,∞)</small>
39
53
 
54
+ The *gain* field is a factor that represents the amount of linear amplification to apply to the output of the node.
55
+
56
+ #### Hint
57
+
58
+ - Negative *gain* factors negate the input signal.
59
+
60
+ #### Warning
61
+
62
+ - Decibel values shall not be used.
63
+
40
64
  ### MFString [in, out] **streamIdentifier** [ ]
41
65
 
66
+ Stream identification TBD
67
+
68
+ #### Hint
69
+
70
+ - [W3C Media Capture and Streams](https://www.w3.org/TR/mediacapture-streams){:target="_blank"}
71
+
42
72
  ### SFTime [in, out] **startTime** 0 <small>(-∞,∞)</small>
43
73
 
74
+ Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
75
+
76
+ #### Hint
77
+
78
+ - ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
79
+
44
80
  ### SFTime [in, out] **resumeTime** 0 <small>(-∞,∞)</small>
45
81
 
82
+ When *resumeTime* becomes \<= time now, isPaused becomes false and AudioClip becomes active. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
83
+
84
+ #### Hint
85
+
86
+ - ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
87
+
46
88
  ### SFTime [in, out] **pauseTime** 0 <small>(-∞,∞)</small>
47
89
 
90
+ When time now \>= *pauseTime*, isPaused becomes true and AudioClip becomes paused. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
91
+
92
+ #### Hint
93
+
94
+ - ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
95
+
48
96
  ### SFTime [in, out] **stopTime** 0 <small>(-∞,∞)</small>
49
97
 
98
+ Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
99
+
100
+ #### Hint
101
+
102
+ - ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
103
+
104
+ #### Warnings
105
+
106
+ - An active TimeSensor node ignores set_cycleInterval and set_startTime events.
107
+ - An active TimeSensor node ignores set_stopTime event values less than or equal to startTime.
108
+
50
109
  ### SFBool [out] **isPaused**
51
110
 
111
+ *isPaused* true/false events are sent when AudioClip is paused/resumed.
112
+
113
+ #### Warning
114
+
115
+ - It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
116
+
52
117
  ### SFBool [out] **isActive**
53
118
 
119
+ *isActive* true/false events are sent when playback starts/stops.
120
+
121
+ #### Warning
122
+
123
+ - It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
124
+
54
125
  ### SFTime [out] **elapsedTime**
55
126
 
56
- ## External Links
127
+ Current elapsed time since AudioClip activated/running, cumulative in seconds, and not counting any paused time.
128
+
129
+ #### Hint
130
+
131
+ - *elapsedTime* is a nonnegative SFTime duration interval, not an absolute clock time.
132
+
133
+ #### Warning
134
+
135
+ - It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
136
+
137
+ ## Advisories
138
+
139
+ ### Hint
140
+
141
+ - [W3C Web Audio API](https://www.w3.org/TR/webaudio/#mediastreamaudiosourcenode){:target="_blank"}
142
+
143
+ ## See Also
57
144
 
58
- - [X3D Specification of StreamAudioSource](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#StreamAudioSource){:target="_blank"}
145
+ - [X3D Specification of StreamAudioSource node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#StreamAudioSource){:target="_blank"}