opencv / opencv_contrib

Repository for OpenCV's extra modules
Apache License 2.0
9.24k stars 5.74k forks source link

Video Stabilization Module fixing documentation and adding functionalities #2513

Open felipevw opened 4 years ago

felipevw commented 4 years ago

System information (version)

OpenCV => 4.3.0
Operating System / Platform => ❔
Compiler => ❔

Detailed description

Firstly, I have overviewed the Video Stabilization contribution module and I believe it would be highly beneficial to add some description to the available functions. It is unclear for me how many methods are implemented, just some are mentioned and there are some broken links. For example, the link in the description of the Fast Matching Method does not work.

Moreover, including a minimal example of usage would be also very helpful. Although this example should be previously verified, it could be included as a small code snippet.

It is also unclear if the described methods can be implemented in real-time since the input of cv::Ptr<VideoFileSource> video = cv::makePtr<VideoFileSource>(videoFile,true); should be a video file. By popular demand, a simple implementation of a real-time video stabilization could be considered. For instance, an updated version of videostabKalman.cpp could be included to process live the stabilization between two frames of a camera stream. A new submodule could be included like cv::videostab::SimpleRTStabilization.

If someone could guide me a little on how to start, I could help to include all the previous suggestions. I already started some of them.

Thank you for your time

mshabunin commented 4 years ago