Add a couple of missing attach_buffers() calls after _ports has been changed. I...
[ardour2.git] / manual / xml / creating_a_new_session.xml
blobd969f04d78d3425533ad38812dc7c15eae6288dc
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-creating-a-new-session">
8   <title>Creating a new Session</title>
9   <para>
10     The first step in starting a new project with Ardour is to create a new
11     session. When you do this, Ardour creates a new folder named after your
12     session, and stores differents kinds of files and subfolders within it.
13     The two most important subfolders are <filename>sounds</filename> which
14     contains all the audio recorded or imported for the session and
15     <filename>automation</filename> which contains automation data for
16     various parts of the session.
17   </para>
19   <para>
20     When you start ardour without specifying an existing session, it
21     automatically brings up the new session dialog. If you want to create a
22     new session at other times, choose <menuchoice>
23     <guimenu>Session</guimenu> <guisubmenu>New Session</guisubmenu>
24     </menuchoice>.
25   </para>
26   <mediaobject>
27     <imageobject>
28       <imagedata fileref="images/session_control.png"/>
29     </imageobject>
30   </mediaobject>
31   <para>
32     Enter a name for the new session. You can use any characters you like as
33     part of the name, but you should know that more or less anything other
34     than alphabetic and numeric characters will be converted to underscores
35     to form the name of the session folder.
36   </para>
38   <para>
39     Next, choose where you want to store the new session folder. If its not
40     in your current working folder, click on the browse button to expand the
41     file selector, and then navigate to your desired location.
42   </para>
43   <mediaobject>
44     <imageobject>
45       <imagedata fileref="images/new_session_select_directory.png"/>
46     </imageobject>
47   </mediaobject>
48   <section id="new-session-io">
49     <title>Input and Output Configuration</title>
50     <para>
51       Next, configure the basic IO setup for the session. You have several
52       choices here, and doing nothing is one of them. This will give you a
53       session that includes:
54     </para>
56     <itemizedlist>
57       <listitem>
58         <para>
59           a stereo master bus with its outputs connected to the first two
60           outputs of your audio interface
61         </para>
62       </listitem>
64       <listitem>
65         <para>
66           all new track will have their outputs sent to the master bus
67         </para>
68       </listitem>
70       <listitem>
71         <para>
72           all new track inputs will be connected to Ardour’s best guess at
73           the relevant input of your audio interface.
74         </para>
75       </listitem>
76     </itemizedlist>
78     <para>
79       However, if you want more control over this, click on the expander
80       next to <guilabel>Advanced options</guilabel> label to show the full
81       set of options:
82     </para>
83     <mediaobject>
84       <imageobject>
85         <imagedata fileref="images/new_session_advanced_tab.png"/>
86       </imageobject>
87     </mediaobject>
88     <para>
89       There are two options available for track input configuration:
90       autoconnect or manual. If you select autoconnect (the default) then
91       new tracks will be connected to an input of your audio interface. If
92       you select manual, it will be up to you to configure the input for
93       each track.
94     </para>
96     <para>
97       For output, the first two choices are whether to have control and
98       master outs. Most DAWs assume the presence of master outs, and few (if
99       any) offer control outs.
100     </para>
102     <section id="new-session-master-outs">
103       <title>Master Outputs</title>
104       <para>
105         A Master out is a bus to which all (or most) tracks and other busses
106         send their output. It provides a convenient single point of control
107         for the output of ardour, and is a typical location for global
108         effects. Because of this, using master outs is enabled by default,
109         and the master out bus is setup to be stereo (2 inputs, 2 outputs).
110         However, if you are feeding Ardour’s output through a hardware
111         mixing console, you may not want master outs. In such cases, disable
112         them by clicking on the radio button next to “Use master outs”.
113         Alternatively, you may want some other channel configuration for the
114         master output (for example, 8 channel surround sound). Select this
115         by using the clickbox (see clickboxes) next to the radio button.
116       </para>
117     </section>
119     <section id="new-session-control-outs">
120       <title>Control Outputs</title>
121       <para>
122         Control outs are unusual for DAWs, but because Ardour is designed to
123         be as flexible as possible, and in particular is intended to be
124         useful as a live mixer, they are included here. Using control outs
125         provides you with a dedicated bus to which all tracks have an
126         additional output connection. As well as feeding their regular
127         outputs, they send data to the control outs as well. In an
128         unadjusted session, this means that the control outs carry the same
129         signal as the master outs. However, once you start soloing tracks,
130         the control outs will carry only soloed tracks while the master outs
131         continue to carry the entire mix. A typical use of control outs is
132         when doing live stage work. The mix engineer will be listening to
133         the control outs, and can therefore solo tracks without affecting
134         the signal being sent to the master outs (the main speakers).
135       </para>
136     </section>
137   </section>
138 </section>