Directory support/xml2pmx

xml2pmx, version 2021-02-07.  

Summary: xml2pmx translates MusicXML into PMX notation. 

MusicXML (http://www.musicxml.com) originally               
developed by Recordare and now owned by Finale              
(https://www.finalemusic.com/), is the leading music-data 
exchange format.                                            

PMX, developed by Don Simons dsimons(at)roadrunner(dot)com,
is an easy to use, yet powerful preprocessor
for the music typesetting system MusiXTeX.
http://icking-music-archive.org/software/htdocs/

xml2pmx has been developed by Dieter Gloetzel with the "Oberon Plugin
for Windows Version 2.5" of ETHZ Zurich on Windows 10
https://github.com/Spirit-of-Oberon/ETH-Oberon-PlugIn-Win32
and OLR (Oberon Linux Revival)
http://oberon.wikidot.com/oberon-linux-revival-olr

Coverage of MusicXML by xml2pmx
*******************************

The following MusicXML features are detected and translated to PMX:

  - up to 24 staves/voices and 600 bars 
  - up to 83 notes per instrument and bar
  - two voices per staff
  - maximum of two staves per instrument
  - notes and rests up to 64th, including tuplets and grace notes, 
  - maximum of 2 dots
  - chords, accidentals
  - some annotations like Fermata, Staccato, Tremolo etc. 
  - ties, slurs and beams
  - definition of meter, fifths, clefs and their changes on the fly
  - dynamic marks: hairpins, "ff" etc., piano damping pedal
  - title and composer, and texts above or below the staff
  - barlines, repeats, volta
  - instrument names

Windows and Unix line terminations are accepted. UTF-16
input is not accepted.

This package is based on a runtime system developed by Mike
Spivey (mike(at)cs.ox.ac.uk) as part of the Oxford Oberon
Compiler project.

Usage
*****

On Windows or Macs, use the executables provided in the
relevant folders.

To build and install an executable xml2pmx on a system
with conventional development tools:

  tar xvf xml2pmx-2021-02-07.tar.gz
  cd xml2pmx-2021-02-07
  ./configure 
  make
  sudo make install

Full details on usage are in the man page. The most
convenient way to use xml2pmx is with the musixtex.lua
script, version 0.23 or later, which supports xml2pmx as a
pre-preprocessor. Version 0.23 of musixtex.lua is provided
in the scripts folder. On Windows you may have to use it as
follows:

  texlua musixtex.lua something[.xml]

If it is necessary to edit the resulting pmx file, use the
-m option.

Licencing
*********

The source files for xml2pmx are Copyright 2015-2021 by
Dieter Gloetzel (d.gloetzel(a)web.de) and the source files
for the runtime system are Copyright 2021 by Mike Spivey
(mike(a)cs.ox.ac.uk). They may be modified and distributed
according to the terms of the GNU General Public Licence
version 3 or at your option any later version.

musixtex.lua is Copyright 2011-2021 by Bob
Tennent (rdt(a)cs.queensu.ca) and Dirk Laurie
(dirk.laurie(at)gmail.com). It may be modified and
distributed according to the terms of the GNU General Public
Licence version 2 or at your option any later version.

This README and the man pages xml2pmx.1 and musixtex.1 were
written by Bob Tennent and may be modified and distributed
according to the terms of the LaTeX Project Public License.

Please report problems with the executables or the build
system to Bob Tennent (rdt(a)cs.queensu.ca). Problems with
the XML to PMX translation should be reported to Dieter
Gloetzel (d.gloetzel(at)web.de).