Skip to content

Commit 459d74c

Browse files
committed
Update README
1 parent 258c50a commit 459d74c

37 files changed

+31
-24
lines changed

README.md

Lines changed: 31 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -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
3333
No 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

7476
Some video have big moving element (like big clouds) that can false frame alignemnt.
7577

7678
This 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

8082
The light part is the mask.
8183
You can clear the mask, fill (all pixels are used) and you can draw / erase.
8284
To draw / erase you must press and keep hold one of the buttons and with another edit the mask.
8385

8486
See 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

9092
See 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)
-1.14 MB
Binary file not shown.

sample/original-vs-generic.gif

9.96 MB
Loading

sample/original-vs-generic.mp4

-7.79 MB
Binary file not shown.

sample/original-vs-h-pan-small.mp4

-1.12 MB
Binary file not shown.

sample/original-vs-h-pan.gif

9.96 MB
Loading

sample/original-vs-h-pan.mp4

-7.81 MB
Binary file not shown.

sample/original-vs-pan-small.mp4

-1.14 MB
Binary file not shown.

sample/original-vs-pan.gif

9.89 MB
Loading

sample/original-vs-pan.mp4

-7.98 MB
Binary file not shown.

0 commit comments

Comments
 (0)