Distributed Recording - Revision history

Vmaslov at 14:05, 5 February 2019

2019-02-05T14:05:48Z

Andrew at 14:57, 14 December 2016

2016-12-14T14:57:12Z

Vmaslov: /* Preparations */

2016-06-05T18:54:07Z

‎Preparations

Vmaslov at 13:34, 18 May 2015

2015-05-18T13:34:14Z

Vmaslov at 13:26, 18 May 2015

2015-05-18T13:26:06Z

Vmaslov at 22:42, 6 March 2015

2015-03-06T22:42:44Z

Vmaslov at 17:52, 13 January 2015

2015-01-13T17:52:31Z

Vmaslov at 17:51, 13 January 2015

2015-01-13T17:51:54Z

Andrew at 12:39, 29 December 2014

2014-12-29T12:39:49Z

Andrew: screenshots

2014-12-29T12:01:31Z

screenshots

@@ Line 7: / Line 7: @@
 * Only single '''MS Kinect 2 (Kinect for Xbox One)''' sensor is supported by drivers and libraries from Microsoft ('''Microsoft Kinect SDK 2.0''')
 *: This is why multiple computers are required to record from multiple '''MS Kinect 2 (Kinect for Xbox One)''' sensors. And [[Distributed Recording]] allows to obtain one synchronized video in this case.
 * Each '''MS Kinect 1 / ASUS Xtion / PrimeSense''' depth sensor should be connected to a separate USB controller
 *: That is to record from two such depth sensors at least two USB controllers are required. For three depth sensors &mdash; three USB controllers. Many laptops and some desktop PCs don't have three USB controllers. By using [[Distributed Recording]] one can split the sensors between several computers.

@@ Line 5: / Line 5: @@
 This feature allows to overcome the following restrictions and limitations:
-* Only single '''MS Kinect 2''' sensor is supported by drivers and libraries from Microsoft ('''Microsoft Kinect SDK 2.0''')
+* Only single '''MS Kinect 2 (Kinect for Xbox One)''' sensor is supported by drivers and libraries from Microsoft ('''Microsoft Kinect SDK 2.0''')
-*: This is why multiple computers are required to record from multiple '''MS Kinect 2''' sensors. And [[Distributed Recording]] allows to obtain one synchronized video in this case.
+*: This is why multiple computers are required to record from multiple '''MS Kinect 2 (Kinect for Xbox One)''' sensors. And [[Distributed Recording]] allows to obtain one synchronized video in this case.
 * Each '''MS Kinect 1 / ASUS Xtion / PrimeSense''' depth sensor should be connected to a separate USB controller
 *: That is to record from two such depth sensors at least two USB controllers are required. For three depth sensors &mdash; three USB controllers. Many laptops and some desktop PCs don't have three USB controllers. By using [[Distributed Recording]] one can split the sensors between several computers.

