]> git.sesse.net Git - mlt/blob - src/modules/vid.stab/filter_deshake.yml
Added a fourth filter, that combines both detect and transform passes.
[mlt] / src / modules / vid.stab / filter_deshake.yml
1 schema_version: 0.1
2 type: filter
3 identifier: vid.stab.deshake
4 title: Vid.Stab Deshake
5 copyright: Jakub Ksiezniak
6 creator: Georg Martius
7 version: 1
8 license: GPLv2
9 language: en
10 url: http://public.hronopik.de/vid.stab/
11 tags:
12   - Video
13 description: Stabilize Video (for wiggly/rolling video)
14 notes: >
15     Deshakes a video clip by extracting relative transformations
16     of subsequent frames and transforms the high-frequency away.
17     This is a single pass verion of stabilize and transform plugin.
18
19 parameters:
20   - identifier: shakiness
21     title: Shakiness
22     type: integer
23     description: How shaky is the video and how quick is the camera? (analysis)
24     readonly: no
25     required: no
26     minimum: 1
27     maximum: 10
28     default: 4
29     mutable: yes
30     widget: spinner
31
32   - identifier: accuracy
33     title: Accuracy
34     type: integer
35     description: Accuracy of shakiness detection (analysis)
36     readonly: no
37     required: no
38     minimum: 1
39     maximum: 15
40     default: 4
41     mutable: yes
42     widget: spinner
43
44   - identifier: stepsize
45     title: Stepsize
46     type: integer
47     description: Step size of search process, region around minimum is scanned with 1 pixel resolution (analysis)
48     readonly: no
49     required: no
50     minimum: 0
51     maximum: 100
52     default: 6
53     mutable: yes
54     widget: spinner
55
56   - identifier: algo
57     title: Algorithm
58     type: integer
59     description: 0 = brute force (translation only), 1 = small measurement fields (analysis)
60     readonly: no
61     required: no
62     minimum: 0
63     maximum: 1
64     default: 1
65     mutable: yes
66     widget: spinner
67
68   - identifier: mincontrast
69     title: Minimum Contrast
70     type: float
71     description: Below this contrast a field is discarded (analysis)
72     readonly: no
73     required: no
74     minimum: 0
75     maximum: 1
76     default: 0.3
77     mutable: yes
78     widget: spinner
79
80   - identifier: smoothing
81     title: Smoothing
82     type: integer
83     description: number of frames for lowpass filtering (2N + 1 frames) (transform)
84     readonly: no
85     required: no
86     minimum: 0
87     maximum: 100
88     default: 15
89     mutable: yes
90     widget: spinner
91
92   - identifier: maxshift
93     title: Maxshift
94     type: integer
95     description: maximum translation, -1 = no limit (transform)
96     unit: pixels
97     readonly: no
98     required: no
99     minimum: -1
100     maximum: 1000
101     default: -1
102     mutable: yes
103     widget: spinner
104
105   - identifier: maxangle
106     title: Maxangle
107     type: float
108     description: max angle to rotate, -1 = no limit (transform)
109     unit: radians
110     readonly: no
111     required: no
112     minimum: -1
113     maximum: 3.142
114     default: -1
115     mutable: yes
116     widget: spinner
117
118   - identifier: crop
119     title: Crop
120     type: integer
121     description: 0 = keep border, 1 = black background (transform)
122     readonly: no
123     required: no
124     minimum: 0
125     maximum: 1
126     default: 0
127     mutable: yes
128     widget: spinner
129
130   - identifier: zoom
131     title: Zoom
132     type: integer
133     description: additional zoom amount (transform)
134     unit: percent
135     readonly: no
136     required: no
137     minimum: -500
138     maximum: 500
139     default: 0
140     mutable: yes
141     widget: spinner
142
143   - identifier: optzoom
144     title: Optimal Zoom
145     type: integer
146     description: automatically determine optimal zoom. 1 - static zoom, 2 - adaptive zoom (transform)
147     readonly: no
148     required: no
149     minimum: 0
150     maximum: 2
151     default: 1
152     mutable: yes
153     widget: spinner
154
155   - identifier: zoomspeed
156     title: Optimal Zoom Speed
157     type: float
158     description: zoom per frame in percent, (used when optzoom = 2) (transform)
159     readonly: no
160     required: no
161     minimum: 0
162     maximum: 1
163     default: 0.25
164     mutable: yes
165     widget: spinner
166
167   - identifier: refresh
168     description: >
169       Applications should set this when it updates a transform parameter.
170     type: integer
171     minimum: 0
172     maximum: 1