Quick links
 
 
 


Myriad Music Plug-In
Web Designer manual

Updated:

December 29th, 2011



What is the Myriad Music plug-in?
The Myriad Music Plug-In (MMP) enables you to build Web pages in which music will be played or displayed.
Music files are ".mus", ".myr" or ".mu3" files created with Melody Assistant or Harmony Assistant.
MusicXML and Packed MusicXML files, ABC files (mono or multi musics) are also managed.

The Plug-In also manage list of files provided in .mya format (See here the description of .mya)

Since the plug-in uses the same sound database as Melody/Harmony, you are sure the result is what you expected.
Much more, it provides a digital quality output but files are short (so fast to be downloaded).

You can manage several parameters to change the Plug-in display.

Here are different examples of how the Plug-In can appear:


Standard buttons (Moon look):


Icon buttons (Ocean look)


Icon buttons with big title, blue background:

Very shrinked interface:

Minimal vertical interface:


Score display.


Changes
Version 5.5: FILENAME, SETTEMPO commands added
Version 5.4.7: DISPLAY_POS command added
Version 5.4.5: Color themes
Version 5.4.4: Lecter, page rotation, play selection.
Version 5.4.2: Mixer, list of files.
Version 5.4: Views and metronome management, MusicXML file format.

From version 5.2 (March 2006) the default look is SHADOW.
If there is not enough space to display menu with this look, the MOON look is automatically enabled.
The menu language can be selected as well as the scrollbar colors.

How to use the Myriad Music plug-in:
In your web page source, insert these HTML commands:

<object classid="CLSID:07000E2B-6AAD-497D-8E5B-5976560AD429"
            border="0"
            height="400"
            width="300">
     <param name="src" value="mymusic.mus" />
     <param name="width" value="300" />
     <param name="height" value="400" />
     <param name="type" value="application/x-myriad-music" />
     <param name="pluginspage" value="http://www.myriad-online.com/cgi-bin/mmplug.pl" />
     <embed src="mymusic.mus"
                  width=300
                  height=400
                  type="application/x-myriad-music"
                  pluginspage="http://www.myriad-online.com/cgi-bin/mmplug.pl">
     </embed>
</object>

Where "mymusic.mus" is a file you located at the same level as the web page itself.

You can use Jukebox options in Melody or Harmony to generate automatically a web pages with a list of music pieces.

You can add other commands to customize the plug-in.
Commands can be written in upper or lower case.

Page setup fits automatically adapted the current printer page size. If the document was created with Harmony you can coarse the original page size by defining a fixed paper size (Score>Paper size setup>Use instead)

Be aware:

- Music file names are case-sensitive: "MyMusic.mus" will not be found on your remote server is the file is actually called "mymusic.mus".
- Music files must be uploaded in Binary mode.
- Each of the parameters you want to be processed by the plug-in (src, type...) has to be written twice:
    . Once in the "param" command for the "object" tag (Internet Explorer compatibility)
    . Once as a parameter for the "embed" tag (compatibility with other browsers)
  The "height" and "width" values have even to be written a third time, as a parameter for the "object" tag.

Security, copyright
When making a music available on your web page, please ensure you do own all the required rights.
In no case, Myriad can be considered as responsible for any violation of copyright laws.
All music pieces are published under your own responsibility.
It is recommended to save your files in "compact mode" (see general setup). The file will be shorter and encrypted.
You can protect your file (FileMenu>Protect) to disable the use of some features on the downloaded file: print, save, tempo change and transpose buttons are not available if the document is password-protected by its creator. There is no legal way to activate these features.
 

Summary of the command line
There are four sub-area in the plug-in display zone. All these sub-area can be hidden.

 - Title: Shows the piece title, duration, current time position and page number. You can select the title height, font size and the used color palette.
 - Menu: Shows the control button bar. You can select the enabled commands and the display mode and colors.
 - Time slider:  Shows the current time position in piece. The user can click on the time slider to change position.
 - Page:  Show the score as it will be printed. You can change the page size and default display zoom. The user can change the zoom, use scrollbars to move over the page or click in the page area to change the view position.

