Add a couple of missing attach_buffers() calls after _ports has been changed. I...
[ardour2.git] / manual / xml / mixer_window.xml
blob8346773ee87f697d8159bb074d83c55740cca99d
1 <?xml version="1.0" standalone="no"?>
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
5 ]>
7 <section id="sn-mixer-window">
8   <title>The Mixer</title>
9   <para>
10     The mixer window provides a view of the session that mimics a
11     traditional hardware mixing console. Rather than focusing on the
12     arranging of regions along a timeline, the mixer is designed to allow
13     you to manipulate the signal flow elements of a session - gain control,
14     plugins, bussing and so forth.
15   </para>
17   <para>
18     The left area of the mixer contains three small vertical panes which
19     allow various operations to be made on the larger area, which of course
20     represents a mixing console.
21   </para>
23   <para>
24     The lines that outline the three smaller panes all have a small square
25     near their vertices. This square can be used to resize the four panes
26     that form the mixer window. Dragging each of these squares with the left
27     mouse button will move the border.
28   </para>
30   <section id="mixer-window-layout">
31     <title>Mixer Window Layout</title>
32     <mediaobject>
33       <imageobject>
34         <imagedata fileref="images/mixer.png"/>
35       </imageobject>
36     </mediaobject>
37     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
38                         href="mixer_strips.xml" />
39     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
40                         href="mixer_strip_list.xml" />
41     <section id="mixer-window-group-list">
42       <title> Group List </title>
43       <para>
44         The group list pane provides an interface to create and control the
45         state of the mix groups present on the mixer. Mix groups provide a
46         method of linking faders together, so that a movement on one fader
47         will translate to all the other faders in the group.
48       </para>
50       <para>
51         A new session will contail one group, called all. This preset group
52         refers to all mixer strips?? <emphasis>what is 'all' doing
53         here?</emphasis> Any new groups you create will be listed in this
54         pane. Left clicking the <guibutton>Mix Groups</guibutton> button
55         will open a window titled <literal>Name for a new mix
56         group</literal>, which contains a dark text area. Enter a name for
57         your new mix group in the text area. Left clicking
58         <guibutton>cancel</guibutton> will close the <literal>Name for a new
59         mix group</literal> window. The group list will be unaffected. Left
60         clicking <guibutton>OK</guibutton> will create a new mix group. The
61         new group will be listed in the group list pane with an empty box
62         next to it's name. All mixer strips will now contain the name of the
63         new group in their <guibutton>group</guibutton> button. Selecting
64         the new group in a mixer strip will assign control of that channel's
65         gain fader to the selected group, but <emphasis>only if the group is
66         active</emphasis>. Left clicking the box next to the group name will
67         activate the group.
68       </para>
70       <para>
71         At the bottom right of the group list, a square box provides a
72         method for resizing the pane. Holding down the left mouse button
73         while dragging the square vertically will move the lower border of
74         the group list.
75       </para>
76     </section>
78     <section id="mixer-window-snapshot-list">
79       <title> Snapshot List </title>
80       <para>
81         Track Name Group Button Input Selector Solo Button Mute Button
82         Polarity Button Track Speed Control Record Enable Button Automation
83         Record Button Automation Playback Button Pre/Post Button Gain
84         Display Unit Selector Gain Level Display Peak Meter Gain Fader
85         Meters Output Selector
86       </para>
87     </section>
88   </section>
89 </section>