Difference between revisions of "How to Build Synced Multi-Camera Video"
From iPi Docs
(Under construction...) |
|||
| Line 1: | Line 1: | ||
| + | == Introduction == | ||
| + | To process video recorded by action cameras (or other standalone camcorders) in [[iPi Mocap Studio]] you have to create multi-camera [[.iPiVideo File Extension|.iPiVideo]] file from separate MP4/MOV/AVI/MPEG video files recorded by these cameras. | ||
| + | |||
| + | == Preparations == | ||
| + | |||
| + | Copy MP4/MOV/AVI/MPEG video files from each camera to computer. | ||
| + | |||
| + | There are two hints here: | ||
| + | # It's better to use microSD-card reader to copy files because it provides much higher speed of this operation in comparison with USB-connection. | ||
| + | # Two distinguish files from different cameras it is convenient to create sub-folder for each camera. And name of such sub-folder should contain label/nickname of corresponding camera.<br/>For example: if you have cameras with labels/names "cam1", "cam2", "cam3" and "cam4" then you can create the following structure of folders and files on your local disk: | ||
| + | YYYY-MM-DD-session-name | ||
| + | cam1 | ||
| + | video files from "cam1" camera | ||
| + | cam2 | ||
| + | video files from "cam2" camera | ||
| + | cam3 | ||
| + | video files from "cam3" camera | ||
| + | cam4 | ||
| + | video files from "cam4" camera | ||
| + | :: Alternatively you can rename video files right after copying (or even during copying) to local disk while you're remembering from what camera these files are. Such approach is used in the following sample: [[Sample Videos and Projects (four GoPro)]]. | ||
| + | |||
| + | |||
| + | == Overall Procedure == | ||
* Run [[iPi Recorder]] and click on '''Build Combined Video''' button in toolbar on home screen. | * Run [[iPi Recorder]] and click on '''Build Combined Video''' button in toolbar on home screen. | ||
<center>[[File:build-combined-video-tool-button.png|500px|link=]]</center> | <center>[[File:build-combined-video-tool-button.png|500px|link=]]</center> | ||
* For each camera: | * For each camera: | ||
| − | ** add video from this camera by clicking '''Add Video''' button in toolbar — '''(1)''' | + | ** add video from this camera by clicking '''Add Video''' button in toolbar — see mark '''(1)''' on screenshot below |
** choose this camera by clicking on image from this camera — '''(2)''' | ** choose this camera by clicking on image from this camera — '''(2)''' | ||
** in the left panel '''(3)''' set camera parameters by clicking on '''Load''' button in '''camera parameters''' section — '''(4)''' | ** in the left panel '''(3)''' set camera parameters by clicking on '''Load''' button in '''camera parameters''' section — '''(4)''' | ||
| + | *** choose appropriate '''.iPiCam''' file you saved for this camera during [[How to Calibrate Camera Optics|camera optics calibration]] | ||
| + | ** click button '''Edit''' in '''sync frame''' section of left panel '''(3)''' and choose frame with synchronization event — '''(5)''' | ||
| + | *** for details see [[#Synchronization|below]] | ||
| + | * Now videos from all cameras are added and required parameters (camera parameters and synchronization frames) are defined for them. | ||
<center>[[File:build-combined-video-workflow.png|900px|link=]]</center> | <center>[[File:build-combined-video-workflow.png|900px|link=]]</center> | ||
| + | * Evaluate background: | ||
| + | ** using markers '''(6)''' and '''(7)''' select interval on timeline where there is no actor and moving objects | ||
| + | ** alternatively, to set interval on timeline you can use controls in section '''INTERVAL''' of toolbar — '''(8)''' | ||
| + | ** click '''Evaluate Background''' button in toolbar to evaluate background for all cameras simultaneously from selected interval on timeline — '''(9)''' | ||
| + | ** alternatively: | ||
| + | *** you can evaluate background for each camera separately using button '''Edit...''' in section '''background''' in left panel '''(3)''' — '''(A)''' | ||
| + | *** or you can even load background from file if you've already evaluated it before from different video — '''(B)''' | ||
| + | *** for details see [[#Background|below]] | ||
| + | * Now everything is ready to be saved into destination [[.iPiVideo File Extension|.iPiVideo]] file: | ||
| + | ** using markers '''(6)''' and '''(7)''' on timeline or controls '''(8)''' in toolbar, select fragment you want to save to result video | ||
| + | *** for calibration video it could be fragment where glowing marker is visible | ||
| + | *** for action video it could be fragment with required action sequence or movement | ||
| + | *** or you can save the whole video if you're not sure what fragment exactly will be used for processing in [[iPi Mocap Studio]] | ||
| + | ** click '''Save Combined Video''' button in toolbar and choose destination file name — '''(C)''' | ||
| + | ** also before saving you can set compression quality for destination video — '''(D)''' | ||
| + | *** but in most cases default value (70%) works very well providing good balance between image quality in result video and size of this video | ||
| + | * After all you can open result [[.iPiVideo File Extension|.iPiVideo]] file in [[iPi Mocap Studio]] and process it. | ||
| + | |||
| + | == Important Aspects == | ||
| + | |||
| + | Now let's discuss some aspects in details: | ||
| + | |||
| + | === Cameras and Their Parameters === | ||
| + | |||
| + | # It is strictly mandatory to add cameras in one and the same order for scene calibration and action videos. In other case results of scene calibration will not match action video(s). By the way, you can use drag-and-drop to reorder cameras. | ||
| + | # Don't forget to apply camera parameters by loading them from appropriate '''.iPiCam''' file. Remember that this '''.iPiCam''' file must be for exactly the same camera item and for exactly the same resolution and view/FOV settings (FPS may differ). The thing is that camera optics parameters significantly vary from item to item (even when all items are of one and the same model) and depends on resolution and view/FOV settings. | ||
| + | # | ||
| + | |||
| + | === Synchronization === | ||
| + | |||
| + | |||
| + | === Background === | ||
| + | |||
| + | |||
| + | == Sample == | ||
| + | |||
| + | You can use the following sample videos to train in this subject without need in recording your own videos: | ||
| + | [[Sample Videos and Projects (four GoPro)]]. | ||
Revision as of 07:42, 14 August 2018
Contents
Introduction
To process video recorded by action cameras (or other standalone camcorders) in iPi Mocap Studio you have to create multi-camera .iPiVideo file from separate MP4/MOV/AVI/MPEG video files recorded by these cameras.
Preparations
Copy MP4/MOV/AVI/MPEG video files from each camera to computer.
There are two hints here:
- It's better to use microSD-card reader to copy files because it provides much higher speed of this operation in comparison with USB-connection.
- Two distinguish files from different cameras it is convenient to create sub-folder for each camera. And name of such sub-folder should contain label/nickname of corresponding camera.
For example: if you have cameras with labels/names "cam1", "cam2", "cam3" and "cam4" then you can create the following structure of folders and files on your local disk:
YYYY-MM-DD-session-name
cam1
video files from "cam1" camera
cam2
video files from "cam2" camera
cam3
video files from "cam3" camera
cam4
video files from "cam4" camera
- Alternatively you can rename video files right after copying (or even during copying) to local disk while you're remembering from what camera these files are. Such approach is used in the following sample: Sample Videos and Projects (four GoPro).
Overall Procedure
- Run iPi Recorder and click on Build Combined Video button in toolbar on home screen.
- For each camera:
- add video from this camera by clicking Add Video button in toolbar — see mark (1) on screenshot below
- choose this camera by clicking on image from this camera — (2)
- in the left panel (3) set camera parameters by clicking on Load button in camera parameters section — (4)
- choose appropriate .iPiCam file you saved for this camera during camera optics calibration
- click button Edit in sync frame section of left panel (3) and choose frame with synchronization event — (5)
- for details see below
- Now videos from all cameras are added and required parameters (camera parameters and synchronization frames) are defined for them.
- Evaluate background:
- using markers (6) and (7) select interval on timeline where there is no actor and moving objects
- alternatively, to set interval on timeline you can use controls in section INTERVAL of toolbar — (8)
- click Evaluate Background button in toolbar to evaluate background for all cameras simultaneously from selected interval on timeline — (9)
- alternatively:
- you can evaluate background for each camera separately using button Edit... in section background in left panel (3) — (A)
- or you can even load background from file if you've already evaluated it before from different video — (B)
- for details see below
- Now everything is ready to be saved into destination .iPiVideo file:
- using markers (6) and (7) on timeline or controls (8) in toolbar, select fragment you want to save to result video
- for calibration video it could be fragment where glowing marker is visible
- for action video it could be fragment with required action sequence or movement
- or you can save the whole video if you're not sure what fragment exactly will be used for processing in iPi Mocap Studio
- click Save Combined Video button in toolbar and choose destination file name — (C)
- also before saving you can set compression quality for destination video — (D)
- but in most cases default value (70%) works very well providing good balance between image quality in result video and size of this video
- using markers (6) and (7) on timeline or controls (8) in toolbar, select fragment you want to save to result video
- After all you can open result .iPiVideo file in iPi Mocap Studio and process it.
Important Aspects
Now let's discuss some aspects in details:
Cameras and Their Parameters
- It is strictly mandatory to add cameras in one and the same order for scene calibration and action videos. In other case results of scene calibration will not match action video(s). By the way, you can use drag-and-drop to reorder cameras.
- Don't forget to apply camera parameters by loading them from appropriate .iPiCam file. Remember that this .iPiCam file must be for exactly the same camera item and for exactly the same resolution and view/FOV settings (FPS may differ). The thing is that camera optics parameters significantly vary from item to item (even when all items are of one and the same model) and depends on resolution and view/FOV settings.
Synchronization
Background
Sample
You can use the following sample videos to train in this subject without need in recording your own videos: Sample Videos and Projects (four GoPro).