Foreword:
rgb is a color value where r (red),g (green), b (blue) can vary from 00 to FF. For example 000000 is black and FFFFFF is white.
n is an integer decimal number or floating point number.
ON mean "enabled" you can also use the keyword  OK,YES,TRUE,OUI,1
OFF mean "disabled" you can also use the keyword  NONE,NO,FALSE,NON,0

Play music setup:
QUALITY=LOW: Low quality, less CPU time consuming
QUALITY=MEDIUM: Medium quality, medium CPU time consuming
QUALITY=HIGH: Best quality, 44 khz, 16 bits, stereo, Digital Effects (by default)
VOLUME=n: Sets the ratio to apply to the initial output volume to value n, from 0 to 200. 50 mean half the volume defined by the creator, 200 twice the volume. This affects all the pieces on your page  (default=100)
LOOP=ON: Music will loop to the start when ended (default is OFF)
NEXT=ON: When the piece ends playing, the next piece with the option NEXT=ON will be played. Pieces are played from top of the page to bottom. (default=OFF)
AUTOPLAY=ON: Launches music as soon as possible (default is OFF). Avoid to set this option to more than one piece in your page.
SING=ON: (default) Shows the activated Virtual Singer icon
SING=INACTIVE : Shows the deactivated Virtual Singer icon
SING=OFF :  Deactivates the Virtual Singer and hides its icon
SOUNDBASE=xx where xx is the required sound base.  xx can be BEST,GOLD,SE,WE,MP,XT,ST or LT.
For example SOUNDBASE=SE will force the use of the GMSEBASE, if not found the GMWEBASE will be used, if not found the GMMPBASE will be used and so on.  If no base is found, the BEST base is used.
METRONOME=ON: By default, the metronome value is the one defined in the score. This commande enables to force the metronome in a given state.
METRONOME_BARS=xxx Number of metronome bars to be played before the music starts. Default is 2.
LIST_PLAY_MODE=n : Define how musics are linked while playing a list of files (.mya).
0=Play file and stop, 1= Play file and loop, 2= Play list and stop (default), 3= Play list and loop , 4= Play list randomly
TRANSP_OFFSET=xxxx  : Transposition value.
DISPLAY_POS=OFF  : Disable the vertical black line which show the position on the score
SETTEMPO=xxx : Force tempo.

 General setup:
COLOR_THEME=xxxx  : Global color theme setup. xxxx can be : DRACULA, BLUELAGOON, SPRINGFIELD, SNOWBALL, LIMEJUICE, PINKY, CHARCOAL, BRONZE, OPAL.
FILENAME=xxx : Force the filename for saving.

Title setup:
TITLE=OFF: Do not display  the title  (default is ON)
TITLEHEIGHT=n:  Title height in pixels  (default is 20)
TITLEFONTSIZE=n: Title Font size in pixels  (default is 12)
TITLEBKCOLOR=rgb: Sets the title background color.  (default is E0E0E0)
TITLEFRCOLOR=rgb: Sets the title foreground color. (default is 000000)
TITLEBKCOLPLAY=rgb: Title background color when playing music.  (default is 0000FF)
TITLEFRCOLPLAY=rgb: Title foreground color when playing music.  (default is FFFF00)
DURATION=OFF: Displays duration in the title  (default is ON)
DISPLAYNAME=ON: Displays file name instead of its title  (default is OFF)
DISPLAYTIME=OFF: Do not display time position when music is playing (default is ON)
DISPLAYSIZE=OFF: Do not display the file size  (default is ON)
DISPFILENAME=OFF:  Disable file name display in the message D "Downloading 'file name'..." (default is ON)
 
