~ubuntu-branches/ubuntu/vivid/ardour/vivid-proposed

« back to all changes in this revision

Viewing changes to manual/xml/jack.xml

  • Committer: Package Import Robot
  • Author(s): Felipe Sateler, Jaromír Mikeš, Felipe Sateler
  • Date: 2014-05-22 14:39:25 UTC
  • mfrom: (29 sid)
  • mto: This revision was merged to the branch mainline in revision 30.
  • Revision ID: package-import@ubuntu.com-20140522143925-vwqfo9287pmkrroe
Tags: 1:2.8.16+git20131003-3
* Team upload

[ Jaromír Mikeš ]
* Add -dbg package

[ Felipe Sateler ]
* Upload to experimental

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" standalone="no"?>
 
2
 
 
3
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
 
4
 
 
5
]>
 
6
 
 
7
<section id="sn-configuring-jack">
 
8
  <title>Getting Audio In, Out and Around Your Computer</title>
 
9
  <para>
 
10
    Before you can begin to use Ardour, you will need to get the audio
 
11
    input/output capabilities of your system working and properly
 
12
    configured. There are two aspects to this process: getting your audio
 
13
    interface (soundcard) working, and configuring it to work with the Jack
 
14
    Audio Connection Kit (<ulink url="http://jackaudio.org/">JACK</ulink>).
 
15
  </para>
 
16
 
 
17
  <section id="sn-jack">
 
18
    <title>JACK</title>
 
19
    <para>
 
20
      It is extremely important to understand that Ardour does not interact
 
21
      directly with your audio interface when it is running. Instead, all of
 
22
      the audio data signals that Ardour receives and generates are sent to
 
23
      and from JACK, a piece of software that routes audio data between an
 
24
      audio interface and audio applications, in real time.
 
25
    </para>
 
26
 
 
27
    <para>
 
28
      Traditionally, most of the audio sources that you would want to
 
29
      record, as well as a lot of the more significant effects processing,
 
30
      existed outside the computer. Consequently one of the biggest issues
 
31
      in integrating a computer into the operation of the studio is how to
 
32
      move audio data in and out of the computer.
 
33
    </para>
 
34
 
 
35
    <para>
 
36
      However, it is becoming increasingly common for studios to use audio
 
37
      sources and effects processing that are comprised completely of
 
38
      software, quite often running on the same machine as an audio
 
39
      sequencer or digital audio workstation (DAW). A new problem arises in
 
40
      such situations, because moving audio in and out of the DAW no longer
 
41
      involves your hardware audio interface. Instead, data has to be moved
 
42
      from one piece of software to another, preferably with the same kind
 
43
      of sample synchronisation you’d have in a properly configured
 
44
      digital hardware system. This is a problem that has been solved at
 
45
      least a couple of times (ReWire from PropellerHeads and DirectConnect
 
46
      from Digidesign are the two most common examples), but JACK is a new
 
47
      design developed as an open source software project, and is thusly
 
48
      available for anyone to use, learn from, extend, *fix or modify.
 
49
    </para>
 
50
 
 
51
    <para>
 
52
      New users may not initially realize that by using Jack, their computer
 
53
      becomes an extremely flexible and powerful audio tool - especially
 
54
      with Ardour acting as the ’heart’ of the system.
 
55
    </para>
 
56
  </section>
 
57
 
 
58
  <section id="getting-audio-working">
 
59
    <title>Getting Your Audio Interface Working</title>
 
60
    <note>
 
61
      <para>
 
62
        Although Ardour runs on OS X as well as Linux, this documentation
 
63
        describes only a Linux (ALSA) system. The issues faced on OS X tend
 
64
        to be entirely different, and are centered mostly on JACK. There are
 
65
        also alternative audio device driver families for Linux but they are
 
66
        also not discussed here.
 
67
      </para>
 
68
    </note>
 
69
 
 
70
    <para>
 
71
      Getting your audio interface working can be the hardest part of
 
72
      setting your computer up to run Ardour, or it could be one of the
 
73
      easiest. The level of difficulty you will face depends on the type of
 
74
      audio interface ("soundcard") you are using, the operating system
 
75
      version you are using, and your own understanding of how it all works.
 
76
    </para>
 
77
 
 
78
    <para>
 
79
      In an ideal world, your computer already has a working audio
 
80
      interface, and all you need do is to start up qjackctl and run JACK.
 
81
      You can determine if you face this ideal situation by doing a few
 
82
      simple tests on your machine. The most obvious test is whether
 
