summaryrefslogtreecommitdiff
path: root/muse/doc/man/en/man-en.tex
blob: be746129e5c5d0ebfc75b289c016769962a4f119 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
%====================================================================
%     MusE Manual
%     this is the MusE manual
%
% (C) 2006 Copyright: Werner Schweer and Others
%====================================================================

%----------------------------------------------------------
%     Setup
%----------------------------------------------------------

%\showframe
%\showsetups
\usemodule[chart]
\setupcolors[state=start]
\setupbodyfont[Palatino]
\language[en]
\enableregime[il1]

\startuseMPgraphic{FunnyFrame}
      picture p; numeric o; path a, b; pair c;
      p := textext.rt(\MPstring{FunnyFrame});
      o := BodyFontSize;
      a := unitsquare xyscaled(OverlayWidth,OverlayHeight);
      p := p shifted (20, OverlayHeight-ypart center p);
      drawoptions (withpen pencircle scaled 1pt withcolor .625red);
      b := a superellipsed .95;
      fill b withcolor .85white; draw b;
      b := (boundingbox p) superellipsed .95;
      fill b withcolor .85white; draw b;
      draw p withcolor black;
      setbounds currentpicture to a;
    \stopuseMPgraphic

\defineoverlay[FunnyFrame][\useMPgraphic{FunnyFrame}]
\defineframedtext[FunnyText][frame=off,background=FunnyFrame]
\def\StartFrame{\startFunnyText}
\def\StopFrame{\stopFunnyText}
\def\FrameTitle#1%
 {\setMPtext{FunnyFrame}{\hbox spread 1em{\hss\strut#1\hss}}}
\setMPtext{FunnyFrame}{}


\define\M{MusE}
\define[1]\Index{{\it #1}\marginpar{#1}\index{#1}}

\defineindenting[Cmdi][text=,separator=,width=fit,distance=1em]

\define[1]\Cmd{
  \Cmdi
  \framed[
     background=color,
     width=fit,
     align=right,
     backgroundcolor=lightgray,
     framecolor=blue]
     {\tt\space #1}}

\define[2]\CCmd{
  \Cmdi
  \framed[
     background=color,
     width=broad,
     align=right,
     backgroundcolor=lightgray,
     framecolor=blue]
     {\vbox{\hbox{\tt\space #1}\hbox{\tt\space #2}}}}


%\define\startdescription{\startpacked}
\define\startdescription{}
%\define\stopdescription{\stoppacked}
\define\stopdescription{}

\define[1]\Fig{\hbox{\externalfigure[pics/#1]}}

\define[2]\Screen{
      \placefigure[here][fig:#1]{#2}{\externalfigure[pics/#1][scale=1600]}
      }
\definedescription[Option][
      location=left,
      headstyle=bold,
      width=4em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\definedescription[Sc][
      location=left,
      headstyle=bold,
      width=4em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\definedescription[Filetype][
      location=left,
      headstyle=bold,
      width=6em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\definedescription[FileList][
      location=left,
      headstyle=bold,
      width=7em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\definedescription[Input][
      location=left,
      headstyle=bold,
      width=9em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\definedescription[InputN][
      location=left,
      headstyle=bold,
      width=6em,
      before={\startnarrower[left]\setupblank[0pt]},
      after={\stopnarrower\setupblank}]

\define[2]\Figure{
      \placefigure
         [#1][fig:#2]{}
         {\externalfigure[pics/#2]}
         }

\define[1]\Menu{
      \placefigure[right][fig:#1]{}
         {\externalfigure[pics/#1][scale=2000]}
         }

\definedescription[Opt][location=hanging,headstyle=bold,width=broad]

\component figurepath.tex

%----------------------------------------------------------
%     Body
%----------------------------------------------------------

\starttext
   \language[en]
   \mainlanguage[en]
   \startstandardmakeup[doublesided=no]
      \definebodyfont[10pt,11pt,12pt][rm][tfe=Regular at 48pt]
      \tfe\setupinterlinespace
      \hfill \color[red]{\M}\par
      \hfill \color[blue]{Manual}\par
      \vfill
      \rightaligned{\externalfigure[titlelogo]}
      \vfill
      \hfill \color[blue]{EN}\par
      \definebodyfont[10pt,11pt,12pt][rm][tfb=Regular at 24pt]
      \tfb\setupinterlinespace
      \hfill Version 1.0pre1\par
      \stopstandardmakeup

   \startstandardmakeup[page=no]
      \vfill
      \M\ is hosted on SourceForge:\par
      \type{http://mscore.sourceforge.net/}
      \blank[line]
      This document was created using \pdfTeX\ and the macro package
      \ConTeXt\.
      \blank
      \copyright 2006 Werner Schweer and Others
      \stopstandardmakeup

   \completecontent

\chapter{Introduction}
   \section{Where from and where to go}
      There's a long history of sequencers. In the beginning there were
      only analogue synthesizers, which could only be played live. The classical
      example is presumably the Moog. After the introduction of MIDI, the first
      devices appeared where music data could be saved and replayed, in short:
      Sequencers. To program these devices, i.e. to record and process music can
      rather be compared with assembler programming of computers than with making
      music. But soon the first sequencers for computers were developed. At
      first, one could only process MIDI data, since the corresponding hardware
      capacities were missing. But those developed at high speed and thus the
      quality of hardware - and what is most important in this case: sound
      cards - improved that much, that one could even do without external tape
      drives. Now multi-track audio on-line recordings were possible and there
      were even astounding possibilities for the post-editing of large projects.
      Hard to believe, but nowadays computers can do even more.
      Software-synthesizers in combination with software sequencers
      (\M\ for example!) offer apparently unlimited possibilities of
      variation. In fact, one can compose without even touching the wheel or
      the button of a "real" synthesizer. It will need time, however, until this
      software will be affordable, as the prices are immense. That's where \M\
      enters the game!

     \section{\M\ and its competitors}
      Of course there will always be "better" programs or not! This decision is
      due to strongly subjective criteria. On the one hand, it depends on what one
      is aiming at. On the other hand, it depends on individual technical knowledge
      in the field of synthesizers/sequencers. To the time that I write this article,
      there are unfortunately no commercial sequencers for Linux, not to speak of
      whole studios like Cubase or Logic. So the Linux-user can only choose between
      a parallel installation either to Mac (if one has a PPC architecture) or to
      Windows (in case of IBM Hardware). But where do those programs actually beat
      \M? Certainly not in their price because commercial, proprietary software
      is expensive. That's where programs like \M\ become interesting because
      everybody can have it for free. Furthermore they are "open source", which is
      another important point, because thereby the users get the opportunity of
      finding bugs themselves and doing away with them.

      Naturally, all projects start small. It's the same with \M. With \M,
      Linux enters a new dimension of MIDI and Audio processing. Together with
      Jack, even multi-track on-line recordings can be realized. In the the next
      few years \M\ will certainly evolve strongly and with some luck there will
      be an easier installation and more comfortable manuals.

     \section{Features of \M}

      Main features of \M:

      \startitemize[1,packed]
          \head Arranger
          	The arranger window structures a song into tracks and
            parts.

	    \head Pianoroll Editor

	    \head Drum Editor

          \head Mastertrack
            Allows you to edit tempo changes and time signatures

          \head Controller Editor
		Allows to graphically edit controller values.

          \head Recording
		Muse allows simultaneous midi and audio recording. 
            Midi can be recorded non realtime step by step.

	    \head Editing
          	Midi and audio editing can be done even during play.

	    \head LADSPA, JACK etc. compatible

        \stopitemize


\chapter{Invoking \M}
   \section{Invoking \M}
      \M\ is invoked from the command line by typing in:

      \Cmd{muse}

      Optionally, you can use command line options of the form:

      \Cmd{muse <options> <midifile>}

      \definedescription[Mops][location=left,headstyle=bold]

      \Mops{\tt <options>:}
            see below for a list of available options.
      \Mops{\tt <midifile>:}
            can be either a standard MIDI file or a \M\ file
            ({\tt *.med, *.med.gz or *.med.bz2}).

   \section{Command Line Options}

      \M\ accepts some options as listed below:

      \blank[medium]
      \Option{ -v}print version\par
      \Option{ -m}MIDI only mode\par
      \Option{ -d}debug mode: no threads, no RT\par
      \Option{ -D}debug mode: enable some debug messages\par
      \Option{ -i}debug mode: trace midi Input\par
      \Option{ -o}debug mode: trace midi Output\par
      \Option{ -p}don't load LADSPA plugins\par
      \blank[big]

      Example:

       \Cmd{muse -i mysong.med}

       will add trace midi input and open mysong.med on startup.

   \section{File types used by \M}

         \Filetype{\textasciitilde/.MusE}
            \M\ Configuration File (``\textasciitilde�� refers to your home directory
            aka "/home/tux")\par
         \Filetype{\textasciitilde/.musePrj}
            Hidden Project File; stores list of last projects\par
         \Filetype{.med}
            \M\ song file; internal \M format\par
         \Filetype{.mid}
            midi file; can be imported or exported\par
         \Filetype{.kar}
            karaoke: midi file with additional information; some types
            can be imported\par

\component projects.tex
\component structure.tex
\component miditracks.tex

\startappendices
   \component ../gpl.tex
   \completeindex
   \stopappendices
\stoptext