Menu setup:
MENU=OFF: Do not display the menu  (default is ON)
LOOK=SHADOW : Set the menu button theme to SHADOW (by default)
LOOK=OCEAN: Set the menu button theme to OCEAN, little blue icons (default is SHADOW)
LOOK=EVEREST: Set the menu button theme to EVEREST, big blue icons (default is SHADOW) LOOK=MOON: Set the menu button theme MOON, the default look before v5.2 (default is SHADOW)
MENUBKCOLOR1=rgb: First color of menu background in OCEAN or EVEREST theme (default is D0D0D0)
MENUBKCOLOR2=rgb: Second color of the menu background in OCEAN or EVEREST theme (default is E0E0E0)
PLAY=OFF: Disables the play button (default is ON)
MIXER=OFF: Disables the mixer button (default is ON)
TEMPO=OFF: Disables the tempo change button (default is ON if the document is not protected against changes)
PRINT=OFF: Disables the printing button display (default is ON if  the document is not protected against printing)
SAVE=OFF: Hide the save file option (default is ON if the document is not protected against saving)
ZOOM=OFF: Hide the zoom options (default is ON)
TRANSP=OFF: Hide the transpose option (default is ON  if the document is protected against changes). Transposition is volatile: when saving a file after transposing, the original untransposed version is actually saved.
DOCINFO=OFF: Hide document display info button (default is ON)
PAUSE=OFF: Hides the pause button (default is ON)
FORWARD=OFF: Hide the fast forward button (default is ON)
BACKWARD=OFF: Hide the fast backward button (default is ON)
STOP=OFF: Hide the stop button, the user can use the "play" button to stop the music (default is ON)
CHANGE_VOLUME=OFF: Hide the volume change button   (default is ON)
LANG=nn : Change menu language. nn can be FR,EN... (default is EN)
FULLSCREEN=OFF : Hide fullscreen button (default is ON)
DISPLAY_METRONOME=OFF : Deactivate metromome display, the user can't change its state, but the metronome sound can be active or inactive according to the default state defined in the score file (see "METRONOME" command)
ALLOW_VIEWS=OFF : Deactivate buttons for changing view and playing views.
START_VIEW=n : Select the view to be displayed from 0 to the number of vues in the document, -1 for the general vuew. By default, the document general view.
PLAY_VIEW_ONLY=ON : Initial state of the button for playing only the current view or the complete document. By default, the value defined in the score file.
ALLOW_TWO_PAGES=OFF : Disable the lectern mode (default is ON)
TWO_PAGES=ON : Inital lectern state (default is OFF)
ROTATE=ON : Allow page rotation (default is ON)
 KBD_ENABLED=ON : Enables the virtual keyboard icon (default is OFF)

Time slider setup:
TIMESLIDER=OFF: Don't display time slider (default is ON)
TIMESLIDERBKCOLOR1=rgb: 1st background color for the time slider (default is D0D0D0)
TIMESLIDERBKCOLOR2=rgb: 2nd background color for the time slider (default is E0E0E0)

List setup:
LISTCOLOR=rvb   :  For .mya files, list color  (default is 000000)

Page display setup :
PAGE=OFF: Do not display the score (default is ON)
HEIGHT=n: Heigth (pixels) of the score area. If  <60, no page view allowed.
WIDTH=n: Width (pixels) of the score area. If <100 no page view allowed.
ZOOMVALUE=n: Sets the default page view scale to the given value (default is 100)
FULLWIDTH=ON: Sets the default page view scale to the fullwidth value. The page will fit in the area.
RATIO=OFF: Disables the ratio observance option. Horizontal scale and vertical scales can be different (default is ON)
IMGBKCOLOR=rgb: Sets the score background color of the page. (default is FFFFEE)
DESKTOPCOLOR=rgb: Sets the background color outside the page (default is 0000D0)
NUMPAGE=n: Sets the first page to be displayed to the given value (default is 1)
ANTIALIAS=OFF: Disable the antialiasing mode, faster display, minimum memory, low quality result (default is MEDIUM)
ANTIALIAS=MEDIUM: Enable the antialiasing mode (default) see a sample.
ANTIALIAS=HIGH:  Enhanced antialiasing mode, slower display, more memory needed, best quality (default is MEDIUM)
ACCALLOCTAVE=OFF:  When a note have an accidental, the same notes following it in the same bar are similarly changed by default. Some musical notations only applies an accidental to the notes on the same line, and not for all the octaves of this note. (default is ON)
ANGLONOT=OFF: Switch to notation Do,Ré,Mi,Fa Sol,La, Si (default is C,D,E,F,G,A,B)
SOUNDBASELOGO=OFF:Disables "GOLD" sound base logo display at bottom of the score when file has been created using this sound base (default is ON)
PAPERMARGIN=n   : Size of the area around page. (default is 16)
POS_SPLIT=n : When list of files is displayed (.mya) define the horizontal list size.  (default is 200)
INVERT_VIDEO=ON : The score will be displayed in white on black (default is false)
ANGLE=nnn :Rotation angle in degree (if ROTATE=ON) allowed values are 0,90,180,270.
MIXER_SCISSOR=ON : Activate the multi-voices splitting in mixer.

