Polymetric Expression

A CS1010R javascript project by Yang Mansheng and Yang Zhixing, supervised by Associate Professor Martin Henz and Srikumar Karaikudi Subramaniam, in collaboration with Lee Zhi Xin and Rose Marie Tan who worked on the Generative Grammar(https://github.com/rosemarietan/GenerativeGrammar/) Project.

Project Home Page

http://lightyang.github.com/PolymetricExpression/

Bol Processor BP2 Docs - Polymetric Expression

http://bolprocessor.sourceforge.net/docs/bp2-Polyrhy.html

http://bolprocessor.sourceforge.net/docs/bp2-Polymet.html

Using The Library

1. The easiest way

   Files needed: pe-lib/*, sample-manager.js, player-facade.js

   player-facade.js provides an easy way to play polymetric expression, assuming you want to use sample-manager.js to load the samples.
   There are 4 steps:

   1. Create a playerFacade object
   2. (Optional) Set playerFacade.continuousPredicate to enable adding continuous sound object
   3. Call playerFacade.loadSamples to load the samples

      sampleUrl is the url of the folder your sample files are located in. The folder should contains a mapping.js file.
      Look at "acoustic-kit" folder for an example of the structure.

   4. Call playerFacade.play with the expression you want to play
   5. (Optional) Call playerFacade.stop when you want to
   The playerFacade class also exports other things like the player it uses to provide more detailed control. Look at the code for more information.

2. Need more control

   Files needed: pe-lib/*

     <p>
     	If you need more control, you can use pe-player.js directly but this way is a bit more complicated. Look at pe-player.js for more information.
     	<br/>
     	You can use demo.js as an example.
     </p>