Myriad Music Plug-In
Manuel du créateur de pages Web

Qu'est ce que le Myriad Music Plug-In ?

Le Myriad Music Plug-In vous permet de construire des pages web dans lesquelles des musiques seront affichées, jouées, chantées, transposées ou imprimées.
Il permet également d'afficher des didacticiels présentant le fonctionnement de logiciels.
 
Les musiques sont des fichiers ".mus", ".myr" ou ".mu3" créés avec Melody Assistant ou Harmony Assistant ainsi que les fichiers au format MusicXML et MusicXML compressés.

Le plug-in gère également des listes de fichiers fournies dans le format .mya. (Voir la description de ce format).

Comme le plug-in utilise la même base de son que Melody/Harmony ceci garantit que le résultat audio sera identique quel que soit l'ordinateur ou la carte son de l'utilisateur. De plus, vous obtiendrez une sortie numérique d'excellente qualité, avec des fichiers musicaux extrèmement court.
Le plug-in est très largement configurable.

Par exemple voici différents aspects que vous pouvez paramétrer:

Boutons standard (aspect Moon)


Icônes (aspect Ocean)


Icônes avec un grand titre sur fond bleu.


Interface réduite.

Interface minimale verticale.

Visualisation et impression de page.

Et ainsi de suite, au gré de votre imagination...

Changements

Version 5.4.5:  Thèmes de couleur
Version 5.4.4:  Lutrin, rotation de page, jeu en boucle d'une sélection
Version 5.4.2:  Table de mixage, liste de fichiers.
Version 5.4: gestion des vues et du métronome. Gestion du format MusicXML.

A partir de la version 5.2 du plug-in (Mars 2006), l'aspect par défaut est SHADOW.
Si l'espace est insuffisant pour afficher les menus avec cet aspect, l'aspect MOON est automatiquement activé.
La langue du menu peut être choisie de même que la couleur des ascenseurs.

Comment utiliser le plug-in ?

Dans le source de votre page Web, insérez les commandes suivantes :

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

Où "musique.mus" est un fichier créé avec Melody Assistant ou Harmony Assistant et positionné au même niveau que votre page web, la valeur 300 correspond à la largeur en pixel de l'objet et la valeur 400 à sa hauteur en pixel.

Vous pouvez utiliser les fonctions d'export HTML du Jukebox de Melody/Harmony pour générer automatiquement des pages web avec des listes de musiques. Plusieurs dizaines de commandes, insérées dans la ligne ci-dessus, paramètrent le plug-in.

Les commandes sont écrites en minuscules ou en majuscules, séparées par un espace.

La mise en page est automatiquement adaptée à l'imprimante de l'utilisateur.
Si le document musical est créé avec Harmony, vous pouvez forcer la mise en page (Menu partition>Définir l'aire papier>Utiliser l'aire). Ainsi vous serez sûr que le résultat imprimé sera identique quelle que soit l'imprimante utilisée.

Attention:
- Le nom du fichier musical est sensible aux majuscules. Ainsi "Musique.mus" ne sera pas trouvé sur votre serveur si le fichier s'appelle "musique.mus". Il est donc conseillé de prendre l'habitude d'écrire tous les noms de fichier en minuscules et sans caractères accentués ni espace.
- Les fichiers musicaux doivent être envoyés sur votre serveur en mode "binaire" (et non "Ascii")
- Chacun des paramêtres que vous désirez que le plug-in traite (src, type...) doit être écrit deux fois.
  . Une fois dans la commande "param" du marqueur "object" (compatibilité avec Internet Explorer)
  . Une fois comme paramètre du marqueur "embed" (compatibilité avec les autres navigateurs)
Les valeurs "height" et "width" doivent même écrites une troisième fois, comme paramètre du marqueur "object".

Securité, droits d'auteur

Quand vous proposez une musique sur votre page web, vous devez vous assurer que vous avez le droit de le faire, ceci est sous votre entière responsabilité. En aucun cas, Myriad ne pourra être tenue responsable de l'utilisation illégale de ce plug-in.
Il est recommandé de sauvegarder vos fichiers en mode "compacté" (Voir les préférences générales>Sauve)
Ainsi vos fichiers seront plus rapidement téléchargés et surtout seront sous une forme cryptée.
Vous pouvez utiliser les fonctions de protection (Menu Fichier>Protéger) pour restreindre l'accès à votre fichier.
Impression, sauvegarde, transposition pourront ainsi être interdites. Il n'y a aucune possibilité pour l'utilisateur d'outre-passer ceci.
 