Scrollbars setup :
 SCROLLBKCOLOR=rvb: Sets the scrollbar background color. (default is E0E0E0)
SCROLLTHUMBCOLOR=rvb: Sets the scrollbar thumb color. (default is A0A0A0)

Karaoke setup (lyrics):
LYRICS=OFF: If OFF the user can't display the lyrics (ON by default)
LYRICS=DEFAULT: The interfave will show lyrics instead score by default. The user can press the "Lyrics" button to switch from lyrics to score.
LYRICSSTAFFNUMBER=nnn: Index of the staff with lyrics to show (Staff without lyrics are not taken into account). By default  the first staff with lyrics is show. The user can change the displayed text using "page +" and "page -"
LYRICSSCALE=nnn: Size of the text in ratio  (25 to 200 %) by default 70. The user can change this value using the "Zoom" button.
TEXTSELECTCOLOR=nnn : Played text color (default is 00FF80)

Virtual Keyboard setup:

KBD_DISPLAYED=ON : The virtual keyboard is displayed when the page is loaded (default:OFF)
KBD_FIRST_OCTAVE=xxx : First octave (default: 3)
KBD_NB_OCTAVES=xxx : Number of octaves (default:7)

System setup
DEBUG=ON: Logs all events, status, errors, etc, in the "MyriadMusicPlugin.txt" file.
PURGE=OFF: Music files will be kept in memory even if not played or displayed.  (default is ON)
HIDDEN=true: The area is not displayed.  (default is False)
PLUGINSPAGE="http://www.myriad-online.com/cgi-bin/mmplug.pl":  This command is required. If an user does not have the plug-in installed or if the plug-in is out of date, his web browser will automatically open this page.
Please note:  if your page is written in French, you can use "http://www.myriad-online.com/cgi-bin/mmplug.pl"i nstead.

Important Notes:
  • Print, save, tempo and transpose options are not available if the document has been saved with an unregistered version of the program.
  • Printing, save, tempo and transpose options are not available if the document is password-protected by its creator.
  • If the digital sound base is not installed, the Play, Stop and Volume buttons are not available.
  • When menu is off (MENU=OFF) clicking in the title area starts playing, another click stops.
  • Displayed title displayed is the real title of the song  (as stored in the file) and not the file name. You can change this by using DISPLAYNAME=ON
  • The user can change the menu buttons look with by  clicking o, them with the Command key (Ctrl on PC) depressed.
  • If a command is unknown, it is ignored. Use the DEBUG mode to log the errors.
Browsers:
The Myriad Music Plug-in has been succesfully tested on:
Windows (95, 98, 2000 Pro SP1, NT4 SP5, XP SP2, Vista, 7):
Firefox 1.0 to 8
Google Chrome 5.0 to 16
Internet Explorer 4.72 to 10
K-Meleon 0.7
Mozilla 1.3 to 1.7
Netscape 4.4 to 7
Opera 3.5 to 11.6
Safari 3.1.1 to 5.1.2
Macintosh (MacOS X):
Internet Explorer 5.1
Internet Explorer 5.2
Opera 5.0
Mozilla 0.9.9
Netscape Communicator 6.2
Netscape Communicator 7
Safari 1.0 beta v60 to Safari 3.0.x
Camino 1.0
Firefox 2.0.0
FireFox 1.0
ICab 2.9.1

Linux
Firefox 8
The Myriad Music Plug-in does not work with:
Any browser running on a platform other than MacOS, Windows or Linux
If your web browser is not in listed here, please tell us where we can download it to test the Myriad Music Plug-In.

Note for users of 64-bits Linux:
The plug-in shared library (npMyrMus.so) has to be registered by nspluginwrapper after install.
On Ubuntu 64-bits, the commands are:
sudo apt-get install nspluginwrapper
nspluginwrapper -i /usr/lib/mozilla/plugins/npMyrMus.so


