version 0.51 [2004/02/21]
MusiXTeX is a very powerful system to writing a musical score. However, the appearance of slurs and ties are not so beautiful nor flexible since they are drawn by conbination 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_en
directry
musixpss_e.html
doc_it
directry
musixpss_it.html
doc_jp
directry
musixpss_j.html
musixpss.tex
musixpss.mp
musixpss.exe
musixpss.c
COPYING.txt
* All text files are encoded with LF line termination (UNIX style).
\special{PSfile=...}
. At least followings are OK:
supp-pdf.tex
and supp-mis.tex
.
These files must be latest ones.
According to the pdfTeX sample, they are available from ConTeXt distribution or http://www.tug.org/applications/pdftex/ . For further info, see the pdfTeX documents and samples.
Followings are not essential, just recommended.
musixpss.tex
into the directry where the working score exists or where "TeX input files directry" in TEXMF tree (for example $TEXMF/tex/musixtex/misc/
).
musixpss.mp
into the directry where the working score exists or where "MetaPost input files directry" in TEXMF tree (for example $TEXMF/metapost/musixtex/misc/
).
musixpss.exe
into an appropriate directry registrated in PATH
environment valuable; for example the directry where musixflx.exe
is located. If not, modify musixpss.c
line 44-45, compile it with an ANSI C compiler, and put the executable into appropriate directry.
Assume that the MusiXTeX score source is named foo.tex
.
foo.tex
in conventional way.
\input musixpss.tex\relax
after \input musixtex.tex
.
Some warnings such astex foo
musixflx foo
tex foo
No file foo.1.
will appear on the terminal and LOG file. A file foo.slu
containing parameters of slurs will be additionally generated.
musixpss foo
The program musixpss.exe
will translate foo.slu
into foo.mp
as MetaPost input.
Filename extention is forcely regarded as .slu
, regardless of its existence.
mpost foo
where command line is system dependent, see the manual of your system. EPS files foo.1
, foo.2
... containing each slur will be generated.
tex foo
The warnings will disappear and \special
for including EPS files will be written in DVI file.
When correcting and retypesetting the score, it is not required to delete intermediate EPS files such as foo.1
.
Sometimes just one execution of TeX will do in case there is no change in both foo.mx2
and foo.slu
(this is relatively rare case) .
In case a large change of score which requires total retypesetting, deleting EPS files before retypesetting will speed up operation of Pass 3 when using musixpss in general mode or pdfTeX exclusive mode.
This package has 3 operation modes to adapt itself to various environment.
\psslurmode{general}
: general mode (default)
\psslurmode{dvips}
: dvips/dvipdfm optimized mode
\psslurmode{pdftex}
: pdfTeX exclusive mode
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.
This mode makes the 6th pass of typesetting procedure not required and thus provides much faster operation than 'general mode', since 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 via 'TeX-music Mailing List' or direct email.
*Any DVIware compatible with LaTeX2e graphicx package with
operation mode general mode dvips optimized mode pdfTeX exclusive mode general DVIwares* OK dependent on DVIware NG dvips OK OK NG dvipdfm OK OK NG pdfTeX NG NG OK [dvips]
option. for example dviout, etc.
operation mode general mode dvips 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
tex foo
musixflx foo
tex foo
musixpss foo
mpost foo
dvips foo
(ordvipdfm foo
)Total 6 pass
+ Acrobat Reader
pdftex foo
musixflx foo
pdftex foo
musixpss foo
mpost foo
pdftex foo
(AcroRd32) foo
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
This might enable coexistence with 'PostScript Slurs Type K' ...??
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
or the same
musixpss foo.slu -clean
removes all intermediate EPS files foo.1
, foo.2
, ...foo.n
. (filename extention .slu
can be omitted.)
Free Software; based on the GNU GPL ver.2 (or later).
See the file COPYING.txt
for details.
COPYING.txt
or http://www.gnu.org/.
Hiroaki MORIMOTO
mailto: CQX05646@nifty.com
Thanks to Luigi Cataldi; providing Italian version document and giving compatibility reports about pdfTeX.
\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 obsolate and no more supported.
musixpss.mp
.
%
-ing in musixpss.tex
.
\Check@staff