version 0.54 [2017/08/17]
MusiXTeX is a very powerful system to writing a musical score. However, the appearance of slurs (including ties) are not so beautiful, because of their drawing method: combination of fonts.
This package provides a new method for slurs and ties to improve them: using Encapsulated PostScript (EPS) code generated by MetaPost.
\curve{h}{i}{j}
is equivalent to \midslur{h}
at present.
\count
, 1 \write
, 1 \read
.
music
environment with musixtex.sty
.
doc
directory **
musixpss_en.html
musixpss_it.html
musixpss_ja.html
musixpss.tex
musixpss.mp
musixpss.exe
musixpss.c
gpl-2.0.txt
* All readable files (html, tex, mp, c) are in CRLF line termination (MS-DOS/Windows style).
\special{PSfile=...}
. At least followings are OK:
supp-pdf.tex
and supp-mis.tex
.
These files should be enough new ones.
They are available from ConTeXt distribution or http://www.tug.org/applications/pdftex/ . For further info, see the pdfTeX documents and samples. musixpss.tex
into the directory where the working score exists or where "TeX input files directory" in TEXMF tree (for example $TEXMF/tex/generic/musixtex/misc/
).
musixpss.mp
into the directory where the working score exists or where "MetaPost input files directory" in TEXMF tree (for example $TEXMF/metapost/musixtex/misc/
).
musixpss.exe
into an appropriate directory registered in PATH
environment variable; for example the directory where musixflx.exe
is located. musixpss.c
line 44-45, compile it with an ANSI C compiler (for example: gcc -Wall -O2 -o musixpss musixpss.c
), and put the executable into appropriate directory.
Assume that the MusiXTeX score source is named foo.tex
.
foo.tex
in conventional way.
\input musixpss.tex\relax
after \input musixtex.tex
.
In pass 3, some messages such astex foo
musixflx foo
tex foo
No file foo.slu.1.mps.
or (foo.slu.1.mps)
will appear on the terminal and LOG file, and a file foo.slu
containing parameters of slurs will be additionally generated.
musixpss foo
The program musixpss.exe
will translate foo.slu
into MetaPost input, foo.mp
.
Filename extension is forcely regarded as .slu
, regardless of its existence.
mpost foo
where command line is system dependent. See the manual of your MetaPost system. EPS files foo.slu.1.mps
, foo.slu.2.mps
... containing each slur will be generated.
tex foo
The warnings will disappear and \special
for inclusion of EPS files will be written into DVI file.
When correcting and retypesetting the score, it is not required deleting intermediate EPS files such as foo.slu.1.mps
.
If there is no change in both foo.mx2
and foo.slu
(this is relatively rare case), only one execution of TeX will go.
Deleting EPS files before retypesetting will speed up operation of Pass 3,
in case of a large change of score and using general mode or pdfTeX exclusive mode.
This package has 3 basic operation modes to adapt itself to various environment.
\psslurmode{general}
: general mode (default)
\psslurmode{dvips}
: dvips/dvipdfm optimized mode
\psslurmode{pdftex}
: pdfTeX exclusive mode
The default is 'general mode'.
This mode guarantees the same compatibility of dvi file as LaTeX2e graphicx package with [dvips]
option, since the internal procedures are almost same.
Use this mode in general.
'dvips/dvipdfm optimized mode' is designed for dvips and dvipdfm/dvipdfmx.
This mode makes the 6th pass of typesetting procedure unnecessary and thus provides much faster operation than 'general mode', because the internal procedures of this mode is much simpler.
Also, this mode provides slightly good alignment.
The resulting dvi file is, however, not compatible with some DVIwares, because of the difference of low-level (not LaTeX2e-level) implementation of \special{PSfile=...}
from dvips.
'pdfTeX exclusive mode' is just as the naming.
This mode works well with pdfTeX ver.1.10a-devel or later.
It is known that some old version of support macro files supp-pdf.tex
and supp-mis.tex
lead to unaccountable error. In that case please update these two files at first.
The author hopes to adapt this package to DVIwares not listed above (xdvi, etc.) but has no environment of such DVIwares, other TeX distributions and OS's. Informations and trial reports are welcome.
Since ver.0.52, following two definitions for automatic mode selection are added. In these settings, musixpss.tex detects whether the using engine is conventional TeX or pdfTeX and selects appropriate operation mode automatically. Other characteristics are identical to the selected basic mode.
\psslurmode{auto-pdftex-general}
: automatic selection for 'general mode' and 'pdfTeX mode'
\psslurmode{auto-pdftex-dvips}
: automatic selection for 'dvips/dvipdfm optimized mode' and 'pdfTeX mode'
*Any DVIware compatible with LaTeX2e graphicx package with
operation mode general mode dvips / dvipdfm optimized mode pdfTeX exclusive mode auto selection for general and pdfTeX auto selection for dvips and pdfTeX general DVIwares* OK dependent on DVIware NG OK dependent on DVIware dvips/dvipdfm(x) OK OK NG OK OK pdfTeX NG NG OK OK OK [dvips]
option. for example dviout, etc.
operation mode general mode dvips / dvipdfm optimized mode pdfTeX exclusive mode code \input musixtex
\input musixpss
\relax\input musixtex
\input musixpss
\relax
\psslurmode{dvips}%\input musixtex
\input musixpss
\relax
\psslurmode{pdftex}%procedure Total 6 pass
+ DVIware
tex foo
musixflx foo
tex foo
musixpss foo
mpost foo
tex foo
%DVIWARE% foo
Total 5 pass
+ dvips or dvipdfm(x)
tex foo
musixflx foo
tex foo
musixpss foo
mpost foo
dvips foo
(ordvipdfm(x) foo
)Total 6 pass
+ Acrobat Reader
pdftex foo
musixflx foo
pdftex foo
musixpss foo
mpost foo
pdftex foo
(AcroRd32) foo
operation mode auto selection for general and pdfTeX auto selection for dvips and pdfTeX code \input musixtex
\input musixpss
\psslurmode{auto-pdftex-general}%\input musixtex
\input musixpss
\psslurmode{auto-pdftex-dvips}%
The thickness of slurs can be changed by redefining a macro \psslurthickadj
.
For example, \def\psslurthickadj{2.5}
makes the slurs 2.5 times thicker than the default.
EPS-based slurs can be switched on and off at any place in the score source by:
\enablepsslurM
\disablepsslurM
The support program has a function for deleting intermediate EPS files. This function is useful when deleting EPS files before total retypesetting and so on.
musixpss -clean foo.slu
(filename extension .slu
can be omitted.) or the same
musixpss foo.slu -clean
removes all intermediate EPS files foo.slu.1.mps
, foo.slu.2.mps
, ...foo.slu.n.mps
.
Note: the implementation is very simple, so please check the C source code and use this function with care. The author do not guarantee any responsibility of losing important files.
GNU GPL ver.2 or any later version.
See the file gpl-2.0.txt
for details.
For the time being, the author myself select GNU GPL version 2 as this package's basic criteria of license. However, the author of course do not prohibit shifting to latest GNU GPL version 3 when anyone combine a part of this package into another program.
gpl-2.0.txt
or http://www.gnu.org/.
Hiroaki MORIMOTO <CQX05646
(atmark) nifty
(dot) com
>
The author would like to express a great grarirude to Luigi Cataldi for his Italian version document and pdfTeX trial reports and so on.
\special{epsfile=...}
to special{PSfile=...}
.
\midslur h
\islurd...
with \midslur h
(upside down)
\isluru0...\midslur{-5}\tslur0
\invertslur
, \Tslurbreak
, \Islur[u|d]break
)
\musicsize
<> 16pt.
\midslur h
with large h
.
\psslursimplepositioning[true|false]
switches dvips optimized mode ON and OFF.
\psslurorgemu[true|false]
.
\musicsize
.
\psslurthickadj
.
\psslurmode{general|dvips|pdftex}
invokes "general mode", "dvips optimized mode", "pdfTeX exclusive mode", respectively. Thus \psslursimplepositioning[true|false]
became obsolete and no more supported.
musixpss.mp
.
%
-ing at line termination in musixpss.tex
.
foo.slu
in pass 1 to improve speed.
gets()
.
*.mps
). In case of too old MetaPost which does not support outputtemplate
, use version 0.53.
\Check@staff
based on MusiXTeX T.109 or later
Copyright (C) 2001-2017 Hiroaki MORIMOTO
All kinds of comments, suggestions, and bug reports are welcome. If you find any problems or ideas, please tell me via 'TeX-music Mailing List'.