Necessary files for the plug-in:
All necessary and optional files are automatically installed.
For the Windows version
"NPMyrMus.dll" in the "Plugins" folder of your browser
"Myriad Music Plugin.rsr" at the same level.
For the Macintosh version
"Myriad Music Plug-In" in the "Plug-ins" folder of your browser
For the Linux version
"npMyrMus.so" in "/usr/lib/mozilla/plugins/"
"Myriad Music Plugin.rsr" at the same level.
Optionals files, but recommanded:
All necessary and optional files are automaticaly installed.
For the Windows version
"SToccata.ttf" in the font folder if you want to view or print scores
"GMDigit" folder in the web browser "Plugins" folder if you want to play music.
"Virtual Singer" folder in the web browser "Plugins" folder if you want Virtual Singer to sing
For the Macintosh version
"Myriad Music font" in the font folder, if you want to print
"GMDigit" folder in the web browser "Plug-ins" folder if you want to play the music.
"Virtual Singer" folder in the web browser "Plug-ins" folder if you want Virtual Singer to sing
For the Windows version
"SToccata.ttf" installed in the system fonts
"GMDigit" folder in the "plugins" folder if you want to play music.
"Virtual Singer" folder in "plugins" folder if you want Virtual Singer to sing

Communication between the plug-in and its embedding web page:
Javascript functions can communicate with the plug-in.
To do this, define an id for both the <object> and its inner <embed> tag.
For instance:

<object id="myobject" classid="CLSID:07000E2B-6AAD-497D-8E5B-5976560AD429"
            border="0"
            height="400"
            width="300">
     <param name="src" value="mymusic.mus" />
     <param name="width" value="300" />
     <param name="height" value="400" />
     <param name="type" value="application/x-myriad-music" />
     <param name="pluginspage" value="http://www.myriad-online.com/cgi-bin/mmplug.pl" />
     <embed id="myembed" src="mymusic.mus"
                  width=300
                  height=400
                  type="application/x-myriad-music"
                  pluginspage="http://www.myriad-online.com/cgi-bin/mmplug.pl">
     </embed>
</object>

Then, in Javascript, browsers that rely on the <object> (Internet Explorer) can retrieve a value from the plug-in, for instance its version, through:
var obj=document.getElementById("myobject");
var val=obj.pluginparams("version");

The other browsers, that rely on the <embed> tag will have to use instead:
var obj=document.getElementById("myembed");
var val=obj.version;

So, here is a Javascript function that read any value and works on any browser. The calling function will have to send the <object> id, the <embed> id, and the name of the plug-in value to retrieve. You can write this function in the HTML code of your page, or in a separate JS file:
<script language="Javascript" type="text/javascript">
<!--
function MValue(objid,embedid,propname)
    {
    var obj=document.getElementById(embedid);
    if(obj) return(eval("obj."+propname));
    obj=document.getElementById(objid);
    if(obj) return(eval("obj.pluginparam('"+propname+"')"));
    return("undefined");
    }
//-->
</script>

Here is an example of a call to this function:
<script language="Javascript" type="text/javascript">
<!--
function GetPluginValues()
    {
    var str;
   
    str="<tt><b>Property list</b><br>";
    str=str+"loaded: "+MValue("myobject","myembed","loaded")+"<br>";
    str=str+"version: "+MValue("myobject","myembed","version")+"<br>";
    str=str+"totalduration: "+MValue("myobject","myembed","totalduration")+"<br>";
    str=str+"playedposition: "+MValue("myobject","myembed","playedposition")+"<br>";
    str=str+"</b></tt>"
    return(str);
    }
//-->
</script>

The list of available values follows:

    loaded : (yes/no) is the document fully loaded
    version : plug-in version
    totalduration: duration of the score in milliseconds
    playedposition: play position in the score in milliseconds (-1 if score not playing)

A demonstration of this feature can be viewed on this sample page.

Disclaimer:
This Plug-in is provided to you "as is".
In no event will Myriad, its officers, directors, employees or agents be liable for any special, incidental, or consequential damage resulting from possession, use, or malfunction of any of their product.
All music pieces are published under your own responsibility.
Using this product for selling, reselling scores or more generally for any for-profit activity is strictly forbidden without a prior written authorization from Myriad.

You can send remarks and comments at "MMPlug@myriad-online.com"

Home > Resources > Manuals > Myriad Music Plug-In


Top of page
 Last update:  (c) Myriad 2012