@@ Line 22: / Line 22: @@
 *:{{Important|For incoming connections, [[iPi Recorder]] uses TCP ports '''31415''' and '''31416''' if they are available. Otherwise, the program automatically switches to a random port number instead.}}
 *:{{Tip|If there is no existing network at the stage area, you can easily create one with most modern smartphones. A phone usually has an option in settings to act as Wi-Fi access point (intended primarily for sharing a mobile internet connection). Turn this option on ([https://support.apple.com/en-us/HT204023 iPhone], [http://www.dummies.com/how-to/content/how-to-create-a-mobile-hotspot-with-an-android-pho.html Android], [https://www.windowsphone.com/en-us/how-to/wp8/connectivity/share-my-connection Windows Phone]) and connect all PCs to the phone's Wi-Fi network with regular Windows means. Be aware that acting as Wi-Fi access point drains phone's battery quickly, so take care of it.}}
-*:{{Note|Internet connection is not required for [[Distributed Recording]].}}
+*:{{Note|Internet connection is not required for [[Distributed Recording]]. Using a smartphone for the purpose of distributed recording does not drain your mobile Internet traffic.}}
 *:{{Note|During distributed recording, it is recommended to shutdown other programs producing constant network traffic like BitTorrent clients, instant messengers etc.}}
 * For each computer:

@@ Line 21: / Line 21: @@
 * All computers should be connected to one and the same local network (LAN). In most cases it's most convenient to use Wi-Fi router for that purpose.
 *:{{Important|For incoming connections, [[iPi Recorder]] uses TCP ports '''31415''' and '''31416''' if they are available. Otherwise, the program automatically switches to a random port number instead.}}
-*:{{Tip|If there is no existing network at the stage area, you can easily create one with most modern smartphones. A phone usually has an option in settings to act as Wi-Fi access point (intended primarily for sharing a mobile internet connection). Turn this option on ([https://support.apple.com/en-us/HT204023 iPhone], [http://www.dummies.com/how-to/content/how-to-create-a-mobile-hotspot-with-an-android-pho.html Android], [https://www.windowsphone.com/en-us/how-to/wp8/connectivity/share-my-connection Windows Phone]) and connect all PCs to the phone's Wi-Fi network with regular Windows means.}}
+*:{{Tip|If there is no existing network at the stage area, you can easily create one with most modern smartphones. A phone usually has an option in settings to act as Wi-Fi access point (intended primarily for sharing a mobile internet connection). Turn this option on ([https://support.apple.com/en-us/HT204023 iPhone], [http://www.dummies.com/how-to/content/how-to-create-a-mobile-hotspot-with-an-android-pho.html Android], [https://www.windowsphone.com/en-us/how-to/wp8/connectivity/share-my-connection Windows Phone]) and connect all PCs to the phone's Wi-Fi network with regular Windows means. Be aware that acting as Wi-Fi access point drains phone's battery quickly, so take care of it.}}
 *:{{Note|Internet connection is not required for [[Distributed Recording]].}}
 *:{{Note|During distributed recording, it is recommended to shutdown other programs producing constant network traffic like BitTorrent clients, instant messengers etc.}}

@@ Line 19: / Line 19: @@
 * Install [[iPi Recorder]] on each computer.
 *:{{Note|[[iPi Recorder]] is free thus you can install it on any number of computers independent on license of [[iPi Mocap Studio]].}}
-* All computers should be connected to one and the same local network (LAN). In most cases it's most convenient to use Wi-Fi router for it.
+* All computers should be connected to one and the same local network (LAN). In most cases it's most convenient to use Wi-Fi router for that purpose.
 *:{{Important|For incoming connections, [[iPi Recorder]] uses TCP ports '''31415''' and '''31416''' if they are available. Otherwise, the program automatically switches to a random port number instead.}}
-*:{{Tip|You can use modern smart phone to provide Wi-Fi access point.}}
+*:{{Tip|If there is no existing network at the stage area, you can easily create one with most modern smartphones. A phone usually has an option in settings to act as Wi-Fi access point (intended primarily for sharing a mobile internet connection). Turn this option on ([https://support.apple.com/en-us/HT204023 iPhone], [http://www.dummies.com/how-to/content/how-to-create-a-mobile-hotspot-with-an-android-pho.html Android], [https://www.windowsphone.com/en-us/how-to/wp8/connectivity/share-my-connection Windows Phone]) and connect all PCs to the phone's Wi-Fi network with regular Windows means.}}
 *:{{Note|Internet connection is not required for [[Distributed Recording]].}}
 *:{{Note|During distributed recording, it is recommended to shutdown other programs producing constant network traffic like BitTorrent clients, instant messengers etc.}}

@@ Line 36: / Line 36: @@
 *:[[File:distributed-recording-slave-network-selection.png|center]]
 * On master computer click '''Connect to Slaves''' button. In the '''Select Slaves for Distributed Recording''' dialog you should see all your slave computers. Select slave computers to be used for recording and click '''OK'''.
-*:[[File:distributed-recording-connect-to-slaves.png|center]]
+*:[[File:distributed-recording-connect-to-slaves.png|center]]<br/>[[File:distributed-recording-select-slaves-dlg.png|center]]
-*:[[File:distributed-recording-select-slaves-dlg.png|center]]
 * At the bottom of [[iPi Recorder]] window you'll see a panel with the information about connected slaves.
 *:[[File:distributed-recording-slave-statuses.png|center]]
@@ Line 62: / Line 61: @@
 To perform manual merging click '''Merge Videos''' button on the home screen of [[iPi Recorder]]. Select all [[.iPiVideo File Extension|iPiVideo]] files to combine and click the '''MERGE''' button.
-[[File:distributed-recording-manual-merge.png|center]]
+[[File:distributed-recording-merge-videos.png|center]]<br/>[[File:distributed-recording-manual-merge.png|center]]
 {{Note|Manual merging can be performed only for [[.iPiVideo File Extension|iPiVideo]] files produced by one [[Distributed Recording]] session. If you're selecting [[.iPiVideo File Extension|iPiVideo]] files from different recording sessions, you'll get an error message.}}

@@ Line 18: / Line 18: @@
 * Prepare as many computers as you need to record from all desired devices (cameras, sensors, controllers).
 * Install [[iPi Recorder]] on each computer.
 * All computers should be connected to one and the same local network (LAN). In most cases it's most convenient to use Wi-Fi router for it.
 *:{{Note|You can use modern smart phone to provide Wi-Fi access point.}}
@@ Line 31: / Line 32: @@
 * One computer will control other(s). This computer is called ''Master''. Other(s) are called ''Slave''(s).
 * You can choose any computer as master. On other computer(s) click '''Enter Slave Mode''' button. After that these [[iPi Recorder]]s are slaves and will be controlled from master [[iPi Recorder]] as soon as it connects to them.
-* On master computer click '''Connect to Slaves''' button. In the dialog '''Select Slaves for Distributed Recording''' you should see all your slave computers. Select slave computers to be used for recording and click '''OK'''.
+*:[[File:distributed-recording-enter-slave-mode.png|center]]
 * At the bottom of [[iPi Recorder]] window you'll see a panel with the information about connected slaves.
 * Now you can start and stop recording on master computer as usual. In this case recording will be synchronously started and stopped on all computers involved in [[Distributed Recording]].
 * During recording each computer records to its own [[.iPiVideo File Extension|iPiVideo]] file on its own disk drive to the folder specified in the field '''Path''' on the '''RECORD''' tab. File names will be as follows:
@@ Line 43: / Line 50: @@
 All [[.iPiVideo File Extension|iPiVideo]] files produced during [[Distributed Recording]] should be collected to one computer and '''merged''' to a single final [[.iPiVideo File Extension|iPiVideo]] file which includes data from all cameras, sensors, controllers. This combined [[.iPiVideo File Extension|iPiVideo]] file should be processed in [[iPi Mocap Studio]] to obtain animation.
 When recording has been stopped, master [[iPi Recorder]] automatically starts downloading of [[.iPiVideo File Extension|iPiVideo]] files from all slaves. After successful downloading of all the parts, it then merges them to a final video file.
@@ Line 52: / Line 61: @@
 * Automatic downloading has crashed or has been cancelled.
 To perform manual merging click '''Merge Videos''' button on the home screen of [[iPi Recorder]]. Select all [[.iPiVideo File Extension|iPiVideo]] files to combine and click the '''MERGE''' button.
 {{Note|Manual merging can be performed only for [[.iPiVideo File Extension|iPiVideo]] files produced by one [[Distributed Recording]] session. If you're selecting [[.iPiVideo File Extension|iPiVideo]] files from different recording sessions, you'll get an error message.}}