83
      you’ve already heard audio coming out of your computer. If you are
 
84
      in this situation, you can skip ahead to
 
85
      <xref linkend="selecting-capture-source"/>.
 
86
    </para>
 
87
  </section>
 
88
 
 
89
  <section id="checking-for-an-audio-interface">
 
90
    <title>Checking For an Audio Interface</title>
 
91
    <para>
 
92
      If you’ve never tried to play audio on your computer before, you
 
93
      should use a basic playback program such as play, aplay or possibly
 
94
      xmms. Find an audio file on your machine (<command>locate
 
95
      .wav</command> may help here), and try to play it. There are several
 
96
      possibilities:
 
97
    </para>
 
98
 
 
99
    <itemizedlist>
 
100
      <listitem>
 
101
        <para>
 
102
          You may get an error from the program
 
103
        </para>
 
104
      </listitem>
 
105
 
 
106
      <listitem>
 
107
        <para>
 
108
          You may hear nothing
 
109
        </para>
 
110
      </listitem>
 
111
 
 
112
      <listitem>
 
113
        <para>
 
114
          You may hear something, but its too quiet
 
115
        </para>
 
116
      </listitem>
 
117
 
 
118
      <listitem>
 
119
        <para>
 
120
          you may hear something from the wrong loudspeakers.
 
121
        </para>
 
122
      </listitem>
 
123
    </itemizedlist>
 
124
  </section>
 
125
 
 
126
  <section id="selecting-capture-source">
 
127
    <title>Selecting Capture Source</title>
 
128
    <para>
 
129
      Many audio interfaces, particularly the cheaper varieties that are
 
130
      often found built into computers, have ways to plug in both
 
131
      microphones and instruments or other audio equipment to be recorded.
 
132
      This immediately poses a question: how does Ardour (or any software)
 
133
      know which signal to record, the one coming into the microphone input,
 
134
      or the one arriving at the "line in" socket? The same question arises
 
135
      also for "high-end" audio interfaces, though in different ways.
 
136
    </para>
 
137
 
 
138
    <para>
 
139
      The short answer is: Ardour doesn’t. Instead, this is a choice you
 
140
      have to make using a program a program that understands how to control
 
141
      the mixing hardware on the audio interface. Linux/ALSA has a number of
 
142
      such programs: alsamixer, gamix, aumix, kmix are just a few of them.
 
143
      Each of them offers you a way to select which of the possible
 
144
      recordable signals will be used for as the "capture source". How you
 
145
      select the preferred signal varies from program to program, so you
 
146
      will have to consult the help documentation for whichever program you
 
147
      choose to use.
 
148
    </para>
 
149
 
 
150
    <para>
 
151
      There are also a few programs that offer ways to control just one
 
152
      particular kind of audio interface. For example, the
 
153
      <application>hdspmixer</application> program offers control over the
 
154
      very powerful matrix mixer present on several RME audio interface.
 
155
      <application>envy24ctrl</application> does the same for a number of
 
156
      interfaces built around the common ice1712/envy24 chipset, found in
 
157
      devices from M-Audio, Terratec and others. Please note that this quite
 
158
      similar to the situation for Windows and MacOS users, where each audio
 
159
      interface often comes with its own control program that allows certain
 
160
      critical configuration choices to be made.
 
161
    </para>
 
162
 
 
163
    <section id="problems-with-input-signal">
 
164
      <title>"I don’t get any signal when I record …"</title>
 
165
      <para>
 
166
        The most common problem for first-time audio users on Linux is to
 
167
        try to record something and get no signal at all, or alternatively,
 
168
        a very low signal. The low signal problem typically arises from one
 
169
        or more of the following issues:
 
170
      </para>
 
171
 
 
172
      <itemizedlist>
 
173
        <listitem>
 
174
          <para>
 
175
            a microphone input plugged into the "line in" socket of the
 
176
            interface. The signal levels delivered by microphones are very
 
177
            small, and require amplification before they can be used by most
 
178
            audio circuitry. In professional recording studios, this is done
 
179
            using a dedicated box called a "pre-amplifier". If your audio
 
180
            interface has a "mic input" socket, then it has its own
 
181
            pre-amplifier built in, although its probably not a very good
 
182
            one. If you make the mistake of plugging a microphone into the
 
183
            "line in" socket, you will get either an inaudible or very quiet
 
184
            signal.
 
185
          </para>
 
186
        </listitem>
 
187
 
 
188
        <listitem>
 
189
          <para>
 
190
            the wrong capture source selected in the audio interface’s
 
