@@ -13,7 +13,7 @@ Using this values it calculates a trajectory: for each frame it calculates the t
1313
1414## Stabilisation
1515
16- Using the trajectory, for each axe (X, Y, rotations ) it will apply one of this algorithms:
16+ Using the trajectory, for each axe (X, Y, rotation ) it will apply one of this algorithms:
1717* none: keep values unchanged
1818* reverse: tries to apply the reverse changes to put the frame in the same "position" as the first one
1919* moving average: it will smooth the changes
@@ -33,73 +33,80 @@ Panning (B) | distribute | distribute | moving average
3333No rotation | none | none | reverse
3434
3535# Interface
36- Before stabilisation | After stabilisation
37- --- | ---
38- ![ ] ( screenshot/main_no_stab.jpg ) | ![ ] ( screenshot/main_stab.jpg )
3936
40- ## Menu
37+ ![ ] ( screenshot/main-screen.jpg )
38+ ## Toolbar
4139
42- Icon | Description
43- --- | ---
44- ![ ] ( screenshot/menu_open.jpg ) | Open a video file
45- ![ ] ( screenshot/menu_save.jpg ) | Save the current stabilized video
46- ![ ] ( screenshot/menu_settings.jpg ) | Application settings
40+ ![ ] ( screenshot/toolbar.jpg )
41+
42+ In order;
43+ * Open a video file
44+ * Save the current stabilized video
45+ * Settings
46+ * ... allow to open a series of images or an images folder (that will be considered as a video)
4747
4848## Input video informations
4949
50- ![ ] ( screenshot/input_video_info .jpg )
50+ ![ ] ( screenshot/input-info .jpg )
5151* Resolution
5252* Auto-detected FPS. NOTE: can be wrong in some cases
5353* File name
5454
5555## Stabilisation parameters
5656
57- ![ ] ( screenshot/stabilisation .jpg )
57+ ![ ] ( screenshot/parameters .jpg )
5858
59- * Use mask / edit mask: useful for difficult scenarios (see Mask section)
60- * Stabilize button: you need to press it to update the stabilisation (it's to slow to be updated automaticaly at every change)
6159* Algorithm: see "How it works" section for more details
6260* Strength: seconds to be used for moving average window (1, 2, 3 or 4 seconds)
6361* Crop: because the frames can be moved and rorated you can have black regions. This can be cropped (Auto, 0%, 5%, 10%)
6462* FPS: you can for a specific FPS if the auto detection failes
6563
66- ## View
64+ ## Media
6765
68- ![ ] ( screenshot/view .jpg )
66+ ![ ] ( screenshot/media .jpg )
6967
70- You can see the original, stabilized or both (horizontal or vertical split) videos at the same time.
68+ In order:
69+ * Play original video
70+ * Play stabilized video (it will apply the stabilisation if needed)
71+ * Stop the player
72+ * Edit stabilisation mask (used only for "Still" algorithm)
7173
7274## Mask
7375
7476Some video have big moving element (like big clouds) that can false frame alignemnt.
7577
7678This screen allow to draw a mask for the first frame that specify items that suppose to be still.
7779
78- ![ ] ( screenshot/edit_mask_small .jpg )
80+ ![ ] ( screenshot/edit-mask .jpg )
7981
8082The light part is the mask.
8183You can clear the mask, fill (all pixels are used) and you can draw / erase.
8284To draw / erase you must press and keep hold one of the buttons and with another edit the mask.
8385
8486See thre result: original (left), still without mask (middle) and still with the mask (right).
8587
86- https://user-images.githubusercontent.com/7062741/212324215-013dbb22-1a26-42d4-9599-19d6a87e3fa3.mp4
88+ ![ ] ( sample/original_vs_no_mask_vs_mask.gif )
8789
8890# Examples
8991
9092See the original vs stabilized video.
9193
9294## Original vs Generic
93- https://user-images.githubusercontent.com/7062741/186948791-aaa36028-4838-4819-af13-e943bacb7746.mp4
95+
96+ ![ ] ( sample/original-vs-generic.gif )
9497
9598## Original vs Still
96- https://user-images.githubusercontent.com/7062741/186948936-8897cbe2-3485-4d68-b86c-f6e74cec0487.mp4
99+
100+ ![ ] ( sample/original-vs-still.gif )
97101
98102## Original vs Horizontal panning
99- https://user-images.githubusercontent.com/7062741/186948982-52f177b9-876d-4af1-87cf-397f3860d3e0.mp4
103+
104+ ![ ] ( sample/original-vs-h-pan.gif )
100105
101106## Original vs Vertical panning
102- https://user-images.githubusercontent.com/7062741/186949010-35b108d3-bb15-4303-8da3-e838687b6474.mp4
107+
108+ ![ ] ( sample/original-vs-v-pan.gif )
103109
104110## Original vs Panning
105- https://user-images.githubusercontent.com/7062741/186949026-6c30e8ef-572f-440a-bff1-12ad6493a987.mp4
111+
112+ ![ ] ( sample/original-vs-pan.gif )
0 commit comments