readme.txt

Group ID : 10
Member :

    - Name : HUANG, Junkai (Abraham)
      E-mail : jhuangce@connect.ust.hk

    - Name : YU, Mukai (Tom Notch)
      E-mail : myual@connect.ust.hk


Description :

    We implement uniform ways to deform any mesh in any resolution according to any acoustic signal. The deformation scheme, resolution and sound signal can be changed during runtime seamlessly. We also properly design the whole scene by distribute plenty of shattered glass objects evenly and randomly around the mesh. All the material parameters can be adjusted during runtime according to the user's preference.


Program usage :

    - Need to have Internet connection because main.js imports libraries directly from https://threejs.org (so that we don't need to include the whole "three.js" folder)
    - Turn up the speaker/earphone, load the website and click on "GO"
    - Enjoy the music and the visualizer!
    - GUI :
        * Song : switch different Song
        * Motion mode : deformation scheme : slicing - vertical deformation , polar - spherical deformation
        * resolution : number of levels/segments that the mesh deforms
        * amplitude : the amount of deformation
        * Mesh Appearance : material parameters of the mesh at the center
        * Glass Appearance : material parameters of the shattered glass objects scattered around
        ** Feel free to switch different songs, play around with different deformation scheme and the material parameters!


Workload breakdown :

    - HUANG, Junkai (Abraham) : sound analysis, material, GUI       -- 50%
    - YU, Mukai (Tom Notch) : mesh deformation and mapping to sound -- 50%