191
            hardware mixer (see above)
 
192
          </para>
 
193
        </listitem>
 
194
 
 
195
        <listitem>
 
196
          <para>
 
197
            the "capture" gain level in the audio interface’s hardware
 
198
            mixer is turned down too low. You will need to use a hardware
 
199
            mixer application (as described above) to increase this.
 
200
          </para>
 
201
        </listitem>
 
202
      </itemizedlist>
 
203
 
 
204
      <note>
 
205
        <para>
 
206
          You will notice in the mixer strip for each track in ardour that
 
207
          you can change the selection of the monitoring source between
 
208
          input/pre/post. Adjusting the fader while watching the ’input’
 
209
          levels will NOT have any affect on the levels. As mentioned above,
 
210
          ardour is dependent on external mixer settings for a source level.
 
211
        </para>
 
212
      </note>
 
213
    </section>
 
214
  </section>
 
215
 
 
216
  <section id="monitoring-choices">
 
217
    <title>Monitoring Choices</title>
 
218
    <para>
 
219
      Its unfortunate that we have to raise this issue at a point in the
 
220
      manual where you, the reader, may not even knoiw what "monitoring"
 
221
      means. However, it is such an absolutely critical aspect of using any
 
222
      digital audio workstation that we need to at least cover the basics
 
223
      here. The only people who don’t need to care about monitoring are
 
224
      those who will never use ardour to record a live performance (even on
 
225
      performed using a software synthesizer).
 
226
    </para>
 
227
 
 
228
    <para>
 
229
      Monitoring is the term we use to describe listening to what ardour is
 
230
      recording. If you are playing a guitar and recording it with ardour,
 
231
      you can probably hear the guitar’s own sound, but there are many
 
232
      situations where relying on the sound of the instrument is completely
 
233
      inadequate. For example, with an electronic instrument, there is no
 
234
      sound until the electrical signal that it generates has been processed
 
235
      by an amplifier and fed to a loudspeaker. But if Ardour is recording
 
236
      the instrument’s signal, what is responsible for sending it to the
 
237
      amp+loudspeakers? It can get a lot more complex than that: if you are
 
238
      recording multiple performers at the same time, each performer needs
 
239
      to hear their own playing/singing, but they also probably need to hear
 
240
      some of their colleagues’ sound as well. You might be overdubbing
 
241
      yourself - playing a new line on an instrument while listening to
 
242
      tracks you’ve already recorded - how do you hear the new material as
 
243
      well as the existing stuff?
 
244
    </para>
 
245
 
 
246
    <para>
 
247
      Well, hopefully, you’re convinced that there are some questions to
 
248
      be dealt with surrounding monitoring, see
 
249
      <xref linkend="sn-monitoring"/> for more in depth information.
 
250
    </para>
 
251
  </section>
 
252
 
 
253
  <section id="using-multiple-soundcards">
 
254
    <title>Can I use multiple soundcards</title>
 
255
    <para>
 
256
      There are really lots of great reasons why you should not even attempt
 
257
      to do this. But seriously, save your money for a while and buy
 
258
      yourself a properly designed multichannel soundcard.
 
259
    </para>
 
260
  </section>
 
261
 
 
262
  <section id="qjackctl">
 
263
    <title>Qjackctl</title>
 
264
    <para>
 
265
      JACK itself does not come with graphical user interface - to start
 
266
      JACK and control it you need to have access to a command line and a
 
267
      basic knowledge of Unix-like operating systems. However,
 
268
      <ulink url="http://qjackctl.sourceforge.net/">qjackctl</ulink> is a
 
269
      wonderful application that wraps JACK up with a graphical interface
 
270
      that is both nice to look at and useful at same time. qjackctl is the
 
271
      recommended way of using JACK.
 
272
    </para>
 
273
    <mediaobject>
 
274
      <imageobject>
 
275
        <imagedata fileref="images/qjackctl.png"/>
 
276
      </imageobject>
 
277
    </mediaobject>
 
278
    <para>
 
279
      You should be able to start qjackctl from the “application menu”
 
280
      of your system, typically found on the panel/appbar/dock or whatever
 
281
      its called that lives at the top/bottom/left/right of your screen.
 
282
    </para>
 
283
 
 
284
    <para>
 
285
      [ need screenshot of GNOME/KDE/OSX menus here ]
 
286
    </para>
 
287
  </section>
 
288
<!--
 
289
        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 
290
                href="Some_Subsection.xml" />
 
291
        -->
 
292
</section>