Les commandes

Il y a quatres zones différentes dans l'aire affichée. Chacune de ces zones peut être activée ou désactivée. De haut en bas nous trouvons:

Préambule :
rvb est une couleur où r (rouge), v (vert), b (bleu)  varient de 00 à FF (hexadecimal). Par exemple 000000 est la couleur noire, FFFFFF la couleur blanche.
n est une valeur entière
ON signifie actif vous pouvez également utiliser OK,YES,TRUE,OUI,1 qui sont des synonymes.
OFF signifie inactif vous pouvez également utiliser NONE,NO,FALSE,NON,0 qui sont des synonymes.

Configuration du jeu de la musique :

QUALITY=LOW : Basse qualité, faible consommation de temps machine.
QUALITY=MEDIUM : Qualité moyenne.
QUALITY=HIGH : Meilleur qualité, 44 khz,16 bits stereo, Effets numériques (par défaut)
VOLUME=n :  Fixe le coefficient de volume sonore initial de 0 à 200. 100 correspond au niveau sonore défini par le créateur du document, 50 la moitié de ce volume, 200 le double. Ceci affecte toutes les musiques de la page. (par défaut 100)
LOOP=ON: La musique reprendra au début après avoir terminé de manière naturelle.( OFF par défaut)
NEXT=ON :  Quand la musique se terminera de manière naturelle (non arrétée par l'utilisateur) elle reprendra automatiquement à la musique suivante marquée par la commande NEXT. Les musiques sont jouées de haut en bas de la page. (OFF par défaut)
AUTOPLAY=ON :  Lance la musique dès qu'elle est chargée. Evitez cette commande si vous avez plus d'une musique dans la page. (OFF par défaut)
SING=ON: (défaut) Montre l'icône du Chanteur Virtuel activée
SING=INACTIVE : Montre l'icône du Chanteur Virtuel désactivée
SING=OFF :  Désactive le Chanteur Virtuel et ne montre pas l'icône
SOUNDBASE=xx où xx est la base de son imposée pour le jeu de la musique xx pouvant être  BEST,GOLD,SE,WE,MP,XT,ST ou LT. Si la base de son imposée n'est pas présente sur l'ordinateur , la base de qualité inférieure suivante est prise et ainsi de suite. Si aucune base de qualité inférieure n'est trouvée la base de meilleure qualité est activée.
METRONOME=ON :  Par défaut la valeur de jeu du métronome est celui fixé dans la partition. Cette commande permet de forcer le métronome à un état donné.
METRONOME_BARS=xxx Nombre de mesures de métronome qui seront jouées avant le début de la musique, par défaut 2.
LIST_PLAY_MODE=n : Mode d'enchainement de l'interprétation d'une liste (fichier .mya). 0=Joue le fichier et s'arrète, 1= Joue le fichier en boucle, 2= Joue la liste et s'arrete (par défaut), 3= joue la liste en boucle, 4= Joue la liste de manière aléatoire
TRANSP_OFFSET=xxxx  : Valeur de transposition de départ.

Configuration générale:

COLOR_THEME=xxxx  : Définit le jeu de couleur par défaut. xxxx peut être : DRACULA, BLUELAGOON, SPRINGFIELD, SNOWBALL, LIMEJUICE, PINKY, CHARCOAL, BRONZE, OPAL.

Configuration du titre :

TITLE=OFF  : Ne pas afficher le titre (ON par défaut)
TITLEHEIGHT=n : Hauteur du titre en pixel (20 par défaut)
TITLEFONTSIZE=n  :  Hauteur de la police du titre en pixel (12 par défaut)
TITLEBKCOLOR=rvb   : Fixe la couleur de fond du titre  ( E0E0E0  par défaut)
TITLEFRCOLOR=rvb   :  Fixe la couleur de tracé du titre ( 000000 par défaut)
TITLEBKCOLPLAY=rvb   :  Fixe la couleur du fond du titre lorsque la musique se joue  ( 0000FF par défaut)
TITLEFRCOLPLAY=rvb   : Fixe la couleur de tracé du titre lorsque la musique se joue  (FFFF00 par défaut)
DURATION=OFF : Désactive l'affichage de la durée totale de la musique  (Actif par défaut)
DISPLAYNAME=ON   : Affiche le nom du fichier à la place du titre (Inactif par défaut)
DISPLAYTIME=OFF   : Désactive l'affichage de la position en minute:seconde quand la musique joue. (Actif par défaut)
DISPLAYSIZE=OFF   : Désactive l'affichage de la taille du fichier dans le titre (Actif par défaut)
DISPFILENAME=OFF   : Désactive l'affichage du nom du fichier dans le message "Downloading 'nom de fichier'..." (Actif par défaut)
 
Configuration du menu:

MENU=OFF : Ne pas afficher le menu (ON par défaut)
LOOK=SHADOW : Fixe l'aspect du menu à SHADOW (par défaut)
LOOK=OCEAN   : Fixe l'aspect du menu à OCEAN, petites icônes bleues(SHADOW par défaut)
LOOK=EVEREST   : Fixe l'aspect du menu à EVEREST, grandes icônes bleues(SHADOW par défaut) LOOK=MOON : Fixe l'aspect du menu à MOON, aspect par défaut jusqu'à la version 5.1 (SHADOW par défaut)
MENUBKCOLOR1=rvb : Première couleur de la trame de fond du menu (par défaut D0D0D0)
MENUBKCOLOR2=rvb  : Deuxième couleur de la trame de fond du menu (par défaut E0E0E0)
PLAY=OFF   :  Inactive le bouton "Play"  (ON par défaut)
MIXER=OFF   :  Inactive le bouton "Table de mixage"  (ON par défaut)
TEMPO=OFF   :  Inactive le bouton "Tempo" (ON par défaut, si le document n'est pas protégé contre le changement)
PRINT=OFF    :  Inactive le bouton "Print" (ON par défaut, si le document n'est pas protégé contre l'impression)
SAVE=OFF    :  Inactive le bouton "Save" (ON par défaut,  si le document n'est pas protégé contre la sauvegarde)
ZOOM=OFF  :  Inactive le boutons de changement d'échelle (ON par défaut)
TRANSP=OFF  : Inactive le boutons de transposition (ON par défaut  si le document n'est pas protégé contre la modification) Quand un fichier est transposé puis sauvegardé, c'est la version originale du fichier qui est sauvegardée.
DOCINFO=OFF   : Inactive le boutons d'information sur le document (ON par défaut )
PAUSE=OFF   : Inactive le bouton de pause (ON par défaut )
FORWARD=OFF   : Inactive le bouton d'avance rapide (ON par défaut )
BACKWARD=OFF   : Inactive le bouton de retour rapide (ON par défaut )
STOP=OFF   : Inactive le bouton de stop, l'utilisateur peut tout de même utiliser le bouton "play" pour arrêter la musique (ON par défaut )
CHANGE_VOLUME=OFF   : Inactive le bouton de changement de volume (ON par défaut )  
Configuration de la barre temporelle :
LANG=nn : Change la langue du menu, nn vaut par exemple FR, EN (par défaut EN)
FULLSCREEN=OFF : Interdit le mode plein écran (ON par défaut)
DISPLAY_METRONOME=OFF : Désactive l'affichage du métronome, l'utilisateur ne peut en changer l'état mais il peut être actif ou inactif selon l'état par défaut défini dans le fichier (voir la commande METRONOME)
ALLOW_VIEWS=OFF : Désactive les boutons de changement de vue et de jeu de la vue.
START_VIEW=n : Sélection de la vue à afficher de 0 au nombre de vue du document, -1 pour la vue générale. Par défaut, c'est la vue générale du document.
PLAY_VIEW_ONLY=ON : Etat initial du bouton de jeu de la vue courante ou du document complet. Par défaut, c'est la valeur définie dans le document.
ALLOW_TWO_PAGES=OFF : Désactive le mode lutrin (ON par défaut)
TWO_PAGES=ON : Valeur de démarrage du mode lutrin (OFF par défaut)
ROTATE=ON : Active la possibilité de rotation de page (OFF par défaut)

Configuration de la barre temporelle:

TIMESLIDER=OFF   : Ne pas afficher la barre temporelle (ON par défaut)
TIMESLIDERBKCOLOR1=rvb   : Première couleur de la trame de fond de la barre temporelle  (par défaut D0D0D0)
TIMESLIDERBKCOLOR2=rvb   : Deuxième couleur de la trame de fond de la barre temporelle  (par défaut E0E0E0)

Configuration de la liste :

LISTCOLOR=rvb   :  Couleur de base de la liste pour les fichiers .mya  (par défaut 000000)

Configuration de l'affichage de la page:

PAGE=OFF   : Ne pas afficher la  page (ON par défaut)
HEIGHT=n   :  Hauteur d'affichage de l'aire totale. Si la hauteur restante après avoir placé le titre, le menu,etc,  est inférieur à 60 la page n'est pas affichée.
WIDTH=n  :  Largeur d'affichage de l'aire totale. Si la largeur est inférieure à 100 la page n'est pas affichée.
ZOOMVALUE=n  : Fixe la valeur d'échelle au démarrage.(100 par défaut)
FULLWIDTH=ON : Calcule l'échelle au démarrage de manière à ce que la largeur de la page occupe la totalité de l'aire d'affichage.
RATIO=OFF   :  Inactive le respect des ratios horizontal-vertical. Si inactif, la page est ajustée pour remplir totalement l'aire. Si actif, les proportions sont respectées.(ON par défaut)
IMGBKCOLOR=rvb  : Fixe la couleur du fond de la page (FFFFEE par défaut)
DESKTOPCOLOR=rvb :  Fixe la couleur du fond en dehors de la page ( 0000D0 par défaut)
NUMPAGE=n   : Fixe la première page affichée (1 par défaut)
ANTIALIAS=OFF   : Désactive le mode d'affichage anti-aliasé, affichage plus rapide, mémoire minimale, rendu graphique de qualité inférieure (MEDIUM par défaut)
ANTIALIAS=MEDIUM   : Affichage anti-aliasé (par défaut) voir un exemple.
ANTIALIAS=HIGH   : Affichage anti-aliasé poussé, affichage plus lent, plus de mémoire nécessaire, qualité graphique maximale(MEDIUM par défaut)
ACCALLOCTAVE=OFF   :  Lorsque  une note est altérée, les mêmes notes qui suivent dans la mesure ont par défaut cette altération. Certaines notations ne prennent en compte cette altération que pour les notes se trouvant exactement sur la même ligne et non pour toutes octaves de cette note.(actif  par défaut)
ANGLONOT=OFF : Passe en notation Do,Ré,Mi,Fa Sol,La, Si (C,D,E,F,G,A,B par défaut)
SOUNDBASELOGO=OFF : Empêche l'affichage du logo "Base Gold" en bas de la partition lorsque le fichier a été créé avec cette base de sons (ON par défaut)
Configuration système:
DEBUG=ON   : Sauvegarde dans le fichier "MyriadMusicPlugin.txt" toutes les erreurs, évènements...
PURGE=OFF   :  Le fichier musical sera conservé en mémoire même s'il n'est pas joué.  (ON par défaut) Peu recommandé...
HIDDEN=true   : L'aire est totalement cachée(faux par défaut)
PLUGINSPAGE="http://www.myriad-online.com/cgi-bin/mmplug.pl?lang=fr":  Cette commande est obligatoire . Si l'utilisateur n'a pas le plug-in installé ou dispose d'une version périmée du plug-in, le navigateur se branchera sur cette page pour faire une mise à jour.
Veuillez noter que pour une page anglophone vous devez utiliser "http://www.myriad-online.com/cgi-bin/mmplug.pl" à la place.
PAPERMARGIN=n   : Défini l'aire laissée autour de la page. (16 par défaut)
POS_SPLIT=n : Quand une liste de fichier est representée (fichier .mya) défini la taille horizontale de la liste. (200 par défaut)
INVERT_VIDEO=ON : Active l'inversion vidéo pour l'affichage de la partition.
ANGLE=nnn :Angle de rotation en degré (si ROTATE=ON) les valeurs autorisées sont 0,90,180,270.

Configuration des ascenseurs :

SCROLLBKCOLOR=rvb   : Couleur de fond des ascenseurs (par défaut E0E0E0)
SCROLLTHUMBCOLOR=rvb   : Couleur de l'onglet des ascenseurs (par défaut A0A0A0)

Configuration du karaoké (texte des paroles) :
LYRICS=OFF  : Si OFF l'utilisateur ne peut demander l'affichage des paroles (ON par défaut)
LYRICS=DEFAULT  : L'interface présentera les paroles à la place de la partition
LYRICSSTAFFNUMBER=nnn  : Index de la portée parole à représenter. Si vous avez plusieurs portées paroles dans le document et que vous ne désiriez pas représenter la première, fournissez l'index. (Il s'agit bien de l'index de la portée parole, à l'exclusion des autres portées). Par défaut, c'est la première qui est prise. A noter que l'utilisateur peut changer de portée parole en utilisant "page +" et "page -".
LYRICSSCALE=nnn  : Hauteur des textes des paroles en pourcentage (25 à 200 %) par défaut 120. L'utilisateur peut changer cette hauteur en utilisant le bouton "Zoom"
TEXTSELECTCOLOR=nnn : Couleur du texte joué (par défaut 00FF80)

Notes importantes :

Visualiseur de séquences didactiques
Certaines commandes fonctionnent également avec le visualiseur de séquences didactiques
LOOP=ON: La séquence reprendra au début après avoir terminé de manière naturelle.( OFF par défaut)
AUTOPLAY=ON :  Lance la séquence dès que la premère page est chargée.  (OFF par défaut)

Navigateurs

Le Myriad Music Plug-in a été testé avec succès sur :

Windows (95, 98, 2000 Pro SP1, NT4 SP5, XP SP 2, Vista) :

Firefox 2.0.0
Firefox 1.0
Internet Explorer 7.0
Internet Explorer 6.0
Internet Explorer 5.0
Internet Explorer 4.72
K-Meleon 0.7
Mozilla 1.7
Mozilla 1.3
Mozilla 0.8.1
Netscape  7
Netscape 6
Netscape 4.7 - 4.79
Netscape 4.5
Netscape 4.4
Netscape Gold 3.1
Opera 9.27
Opera 7.54u2
Opera 7.01
Opera 5.10
Opera 5.02
Opera 4.02
Opera 3.6
Opera 3.5
Safari 3.1.1

Macintosh (Mac OS X) :

Internet Explorer 5.1
Internet Explorer 5.2
Opera 5.0
Mozilla 0.9.9
Nestcape Communicator 6.2
Netscape Communicator 7
Safari 1.0 beta v60 à Safari 3.0.x
Camino 1.0
Firefox 2.0.0
FireFox 1.0
ICab 2.9.1

Le Myriad Music Plug-in ne fonctionne pas sur :

Tout navigateur sur une autre plate-forme que Macintosh ou Windows.

Si votre navigateur n'est pas dans cette liste, écrivez-nous en nous précisant où nous pouvons le télécharger. Nous testerons le plug-in avec lui.
Fichiers nécessaires au fonctionnement:
Ceci est donné à titre indicatif, puisque les fichiers nécessaires ou non sont automatiquement installés.

Windows:

"NPMyrMus.dll" dans le dossier "Plugins" du Navigateur
"Myriad Music Plugin.rsr" au même niveau

Macintosh:

"Myriad Music Plug-In" dans le dossier"Plug-ins" du Navigateur

Fichiers facultatifs mais recommandés:
Ceci est donné à titre indicatif puisque les fichiers nécessaires ou non sont automatiquement installés.

Windows:

"SToccata.ttf" dans le dossier des polices de Windows (indispensable pour imprimer)
Dossier "GMDigit" dans le dossier "Plugins" si vous voulez écouter la musique.
Dossier "Virtual Singer" dans le dossier "Plugins" si vous désirez que le chanteur virtuel chante.

Macintosh:

"Myriad Music font" dans le dossier des polices du MacOS (indispensable pour imprimer)
Dossier "GMDigit" dans le dossier "Plug-ins" si vous voulez écouter la musique.
Dossier "Virtual Singer" dans le dossier "Plug-ins" si vous désirez que le chanteur virtuel chante.

Avertissements légaux

En utilisant ce programme vous devez respecter ce qui suit :
Ce plug-in vous est livré "en l'état". C'est un produit gratuit.
En aucun cas la société Myriad ne pourrait être tenu responsable d'une quelconque conséquence de l'utilisation de ce programme.
En particulier, les personnes utilisant ce plug-in pour diffuser des morceaux musiques devront s'assurer que les droits des auteurs sont respectés.
L'utilisation de ce produit pour la vente ou la revente de partitions, ou toute autre forme de commerce,  est interdite sans l'accord préalable de la société Myriad.