DEVELOPERS' NOTES

APPLETS

JMSL Applets require jmsl.jar in codebase. JMSL Applets that use JMSL's "score" notation package also require jscore.jar to be located in the codebase
JMSL v1.035 uses a new licensing scheme which no longer requires the deployment of special JMSL jars for your applets. You may upload your copies of jmsl.jar and jscore.jar to the codebase of your applets. Do not upload your license file (JMSL.lic)!!! Applets run in fully functional unlicensed mode when online. Do not upload your license file.

Including jar files
Put jmsl.jar in your codebase. If you are using JMSL's notation package, also include jscore.jar. Typical applet tag might look like this:

< applet code = "mypackage.MyClass.class"
    codebase="classes" 
    archive="jmsl.jar,jscore.jar" 
    width="800" 
    HEIGHT="600" >

More specifically:
• The "classes" directory on your server should contain a directory called JMSLScores (or similar).
• Your classes directory should also include jmsl.jar and jscore.jar
• Upload your score file (MyScore.xml or MyScore.zip) to classes/JMSLScores
• Uploaded your SynthNote .class files to "classes" as well (be sure to copy the directory containing these .class files as well, since Java package names correspond to directories.)
• If your score loads samples, the classes directory on the server corresponds to your local SAMPLES directory. Upload your samples there.
• Make an html page at the same directory level as classes (not IN classes), with an applet tag like the following. You'll invoke JMSLScoreApplet and pass it the name of your score file.

 < applet code = "com.softsynth.jmsl.score.util.JMSLScoreApplet.class"
    codebase="classes" 
    archive="jmsl.jar, jscore.jar" 
    width="600" 
    HEIGHT="129" >
< param name = "URL" value ="JMSLScores/JSyn_piece_1.xml" >
 
 optional parameters:
 zoom  - a number 0..1 for score zoom.  Defaults 0.5
 advancetime - some number of seconds for JMSL advance time.  Defaults to 1.0 sec
 wrap - true or false, turns system wrap on/off. Defaults to false (no wrap)
 < /applet >
 
 

	JMSL.setCodeBase(getCodeBase());

	JMSL.scheduler = new EventScheduler();
	JMSL.scheduler.start();

	JMSL.scheduler.stop();

For example:
 public void start() {
        synchronized (JMSL.class) {
            // IMPORTANT! Start with a new scheduler!
            JMSL.scheduler = new EventScheduler();
            JMSL.scheduler.start();
			// other start code, open MusicDevices etc
            }
    }
    
     public void stop() {
        synchronized (JMSL.class) {
            myComposable.finishAll();
            try {
                myComposable.waitForDone();
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            JMSL.scheduler.stop();
            JMSL.closeMusicDevices();
        }
    }
    

scoreFrame.setVisible(false);
scoreFrame.dispose();
Score.deleteCanvas();
SelectionBuffer.disposeEditFrame();

    public void stop() {
        synchronized (JMSL.class) {
            removeAll();
            scoreFrame.setVisible(false);
            scoreFrame.dispose();
            Score.deleteCanvas();
            SelectionBuffer.disposeEditFrame();
            JMSL.scheduler.stop();
            JMSL.closeMusicDevices();
        }
    }