Add further help manual pages
[entangle:entangle.git] / help / C / multiple-cameras.page
1 <!-- -*- xml -*- -->
2 <page xmlns="http://projectmallard.org/1.0/"
3       type="topic"
4       id="multiple-cameras">
5   <info>
6     <link type="guide" xref="index#advanced"/>
7
8     <desc>Controlling multiple cameras at once</desc>
9   </info>
10
11   <title>Multiple cameras</title>
12
13   <p>
14     Most users will only need to control a single camera at once, but
15     <app>Entangle</app> does not have any restrictions on concurrent
16     usage. When it starts up, it will scan for USB connected cameras
17     and open a new window for each camera it is able to connect to.
18     The settings for each camera can be controlled independantly
19     and images captured from each camera as required.
20   </p>
21
22   <p>
23     If an additional camera is connected while <app>Entangle</app>
24     is already running, further windows can be opened. This can
25     be done using the <guiseq><gui>Windows</gui><gui>New Window</gui></guiseq>
26     menu option or the <keyseq><key>Ctrl</key><key>N</key></keyseq>
27     keyboard shortcut. Once the additional window is open, the
28     <guiseq><gui>Camera</gui><gui>Connect</gui></guiseq> menu
29     option can be used to select which new camera to connect the
30     window to. This can be repeated as many times as required.
31   </p>
32
33   <p>
34     As an alternative to opening multiple windows, it is possible to
35     disconnect an existing window from the camera it is using. This
36     is accomplished using the <guiseq><gui>Camera</gui><gui>Disconnect</gui></guiseq>
37     menu option. Once disconnected, a new camera connection can be opened
38     using the same menu option mentioned in the previous paragraph.
39   </p>
40
41   <p>
42     In some circumstances it may be desirable to trigger capture on
43     multiple simultaneously. If the <guiseq><gui>Windows</gui><gui>Synchronize Capture</gui></guiseq>
44     menu checkbox is selected, then when capture is triggered in one window,
45     <app>Entangle</app> will repeat the action on all other windows at
46     the same time.
47   </p>
48 </page>