Copy local state in AudioRegionView copy constructor. Fixes #4047.
[ardour2.git] / manual / xml / video_synchronization_via_mtc.xml
blob3b5af0113de49ac5f358f1f096cbb90aa57bc062
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-video-sync-via-mtc">
8   <title>Video Synchronization via MTC</title>
9   <note>
10     <para>
11       if you do not have any MIDI I/O available on your system, then it is
12       impossible to use MIDI Time Code.
13     </para>
14   </note>
16   <section id="ardour-as-mtc-master">
17     <title>Using Ardour as an MTC Master</title>
18     <para></para>
19   </section>
21   <section id="ardour-as-mtc-slave">
22     <title>Using Ardour as an MTC Slave</title>
23     <orderedlist>
24       <listitem>
25         <para>
26           ensure that you have defined at least one MIDI port in your
27           ardour.rc file. The default configuration includes a single port
28           that is part of the ALSA MIDI router/sequencer system.
29         </para>
30       </listitem>
31       <listitem>
32         <para>
33           open the Options Editor.
34         </para>
35       </listitem>
36       <listitem>
37         <para>
38           switch to the <guilabel>MIDI</guilabel> tab.
39         </para>
40       </listitem>
41       <listitem>
42         <para>
43           if you have more than one MIDI port, click on the button in the
44           <guilabel>MTC</guilabel> column for the port you plan where MTC
45           will be received.
46         </para>
47       </listitem>
48       <listitem>
49         <para>
50           if you have more than one MIDI port, then you should probably
51           click on the button in the <guilabel>MMC</guilabel> column for the
52           port you plan where MMC will be received. This is not required,
53           but many devices that send MTC also send MIDI Machine Control
54           commands and may not be able to control Ardour correctly unless
55           Ardour is also responding to MMC.
56         </para>
57       </listitem>
58       <listitem>
59         <para>
60           switch to the <guilabel>Sync</guilabel> tab. Open the
61           <guilabel>Positional Sync</guilabel> selector to see the list of
62           possible sources of timeline synchronization:
63         </para>
65         <variablelist>
66           <title>Syncronization Options</title>
67           <varlistentry>
68             <term>Internal</term>
69             <listitem>
70               <para>
71                 use Ardour's own sense of position and time
72               </para>
73             </listitem>
74           </varlistentry>
76           <varlistentry>
77             <term>Slave to JACK</term>
78             <listitem>
79               <para>
80                 follow JACK Transport information
81               </para>
82             </listitem>
83           </varlistentry>
85           <varlistentry>
86             <term>Slave to MTC</term>
87             <listitem>
88               <para>
89                 follow incoming MTC information
90               </para>
91             </listitem>
92           </varlistentry>
93         </variablelist>
94       </listitem>
95       <listitem>
96         <para>
97           choose <guimenuitem>Slave to MTC</guimenuitem>
98         </para>
99       </listitem>
100     </orderedlist>
101     <para>
102       To test that Ardour is now slaved, press the
103       <guibutton>Play</guibutton> button on the MTC master, or some other
104       action that will cause it to start transmitting MTC. Ardour should
105       jump to the position indicated by incoming MTC, and start playing.
106       Press <guibutton>Stop</guibutton> on the master (or do some other
107       action that will cause the master to stop sending MTC) and Ardour
108       should stop at the precise time indicated by the master.
109     </para>
110   </section>
111 <!--
112         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
113                 href="Some_Subsection.xml" />
114         -->
115 </section>