Examples

Example use cases include scenes like this one, from the planetarium show Cosmic Colors -

Such an effect can usually be created with Adobe After Effects or something similar, using tools like DomeXF Dome master plugin.

Using OCVvid2fulldome and a haphazard collection of video files, without arranging them properly in an aesthetic manner, I got this screenshot, where 10 videos (with some duplicates) are projected at different angles and sizes.

The ini file related to the above is here.

With version 1.6, an ini file similar to the one above results in the image below. We see that the angle mapping has changed, with the direction of the angles specified in the ini file being mapped differently. This seems to be a difference in behaviour between Windows and Linux builds - need to verify if exactly the same code produces different behaviour for the executable on Windows and Linux. The screenshot above is from Linux, the screenshots below are from Windows.

Another use case would be projection of high-resolution, but flat-screen content, for a uni-directional audience as in our tilted dome planetarium, which would have input and output images as below. The following parameters work relatively well, except for some slight distortion at the bottom and top edges -

#Outputw_pixels__=height
4096
#Output_fps
30
#Output_fourcc
XVID
#Number_of_input_videos_max_is_99
1
#Filename0
D:/Input/Filenm.avi
#vidlongi0
180
#vidlati0
76
#vidw0
270

In this case, the input image would look like this (generated with Natron)

and the output image would look like this.

Once this is "warped" for the "mirrordome" using transform type 4 in OCVWarp, the result looks like this: .

Natron's G'MIC filter "Square to Circle" is an option if you have a square video to start with, or if you can afford to crop the video. But Natron is much more unstable and slow for video to video conversions, it prefers image sequences. The Natron option is mentioned in this blog post, along with mention of Natron's unstable behaviour.