#################################################################################################### # # Invoking X3D model self-test: # # $ python Filters.py # # Python package x3d.py package is available on PyPI for import. # This approach simplifies Python X3D deployment and use. # https://pypi.org/project/x3d # # Installation: # pip install x3d # or # python -m pip install x3d # # Developer options for loading x3d package in other Python programs: # # from x3d import * # preferred approach, terser source that avoids x3d.* class prefixes # # or # import x3d # traditional way to subclass x3d package, all classes require x3d.* prefix, # # but python source is very verbose, for example x3d.Material x3d.Shape etc. # # X3dToPython.xslt stylesheet insertPackagePrefix=true supports this option. # # Project home page: # X3D Python Scene Access Interface Library (X3DPSAIL) # # https://www.web3d.org/x3d/stylesheets/python/python.html # Conversion generator: # https://www.web3d.org/x3d/stylesheets/X3dToPython.xslt # #################################################################################################### from x3d import * newModel=X3D(profile='Full',version='4.0', head=head( children=[ meta(content='Filters.x3d',name='title'), meta(content='This X3D scene involves three sound sources. Each of them is visualized by a 3D object (in our case is a sphere) that depicts the sound effects. Specifically, we have added filters through of them we are able to manage the different sound effects in an impressive way. Filters can be composed of a number of attributes, frequency, detune, gain and the quality factor which also known as Q. Furthermore, the filters are classified in some specific types, depending on the sound effects that produce. In detail, there is the Low-pass filter which can create more muffled sound. Another one is the High-pass filter, which is used to generate tinny sound. Equally important is the Band-pass filter, which cuts off low and high frequencies and passes through only these within a certain range. On the contrary, the Notch filter has exactly the opposite operation of the Band-pass filter. Then is the Low-shelf filter, its role is to change the amount of bass in a sound, as a result the frequencies that are lower than the current frequency get a boost, while them that are over it remain unchanged. Next, the High-shelf filter is responsible for the quantity of treble in a sound. Moreover, Peaking filter is used in order to handle the amount of midrange in a sound. Lastly, there is the All-pass filter, whose role is to introduce phaser effects.',name='description'), meta(content='This work presents an innovative solution of the spatial sound in X3DOM framework, that based on a combinational methodology. Specifically, we suggested the enrichment of X3DOM with spatial sound features, using both the X3D sound nodes and the structure of Web Audio API.',name='info'), meta(content='Efi Lakka, Athanasios Malamos, Dick Puk, Don Brutzman',name='creator'), meta(content='28 October 2020',name='created'), meta(content='22 August 2025',name='modified'), meta(content='CHANGELOG.txt',name='reference'), meta(content='credit for audio files',name='TODO'), meta(content='https://www.medialab.hmu.gr/minipages/x3domAudio',name='reference'), meta(content='https://medialab.hmu.gr/minipages/x3domAudio/SpatialSoundFilter.xhtml',name='reference'), meta(content='https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/AudioSpatialSound/Filters.x3d',name='identifier'), meta(content='X3D-Edit 4.0, https://www.web3d.org/x3d/tools/X3D-Edit',name='generator'), meta(content='../license.html',name='license')]), Scene=Scene( children=[ WorldInfo(title='Filters.x3d'), NavigationInfo(id_='NAV'), Background(skyColor=[(0.200,0.200,0.200)]), Viewpoint(description='View entire audio model',orientation=(1,0,0,-0.5),position=(0.0,500.0,600.0),retainUserOffsets=True), Transform(DEF='TransformAudio1',translation=(-200,50,0), children=[ Shape( appearance=Appearance(DEF='audio_emit', material=Material(diffuseColor=(0.1,0.1,0.1),emissiveColor=(0.8,0.8,0.8),specularColor=(0.01,0.01,0.01))), geometry=Sphere(radius=30))]), Transform(DEF='TransformAudio2',translation=(0,50,0), children=[ Shape( appearance=Appearance(DEF='audio_emit2', material=Material(diffuseColor=(0.1,0.1,0.1),emissiveColor=(0.8,0.8,0.8),specularColor=(0.01,0.01,0.01))), geometry=Sphere(radius=30))]), Transform(DEF='TransformAudio3',translation=(200,50,0), children=[ Shape( appearance=Appearance(DEF='audio_emit3', material=Material(diffuseColor=(0.1,0.1,0.1),emissiveColor=(0.8,0.8,0.8),specularColor=(0.01,0.01,0.01))), geometry=Sphere(radius=30))]), Transform(DEF='AnimData',id_='AnimDataPoint',translation=(0,50,0)), Transform(DEF='AnimDataBoxH',translation=(0,100,0)), Transform(DEF='AnimDataBoxM',translation=(15,100,0)), Transform(DEF='AnimDataBoxL',translation=(30,100,0)), Transform(DEF='AnimDataBoxMM',id_='AnimDataBoxMMirror',translation=(-15,100,0)), Transform(DEF='AnimDataBoxLM',id_='AnimDataBoxLMirror',translation=(-30,100,0)), Transform( children=[ Shape( appearance=Appearance(DEF='floor', material=Material(diffuseColor=(0.1,0.1,0.1),shininess=0.8,specularColor=(0.5,0.6,0.7))), geometry=Cylinder(radius=500))]), ListenerPointSource(id_='ListenerPointSource',trackCurrentView=True), StreamAudioDestination(id_='AudioDestination', children=[ DynamicsCompressor(id_='DynamicsCompressor', children=[ Gain(id_='Gain4', children=[ SpatialSound(DEF='Audio1', children=[ Gain(id_='Gain1', children=[ Analyser(id_='Analyser1', children=[ BiquadFilter(detune=50.0,frequency=600,id_='BiquadFilter1',qualityFactor=30.0,type='ALLPASS', children=[ AudioClip(description='Techno beat',enabled=False,id_='AudioClip1',loop=True,url=["sound/techno_beat.mp3","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/AudioSpatialSound/sound/techno_beat.mp3","sound/techno_beat.wav","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/AudioSpatialSound/sound/techno_beat.wav"])])])])]), SpatialSound(DEF='Audio2', children=[ Gain(id_='Gain2', children=[ Analyser(id_='Analyser2', children=[ BiquadFilter(detune=15.0,frequency=600,id_='BiquadFilter2',qualityFactor=15.0,type='ALLPASS', children=[ AudioClip(description='Simple beat',id_='AudioClip2',loop=True,url=["sound/beat.mp3","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/AudioSpatialSound/sound/beat.mp3"])])])])]), SpatialSound(DEF='Audio3', children=[ Gain(id_='Gain3', children=[ Analyser(id_='Analyser3', children=[ BiquadFilter(frequency=1000,id_='BiquadFilter3',qualityFactor=0,type='ALLPASS', children=[ AudioClip(description='Wobble loop',id_='AudioClip3',loop=True,url=["sound/wobble_loop.mp3","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/AudioSpatialSound/sound/wobble_loop.mp3"])])])])])])])])]) ) ### X3D model conversion complete ### #################################################################################################### # Self-test diagnostics #################################################################################################### print('Self-test diagnostics for Filters.py:') if metaDiagnostics(newModel): # built-in utility method in X3D class print(metaDiagnostics(newModel)) # display meta info, hint, warning, error, TODO values in this model # print('check newModel.XML() serialization...') newModelXML= newModel.XML() # test export method XML() for exceptions during export newModel.XMLvalidate() # print(newModelXML) # diagnostic try: # print('check newModel.VRML() serialization...') newModelVRML=newModel.VRML() # test export method VRML() for exceptions during export # print(prependLineNumbers(newModelVRML)) # debug print("Python-to-VRML export of VRML output successful", flush=True) except Exception as err: # usually BaseException # https://stackoverflow.com/questions/18176602/how-to-get-the-name-of-an-exception-that-was-caught-in-python print("*** Python-to-VRML export of VRML output failed:", type(err).__name__, err) if newModelVRML: # may have failed to generate print(prependLineNumbers(newModelVRML, err.lineno)) try: # print('check newModel.JSON() serialization...') newModelJSON=newModel.JSON() # test export method JSON() for exceptions during export # print(prependLineNumbers(newModelJSON)) # debug print("Python-to-JSON export of JSON output successful (under development)") except Exception as err: # usually SyntaxError print("*** Python-to-JSON export of JSON output failed:", type(err).__name__, err) if newModelJSON: # may have failed to generate print(prependLineNumbers(newModelJSON,err.lineno)) print("python Filters.py load and self-test diagnostics complete.")