Debian Codegraph @

flowblade-trunk/Flowblade/res/help/advanced.html

raw
1 <!DOCTYPE html>
2 <html>
3 <head>
4 <title>Advanced Editing</title>
5 <link rel="stylesheet" href="style.css">
6 <script src="toc.js" type="text/javascript"></script>
7 </head>
8
9 <body>
10
11 <div id="content">
12 <img src="header_text_5.png">
13
14 <script src="tocgen.js"></script>
15
16 <div id="toccontent">
17
18 <div id="advtoc">
19 <div class="subject-header">Advanced Editing Features</div>
20 </div>
21
22 <div id="toc"></div>
23
24
25
26 <h2>1. Sync Editing</h2>
27 <p>
28 In Flowblade Movie Editor sync editing workflow is to <b>set clip's positions to follow another clip's positions</b> on request.
29 </p>
30 <ul>
31 <li> Sync relation between two clips is set by either setting relation individually, doing audio splits or setting sync relation for all clips on a track or a box selection in single action </li>
32 <li> Clips that have lost sync with their parent clips can be resynced one or more at a time or by resyncing a whole track in single action.</li>
33 </ul>
34
35 <p>
36 Below we give suggested workflows for three typical use cases for utilizing Flowblade's sync editing features.
37 </p>
38 <ul>
39 <li> Generic work preserving sync editing. </li>
40 <li> Editing to audio, such as when creating music videos or voice over driven programs. </li>
41 <li> Dialogue editing. </li>
42 </ul>
43
44
45
46 <h3>Setting up Sync Relations</h3>
47
48 <p>
49 There are three ways to set up a sync relation between clips:
50 </p>
51
52 <h4>Clip Parenting</h4>
53
54 <p>
55 Explicitly set Sync relation between two clips set up by selecting a <b>Sync Parent Clip</b> for a <b>Sync Child Clip</b>.
56 </p>
57
58 <ul>
59 <li> Click <b>Right Mouse</b> on clip and select <b>Edit->Select Sync Parent Clip...</b>.</li>
60 <li> Or Click <b>Right Mouse</b> on clip that is part of a multiclip selection and select <b>Select Sync Parent Clip...</b>.</li>
61 <li> Cursor turns into a Target Cross. Click on a clip to select it as <b>Sync Parent Clip</b>.</li>
62 </ul>
63
64 <h4>Audio Splitting</h4>
65
66 <p>
67 Split a video clip into two clips: a muted video clip as <b>Sync Parent Clip</b> and an audio clip as <b>Sync Child Clip</b>.
68 </p>
69
70 <ul>
71 <li> Click <b>Right Mouse</b> on clip and select <b>Audio Edit->Split Audio Synched</b>.
72 <li> When multiple Clips are selected click <b>Right Mouse</b> on clip and select <b>Split Audio Synched</b>.
73 <li>A new synched Audio Clip/s is placed on audio track, either on V1 or mirrored track based on current preference.</li>
74 <li> If you select from <b>Sync Properties</b> menu property <b>Auto Sync Split Video Clips on Add</b> video clips will be split automatically when added to certain tracks.
75 </li>
76 </ul>
77
78 <h4>Track Auto Parenting</h4>
79 <p>
80 Set all clips on track as <b>Sync Child Clips</b> to closest clips on the selected Track as <b>Sync Parent Clips</b>.
81 </p>
82 <ul>
83 <li> Click <b>Right Mouse</b> on a track in the left side tracks Column area and select <b>Sync All Clips To Track... </b>.</li>
84 <ul>
85 <li>Select sync parenting target track using the dialog window.</li>
86 <li>A sync relation is created for all Clips on Track.</li>
87 <li>An icon appears on Track Head in in the Tracks Column to indicate that updating sync is now possible.</li>
88 </ul>
89 <li>Once a Track has been auto parented it remembers the target track and parenting can be updated by clicking <b>Right Mouse</b> on a Track Head and selecting <b>Update Sync to Clips' Current Positions</b>.</li>
90 <li> Click <b>Right Mouse</b> on a Track Head and select <b>Clear Sync</b> to clear all sync relations on a Track and info on parenting target Track.</li>
91 </ul>
92
93 <h4>Box Selection Parenting</h4>
94
95 <p>
96 Parent selected clips to the first clip on track closest to track <b>V1</b>.
97 </p>
98
99 <ul>
100 <li> Drag <b>Left Mouse</b> to select clips on multiple tracks.</li>
101 <li> Press button <b>Set Sync for All Clips on Track or Box Selection.</b></li>
102 <li> All selected clips on other tracks are parented to the first clip in selection on track closest to track <b>V1</b>. Clips on track closest to track <b>V1</b> are not parented.
103 </ul>
104
105 <h3>Resyncing</h3>
106
107 <h4>Single Clip</h4>
108 <ul>
109 <li> Click <b>Right Mouse</b> on Sync Child Clip and select <b>Edit->Resync</b> from popup menu to resync single clip.</li>
110 <li> Press <b>Resync Selected Clips</b> Button to resync single clip.</li>
111 </li>
112 </ul>
113
114 <h4>Multiple Clips</h4>
115 <ul>
116 <li> Press <b>Resync Selected Clips</b> Button to resync selected clips clip.</li>
117 <li> Click <b>Right Mouse</b> on <b>Sync Child Clip</b> that is part of a multiclip selection and select <b>Resync</b> from popup menu to resync single clip.</li>
118 </li>
119 </ul>
120
121 <h4>All Clips on a Track</h4>
122 <ul>
123 <li> Select from application menu <b>Edit->Resync Track</b> to resync all clips in the track containing currently selected clip.</li>
124 <li> Press <b>Resync Track Containing Selected Clip</b> Button to resync all clips in the track containing currently selected clip.</li>
125 </ul>
126
127 <h3>Clearing Sync Parent Relations </h3>
128 <ul>
129 <li> Click <b>Right Mouse</b> on Sync Child Clip and select <b>Edit->Clear Sync Relation</b>.</li>
130 <li> Or Click <b>Right Mouse</b> on clip that is part of a multiclip selection and select <b>>Clear Sync Relations</b>.</li>
131 </ul>
132
133 <h3>Workflows</h3>
134
135 <h4> Generic work preserving sync editing</h4>
136 <p>
137 Most edits require clips on different tracks to maintain positions relative to each other, such as a title placed on top of a video clip.
138 </p>
139 <p>
140 Many edit actions necessarily change the positions of clips differently on different tracks. Sync editing tools provide quick workflow to regain sync between clips.
141 </p>
142 <ul>
143 <li> It is often useful to treat track <b>V1</b> as a master track, and have all other tracks relate positions to track <b>V1</b>.</li>
144 <li> Set sync relations for individual or multiple selected clips.</li>
145 <li> If there exists many clips of similar type that require syncing, dedicate a track to that type of clips and use track syncing features to keep that track in sync.</li>
146 <li> If program features multiple clearly defined complex scenes one approach is to:
147 <ul>
148 <li> Parent first clip of the scene on each track to the first clip of scene on track <b>V1</b>. <i>Box Selection Parenting</i> can be a useful action to get this done quickly.</li>
149 <li> Use <b>Spacer</b> tool with <b>Control</b> modifier to sync tracks manually at scene start when needed.</li>
150 <li> Or use track syncing.</li>
151 </ul>
152 </li>
153 </ul>
154
155
156 <h4>Editing to audio</h4>
157 <p>
158 When creating music videos or voice over driven programs it is useful to use a single audio track as sync target track for most are all other elements in the sequence.</li>
159 </p>
160
161 <ul>
162 <li> Place the program defining audio of track <b>A1</b> and treat that as a master track.</li>
163 <li> Have all other tracks and clips relate their positions to track <b>A1</b>.</li>
164 <li> With music videos it is useful to use a large number of track dedicated to individual types of visual elements, and use exclusively track syncing features instead of setting sync to individual clips.</li>
165 </ul>
166
167 <h4> Dialogue editing</h4>
168 <p>
169 Editing dialogue scenes frequently require actor's voice to start before or end after the image of the character speaking. These types of edit are knowns as J- and L-cuts.
170 </p>
171 <ul>
172 <li> Dedicate tracks <b>V1</b>, <b>V2</b>, <b>A1</b> and <b>A2</b> to dialogue video and audio.</li>
173 <li> Select from <b>Sync Properties</b> menu on the left behaviour that suits your preferences.
174 <ul>
175 <li> <b>Auto Sync Split Video Clips on Add</b> has multiple options to select which tracks do this.</li>
176 <li> <b>Audio Split To Mirrored Track</b> behaviour can be turned on and off.</li>
177 </ul>
178 </li>
179 <li> When creating J- or L-cuts use methods that maintain sync to minimize the need to resync:
180 <ul>
181 <li> When using <b>Trim</b> tool, use <i>Two Roll Trim</i> instead of <i>One Roll Trim</i>.</li>
182 <li> When dragging clip ends use <b>Alt</b> modifier to do <b>Clip End Overwrite Drag</b> actions.</li>
183 </ul>
184 </li>
185 <li> Use exclusively track resyncing actions to keep audio on tracks <b>A1</b> and <b>A2</b> synced.</li>
186 </ul>
187
188
189 <h3>Sync UX</h3>
190 <h4>Buttons</h4>
191
192 <p>
193 There are 4 buttons in the <b>Middlebar</b>, from left to right:
194 </p>
195 <ul>
196 <li><b>Split Audio Synched</b></li>
197 <li><b>Set Sync for All Clips on Track or Box Selection.</b> If a box selection is active then <i>Box Selection Parenting</i> is done, othrewise a <i>Track Auto Parenting</i> action is performed</li>
198 <li><b>Resync Track Containing Selected Clip/s</b></li>
199 <li><b>Resync Selected Clips</b></li>
200 </ul>
201 <h4>Menus</h4>
202 <p>
203 There are 4 menus available at various places to provide sync editing functionality:
204 </p>
205 <ul>
206 <li><b>Sync Properties Menu</b> above <b>Tracks Column</b> allows for setting sync editing properties.</li>
207 <li><b>Track Menu</b> available in <b>Tracks Column</b> provides track sync actions.</li>
208 <li><b>Clip Menu</b> provides sync actions applied to single clips.</li>
209 <li><b>Multi Clip Selection Menu</b> provides sync actions applied to multiple clips.</li>
210 </ul>
211
212 <h4>Timeline</h4>
213 <p>
214 Visually clip's sync state is displayed as follows:
215 </p>
216 <ul>
217 <li> Red box with a number means that clip is not in sync with parent.</li>
218 <li> Displayed number gives info on how many frames a clip's position is away from being synched.</li>
219 <li> Optionally a line is drawn between parent and child clip.</li>
220 </ul>
221
222
223 <h2>2. Advanced Project Actions </h2>
224
225
226
227 <h3>Combining Sequences</h3>
228 <p>
229 It is possible to import full contents of another Sequence into Sequence currently being edited.
230 </p>
231
232 <ol>
233 <li> Select <b>Sequence->Import Another Sequence into this Sequence...</b></li>
234 <li> Select Import action.</li>
235 <ul>
236 <li> <b>Append Sequence</b> adds imported Sequence at the end of current Sequence</li>
237 <li> <b>Insert Sequence at Playhead Position</b> creates a cut at playhead position and inserts imported Sequences at that position</li>
238 </ul>
239 <li> Select a Sequence to Import</li>
240 <ul>
241 <li> <b>Note that you obviously need at least two Sequences to exist to do any import actions.</b></li>
242 </ul>
243 <li> Press <b>Import</b> button to execute import.</li>
244 </ol>
245
246 <h3>Split part of Sequence to new Sequence</h3>
247
248 <ol>
249 <li> Select <b>Sequence->Split to new Sequence at Playhead position</b></li>
250 <li> After confirmation dialog the a new Sequence with contents of source Sequence after playhead position will be created and made active.</li>
251 </ol>
252
253 <h3>Importing Media from another Project</h3>
254
255 <p>
256 You can import Media Items from another Project.
257 </p>
258
259 <ol>
260 <li> Select <b>Project->Import Media From Project...</b></li>
261 <li> Select a Project file from file system.</li>
262 <li> Media items that are not present in current Project will be opened in the current bin. Note that it takes a few seconds to load the project before new Media Items begin to appear.</li>
263 </ol>
264
265
266
267 <h2>3. Timeline Audio Syncing</h2>
268
269 <p>
270 You can make a clip to move to a position in timeline in which its audio is in sync with audio of another clip on timeline.
271 </p>
272
273 <p>
274 This enables you to do simplified version of multicam editing on the timeline.
275 </p>
276
277 <ol>
278 <li> Open context menu with <b>Right Mouse</b> on Clip you wish to sync with some other clip.</li>
279 <li> Select menu item <b>Audio->Select Clip to Audio Sync With...</b>. The cursor changes to a targeting cross.</li>
280 <li> Click on Clip you wish to audio sync with.</li>
281 <li> A dialog opens giving info on the sync action that is to be done to sync clips.</li>
282 <li> Press <b>Do Audio Sync Move Edit</b> button to do the syncing edit.</li>
283 <li> It is usually a good idea to mute one of the synched clips</li>
284 </ol>
285
286 <div class="note">
287 Audio syncing looks for best mathematical match between two audio waveforms, so <b>audio syncing non-matching audio will produce random results.</b>
288 </div>
289
290
291 <h2>4. Slow / Fast Motion and Reverse</h2>
292
293 <p>
294 In Flowblade there are two ways to do motion effects:
295 </p>
296 <ul>
297 <li> Changing Clip Speed and direction in Timeline</li>
298 <li> Creating new New Media Items in Bins</li>
299 </ul>
300
301
302 <h3> Changing Timeline Clip Speed and direction</h3>
303 <h4> Creating Slow / Fast Motion Clips </h4>
304 <ol>
305 <li> Right click on a Timeline Clip File and select <b>Slow Motion -> Slow / Fast</b> from popup menu.</li>
306 <li> Edit parameters for the new motion Clip</li>
307 <ul>
308 <li> Set speed</li>
309 <li> Set encoding and quality</li>
310 <li> Select render range, either:</li>
311 <ul>
312 <li> Current Clip Content</li>
313 <li> Full Media</li>
314 </ul>
315 </ul>
316 <li> Click <b>Render</b> button to create a new motion Timeline Clip.</li>
317 </ol>
318
319 <h4> Creating Reverse Motion Clips</h4>
320 <ol>
321 <li> Right click on a Timeline Clip File and select <b>Slow Motion -> Reverse</b> from popup menu.</li>
322 <li> Edit parameters for the new motion Clip</li>
323 <ul>
324 <li> Set speed</li>
325 <li> Set encoding and quality</li>
326 <li> Select render range, either:</li>
327 <ul>
328 <li> Current Clip Content</li>
329 <li> Full Media</li>
330 </ul>
331 </ul>
332 <li> Click <b>Render</b> button to create a new reverse Timeline Clip.</li>
333 </ol>
334
335 <h3> Creating Motion Media Items </h3>
336 <h4> Creating Slow / Fast Media Items </h4>
337 <ol>
338 <li> Right click on a Media File and select <b>Render Slow / Fast Motion File</b> from menu</li>
339 <li>Edit parameters for the new motion Clip
340 <ul>
341 <li> Set speed</li>
342 <li> Give name and location for motion Clip </li>
343 <li> Select rendering parameters for motion Clip. It is probably a good idea to use a <b>lossless format</b> here to avoid any generational quality losses.</li>
344 <li> Select render range, either:</li>
345 <ul>
346 <li> Full Source Clip</li>
347 <li> From Source Clip Mark In to Mark Out</li>
348 </ul>
349 </ul>
350 <li> Click <b>Render</b> button to create a new motion Media Item</li>
351 </ol>
352
353 <h4> Creating Reverse Media Items </h4>
354 <ol>
355 <li> Right click on a Media File and select <b>Render Reverse Motion File</b> from menu</li>
356 <li>Edit parameters for the new motion Clip
357 <ul>
358 <li> Set speed</li>
359 <li> Give name and location for reverse Clip </li>
360 <li> Select rendering parameters for reverse Clip. It is probably a good idea to use a <b>lossless format</b> here to avoid any generational quality losses.</li>
361 <li> Select render range, either:</li>
362 <ul>
363 <li> Full Source Clip</li>
364 <li> From Source Clip Mark In to Mark Out</li>
365 </ul>
366 </ul>
367 <li> Click <b>Render</b> button to create a new reverse Media Item</li>
368 </ol>
369
370 <a name="filtermasking"></a>
371 <h2>5. Filter Masking</h2>
372
373 <p>
374 Filter masking allows for one or more filters to be applied only on some user defined part of image</b>.
375 </p>
376
377 <img src="filter_mask.png">
378 <p>
379 <i>1) Filter masking menu launch button above red triangle, 2) Filters editor after adding mask with all filter edit panels minified. Mask - Begin and Mask - End filters define which filters are masked.</i>
380 </p>
381
382 <ol>
383 <li> Click Filter Mask Menu launch button and select if you wish to apply mask on one or all filters.</li>
384 <li> In submenu select mask <b>Alpha Shape</b>, <b>Alpha Shape Motion Tracked</b>, <b>Luma Key</b>, <b>Video/Image File Alpha</b>, <b>Video/Image File Luma</b> or <b>Color Select</b>.</li>
385 <li> Edit mask parameters in filter edit panel for <b>Mask - Begin</b> filter.</li>
386 <li> You can movefilters in and out of the masked range of filter stack.</li>
387 <ul>
388 </ol>
389
390 <h2>6. Motion Tracking</h2>
391 <p>
392 When creating a motion tracking effect we are usually dealing with two image sources: one that contains the image element that is being tracked, and an another image that follows the tracked image element.
393 </p>
394 <p>
395 When using motion tracking to create a tracking filter mask, then both tracking data source clip and the clip that has the masked filter applied are usually the same clip.
396 </p>
397 <p>
398 Flowblade implements motion tracking by providing two filters and a filter mask. Filters are:
399 </p>
400 <ul>
401 <li> <b>Motion Tracking Create</b> This filter creates the tracking data based on region of image and algorithm selected by the user.</li>
402 <li> <b>Motion Tracking Apply</b> This filter applies tracking data on another image to follow the image element that was the source of the tracking data.
403 </ul>
404 <p>
405 Motion tracked masked filtering uses <b>Filter Mask: Alpha Shape Motion Tracked</b>, see below.
406 </p>
407
408 <h3>Filter: Motion Tracking Create</h3>
409 <p>
410 Add this filter to clip that contains the image element you wish to track.
411 </p>
412 <h4>Parameters</h4>
413 <p>
414 <b>Rectancle GUI Editor</b> Set the red rectangle on the image element you wish to track.
415 </p>
416 <p>
417 Tracking always starts from first frame of clip, so use the first frame to position the rectangle.
418 </p>
419 <p>
420 If you like tracking to start in the middle of a clip, then cut clip at that point to create a new clip that has the first frame at the position you wish the tracking to start.
421 </p>
422 <p>
423 <b>Keyframe Step</b> This sets the interval in frames between keyframes in the created tracking data. So e.g. value 5 creates a keyframe every 5 frames.
424 </p>
425 <p>
426 <b>Algorithm</b> Algorithm used to create the tracking data.
427 </p>
428
429 <ul>
430 <li>
431 <b>KCF - Kernelized Correlation Filters</b> Accuracy and speed better than MIL. This also reports tracking failure better than MIL. Does not recover from full occlusion.
432 </li>
433 <li>
434 <b>MIL - Multiple Instance Learning</b> Performance is quite good, can work when presented with partial occlusion. Tracking failure not reported reliably. Does not recover from full occlusion.
435 </li>
436 <li>
437 <b>MEDIANFLOW</b>
438 Excellent tracking failure reporting. Works very well when the motion is predictable and there is no occlusion. Fails under large motion.
439 </li>
440 <li>
441 <b>MOSSE - Minimum Output Sum of Squared Error</b> MOSSE tracker is robust to variations in lighting, scale, pose, and non-rigid deformations. It also detects occlusion and can pause and resume where it left off when the object reappears.
442 </li>
443 <li>
444 <b>CSRT</b> Among these algorithms CSRT often shows comparatively better accuracy and resistance to overlapping by other objects. Speed is quite low, and operation is unstable when the object is lost.
445 </li>
446 </ul>
447 <p>
448 <b>Create Motion Tracking Data</b> Pressing this button creates a motion tracking data labeled with name given in the text entry box above. After creation data can be used with <b>Motion Tracking Apply</b> filter or <b>Filter Mask: Alpha Shape Motion Tracked</b>.
449 </p>
450
451 <h4>Workflow</h4>
452 <ol>
453 <li>Make sure playhead is on the first frame of the tracked clip.</li>
454 <li>Place red rectangle on top of the tracked image element.</li>
455 <li>Set parameters and give the data to be created an identifying name.</li>
456 <li>Press <b>Create Motion Tracking Data</b> and wait for the data render to complete.</li>
457 <li>Check results by moving the playhead around.</li>
458 <li>Press <b>Clear Data</b> button if you wish to try again with different parameters or tracking area definition.</li>
459 </ol>
460
461 <h3>Filter: Motion Tracking Apply</h3>
462 <p>
463 Add this filter to the clip that contains the image that you wish to make follow the tracked image element.
464 </p>
465 <p>
466 Place the clip with tracking image on top of the clip with tracked image and apply cropping if necessary.
467 </p>
468
469 <h4>Parameters</h4>
470 <p>
471 <b>Select Motion Tracking Data</b> Select the labeled tracking data created from tracking image element you wish to track.
472 </p>
473 <p>
474 Tracking always starts from first frame of clip.
475 </p>
476 <p>
477 If you like tracking to start in the middle of a clip, then cut that clip at that point to create a new clip that has the first frame at the position you wish tracking to start.
478 </p>
479 <p>
480 <b>Tracking Coords Interpretation</b>
481 </p>
482 <ul>
483 <li>
484 <b>Absolute</b> Places the top left corner of the image to the top left corner of the tracking data box.
485 </li>
486 <li>
487 <b>Top Left Justified</b> Places the top left corner of image to the top left corner of screen in the first frame of tracking, and then moves image relatively as specified by tracking data. This is useful e.g. when making a text created in <b>Titler</b> (that is placed initially correctly) keep position when tracking data is applied.
488 </ul>
489 <p>
490 <b>X Offset</b> Moves image in the horizontal direction in relation to the position defined by tracking data.
491 </p>
492 <p>
493 <b>Y Offset</b> Moves image in the vertical direction in relation to the position defined by tracking data.
494 </p>
495 <p>
496 <b>Size</b> If set to <b>Scale To Box</b> image is scaled to fit the box defined by tracking data.
497 </p>
498 <p>
499 <b>Apply Motion Tracking Data</b> Applies selected tracking data with user specified parameters as motion of the clip.
500 </p>
501
502
503 <h4>Workflow</h4>
504 <ol>
505 <li>Use <b>Select Motion Tracking Data</b> dropdown menu to select which tracking data to apply.</li>
506 <li>Set parameters to fine tune tracked motion.</li>
507 <li>Press <b>Apply Motion Tracking Data</b> button to make clip image follow tracked motion.</li>
508 <li>If needed, change parameters and press <b>Apply Motion Tracking Data</b> button again to get changed motion.</li>
509 </ol>
510
511 <h3>Filter Mask: Alpha Shape Motion Tracked</h3>
512 <p>
513 Add this Filter Mask to clip that contains the image element you wish to apply masked filtering on.
514 </p>
515
516 <p>
517 A typical use would be to e.g. blur a person's face to make them unrecognizable.
518 </p>
519
520 <h4>Parameters</h4>
521 <p>
522 <b>Select Motion Tracking Data</b> Select the labeled tracking data created from tracking image element you wish to track.
523 </p>
524 <p>
525 Tracking always starts from first frame of clip.
526 </p>
527 <p>
528 If you like tracking to start in the middle of a clip, then cut that clip at that point to create a new clip that has the first frame at the position you wish tracking to start.
529 </p>
530 <p>
531 <b>X Offset</b> Moves filtered area in the horizontal direction in relation to the position defined by tracking data.
532 </p>
533 <p>
534 <b>Y Offset</b> Moves filtered area in the vertical direction in relation to the position defined by tracking data.
535 </p>
536 <p>
537 <b>Scale</b> Makes filtered area smaller or larger.
538 </p>
539 <p>
540 <b>Apply Motion Tracking Data</b> Applies selected tracking data with user specified parameters as a Filter Mask.
541 </p>
542
543 <h4>Workflow</h4>
544 <ol>
545 <li>See above how to <a href="#filtermasking">add a Filter Mask</a>. Select Filter Mask <b>Alpha Shape Motion Tracked</b>.</li>
546 <li>Set mask parameters.</li>
547 <li>Press <b>Apply Motion Tracking Data</b> to create a motion tracked filter mask.</li>
548 </ol>
549
550
551 <h2>8. Stabilizing</h2>
552 <p>
553 In Flowblade stabilizing a video clip is implemented using filter <b>Stabilize</b> available in filter category <b>Movement or by creating a new, stabilized Media Item.</b>.
554 </p>
555 <p>
556 This filter requires two passes. The first pass performs analysis and stores the result internally in a file. After completed analysis stabilizing can be applied using the created data.
557 </p>
558
559 <h4>Parameters</h4>
560 <p>
561 <b>Analysis Shakiness</b> Used during analysis. How shaky the video is.
562 </p>
563 <p>
564 <b>Accuracy</b> Used during analysis. The accuracy of shakiness detection.
565 </p>
566 <p>
567 <b>Smoothing</b> Used during application. Number of frames for lowpass filtering (2N + 1 frames).
568
569 </p>
570 <p>
571 <b>Zoom</b> Used during application. Additional zoom amount.
572 </P>
573 <p>
574 <b>Analyze Video</b> Pressing this button analyzes video and saves the created data internally. Upon completion stabilizing is applied and can be controlled using <b>Smoothing</b> and <b>Zoom</b> parameters.
575 </p>
576
577
578
579 <h4>Creating Stabilized Media Item</h4>
580
581 <ul>
582 <li>
583 Select <b>Render Stabilized File</b> item from <i>Media Item</i> <b>Right mouse</b> context menu.
584 </li>
585 </ul>
586
587
588 <h2>9. Credits Scroll Generator</h2>
589 <h3>Overview</h3>
590 <p>
591 Flowblade offeres a <b>Credits Scroll Generator</b> to easily create title sequences.
592 </p>
593
594 <p>
595 <b>Credits Scroll Generator</b> has a number of editors to set <i>initial</i> properties of text font and layout.
596 Displayed text and commands to modify text presentation is inputted in text editor box in the <i>Text</i> panel.
597 </p>
598
599 <p>
600 Text is given using a <i>light weight markup syntax</i> that accepts three types of input: <b>credit blocks, section titles</b> and <b>commands</b>.
601 </P>
602
603 <h3>Credit Blocks</h3>
604 <p>
605 <b>Credit block</b> is a block of text beginning with a line starting with '#' followed by credit text, followed by one or more sequential lines giving names associated with the credit.
606 </p>
607 <p>
608 <b>Credit block</b> ends when empty line is encountered.
609 </p>
610
611 <div class="code-text">
612 <p> # Camera operators </p>
613 <p> Donald Drake </p>
614 <p> Earl Easter </p>
615 </div>
616
617 <h3>Section Titles</h3>
618 <p>
619 <b>Section Title</b> is a single line of text starting with '##' and followed by section title text.
620 </p>
621
622 <div class="code-text">
623 <p> ## Camera crew in Antarctica </p>
624 </div>
625
626
627 <h3>Commands</h3>
628
629 <p>
630 <b>Command</b> is a single line of text starting with '!' and followed by command arguments.
631 </p>
632
633 <p>
634 <b>Command</b> lines change font and layout properties from the ones given initially by user or do some other additional changes in the way that text is presented.
635 </p>
636
637 <div class="code-text">
638 <p> ! set-layout single-line-sides-justified</p>
639 </div>
640
641 <h3>Commands List</h3>
642 <p>
643 <b>ypad</b> ypad <i>PIXELS</i>
644 </p>
645
646 <p> Adds padding between credit items.
647 </p>
648 <p>
649 E.g. <i>! ypad 40</i>
650 </p>
651 <p>
652 <b>set-layout</b> set-layout <i>[single-line-centered | two line-centered | single-line-right-justified | two-line-right-justified | single-line-sides-justified | two-line-left-justified | two-columns-centered ]</i>
653 </p>
654 <p>
655 Switches to use defined credit item layout.
656 </p>
657 <p>
658 E.g. <i>! set-layout single-line-sides-justified</i>.
659 </p>
660
661 <p>
662 <b>text-case</b> <i>[ credit | name ] [ no-changes | uppercase | lowercase ]</i>
663 </p>
664
665
666 <p>
667 Sets credit or name text to be uppercase, lowercase or as written.
668 </p>
669
670 <p>
671 E.g. <i> ! text-case name lowercase </i>
672 </p>
673
674 <p>
675 <b>page</b> <i>[ PAGELENGHT]</i>
676 </p>
677
678
679 <p>
680 Begins new text page if animation set to be paged. Optionally sets length of time page is displayed in frames. If no time is given, the user set default value is used.
681 </p>
682
683 <p>
684 E.g. <i> ! page 230 </i>
685 </p>
686
687 <p>
688 <b>font-size</b> <i>[ credit | name ] FONTSIZE</i>
689 </p>
690 <p>
691 Sets font size for credit or name text.
692 </p>
693 <p>
694 E.g. <i>! font-size credit 100</i>
695 </p>
696
697 <p>
698 <b>font-family</b> <i>[ credit | name ] FONTFAMILY</i>
699 </p>
700
701 <p>
702 Sets font family for credit or name text. Available values for <i> FONTFAMILY</i> depend on system.
703 </p>
704 <p>
705 E.g. <i>! font-family credit Ubuntu Sans</i>
706 </p>
707 <p>
708 <b>font-face</b> <i>[ credit | name ] [ regular | italic | bold ]</i>
709 </p>
710 <p>
711 Sets font face for credit or name text.
712 </p>
713 <p>
714 E.g. <i>! font-face name italic</i>
715 </p>
716
717 <p>
718 <b>font-property </b> <i>[ credit | name ] [alignment | color-rgba | fill-on | outline-color-rgba | outline-on | outline-width | shadow-on | shadow-color-rgb | shadow-opacity | shadow-xoff | shadow-yoff | shadow-blur | gradient-color-rgba | gradient-direction ] PROPERTYVALUE </i>
719 </p>
720 <p>
721 Sets value for named font property for credit or name text. Allowed <i>PROPERTYVALUE</i> values are different for different named properties.
722 </p>
723
724 <p>
725 <i>Font Properties</i>
726 </p>
727 <table>
728 <thead>
729 <tr>
730 <th>Property </th><th> Value type</th><th>Example</th>
731 </tr>
732 </thead>
733 <tr>
734 <td> color-rgba </td><td> color tuple </td><td> color-rgba (1.0,0.0,0.0,1.0) </td>
735 </tr>
736 <tr>
737 <td> fill-on </td><td> boolean </td><td> fill-on False </td>
738 </tr>
739 <tr>
740 <td> outline-color-rgba </td><td> color tuple </td><td> outline-color-rgba (1.0,0.0,0.0,1.0) </td>
741 </tr>
742 <tr>
743 <td> outline-on </td><td> boolean </td><td> outline-on True </td>
744 </tr>
745 <tr>
746 <td> outline-width </td><td> int <i>(pixels)</i> </td><td> outline-width 4 </td>
747 </tr>
748 <tr>
749 <td> shadow-on </td><td> boolean </td><td> shadow-on True </td>
750 </tr>
751 <tr>
752 <td> shadow-color-rgb</td><td> color tuple </td><td> shadow-color-rgb (1.0,0.0,0.0,1.0) </td>
753 </tr>
754 <tr>
755 <td> shadow-opacity </td><td> int[0-100] </td><td> shadow-opacity 50</td>
756 </tr>
757 <tr>
758 <td> shadow-xoff </td><td> int <i>(pixels)</i></td><td> shadow-xoff 10 </td>
759 </tr>
760 <tr>
761 <td> shadow-yoff </td><td> int <i>(pixels)</i></td><td> shadow-yoff 7 </td>
762 </tr>
763 <tr>
764 <td> shadow-blur </td><td> int <i>(pixels)</i> </td><td> shadow-blur 8 </td>
765 </tr>
766 <tr>
767 <td> gradient-color-rgba </td><td> color tuple </td><td> gradient-color-rgba (1.0,0.0,0.0,1.0) </td>
768 </tr>
769 <tr>
770 <td> gradient-direction </td><td> int[0,1] <i>(VERTICAL = 0
771 HORIZONTAL = 1)</i></td><td> gradient-direction 1 </td>
772 </tr>
773 </table>
774
775 <p>
776 E.g. <i>! font-property credit color-rgba (1.0,0.0,0.0,1.0)
777 </p>
778 <p>
779 ! font-property name outline-on True
780 </p>
781 <p>
782 ! font-property credit shadow-yoff 7
783 </p>
784 <p>
785 ! font-property name gradient-direction 1</i>
786 </p>
787
788 <p>
789 <b>set-layout-property</b> <i>[ center-gap | line-gap | credit-block-gap | justified-x | justified-x-off | name-y-off | name-x-off | section-title-alignment ] PROPERTYVALUE </i>
790 </p>
791
792 <p>
793 Sets layout property value. <i>PROPERTYVALUE</i> integer value for number of pixels or pixel position.
794 </p>
795
796 <table>
797 <thead>
798 <tr>
799 <th>Property </th><th> Description</th>
800 </tr>
801 </thead>
802 <tr>
803 <td> center-gap </td><td> Gap between name and credit when on same line. </td>
804 </tr>
805 <tr>
806 <td> line-gap </td><td> Gap between lines. </td>
807 </tr>
808 <tr>
809 <td> credit-block-gap </td><td> Gap between credit blocks. </td>
810 </tr>
811 <tr>
812 <td> justified-x </td><td> Position of justified edge when using justified text layouts. </td>
813 </tr>
814 <tr>
815 <td> justified-x-off </td><td>Sets column width in "Single Line Sides Justified" layout.</td>
816 </tr>
817 <tr>
818 <td> name-y-off </td><td> Y offset of name position from default position in current layout. </td>
819 </tr>
820 <tr>
821 <td> name-x-off </td><td> X offset of name position from default position in current layout. </td>
822 </tr>
823 <tr>
824 <td> section-title-alignment </td><td> Sets section titles to be either centered or edge justified using justified-x value.</td>
825 </tr>
826 </table>
827
828 <p>
829 E.g. <i>! set-layout-property name-y-off -100</i>
830 </p>
831
832
833 <h2>10. Jog / Shuttle Support</h2>
834
835
836 <h3>Overview</h3>
837
838 <p>
839 Flowblade has a USB Human Input Device subsystem, which is capable of
840 supporting selected USB jog/shuttle devices.
841 </p>
842
843 <p>
844 A jog/shuttle gives you an additional way to navigate through your timeline
845 using a dedicated hardware control interface, in addition to the keyboard and
846 mouse.
847 </p>
848 <p>
849 Turning the jog wheel moves the playback location forward and backward, one
850 frame at a time.
851 </p>
852 <p>
853 Turning the shuttle left or right engages variable speed playback, in forward
854 or reverse. The farther you turn the ring, the faster it goes.
855 </p>
856 <p>
857 Additionally, most jog/shuttle devices have keys which can be mapped to
858 various actions within the program. Each supported device has default key
859 mappings, which can also be customized.
860 </p>
861
862 <h3>Supported Devices</h3>
863
864 <table>
865 <thead>
866 <tr>
867 <th>Manufacturer Device Name</th><th>Flowblade Device Name</th><th>Config File</th>
868 </tr>
869 </thead>
870 <tr>
871 <td>Contour Design ShuttlePRO v2</td><td>Contour Design ShuttlePRO v2</td><td>contour_design_shuttlepro_v2.xml</td>
872 </tr>
873 <tr>
874 <td>Contour Design ShuttleXpress</td><td>Contour Design ShuttleXpress</td><td>contour_design_shuttlexpress.xml</td>
875 </tr>
876 <tr>
877 <td>Contour A/V Solutions SpaceShuttle</td><td>Contour Design ShuttleXpress</td><td>contour_design_shuttlexpress.xml</td>
878 </tr>
879 </table>
880
881 <h3>Enabling Jog / Shuttle Support</h3>
882 <p>
883 Jog/shuttle support is not on by default in Flowblade, and must be enabled.
884 </p>
885 <p>
886 Additionally, Flowblade will not be able to access the USB device without
887 a small amount of operating system configuration to grant permissions so that
888 Flowblade is allowed to use the device.
889 </p>
890 <h4>Enable Device Permissions</h4>
891
892 <div class="important">
893 For Flatpaks and correctly created distro packages the required file has been added as part of the package. If for some reason the application is not able to access the USB device, try adding the file manually.</b>
894 </div>
895
896 <p>
897 In order for Flowblade to be able to read from the USB device, it is
898 necessary to tell your operating system to grant permissions on the device
899 to non-root users.
900 </p>
901 <p>
902 On Linux, this is done by adding a udev rules configuration file that
903 instructs the udev subsystem to enable additional access to your device.
904 </p>
905 <p>
906 Become the root user, and create a new text file at
907 `/etc/udev/rules.d/90-flowblade.rules` with the following contents:
908 </p>
909
910 <div class="code-text">
911 <p># Grant unprivileged users access to USB HID jog/shuttle devices</p>
912
913 <p># Contour Design ShuttleXpress, Contour A/V Solutions SpaceShuttle</p>
914 <p>ATTRS{idVendor}=="0b33", ATTRS{idProduct}=="0020", MODE="0666"</p>
915
916 <p># Contour Design ShuttlePRO v2</p>
917 <p>ATTRS{idVendor}=="0b33", ATTRS{idProduct}=="0030", MODE="0666"</p>
918 </div>
919
920 <p>
921 It may be necessary to reboot your computer after this step. This only
922 needs to be done once. It is also possible to tell the udev subsystem
923 to reload the config file instead of rebooting, but this is left as an
924 exercise for the reader.
925 </p>
926 <p>
927 <b>Don't forget to drop your root privileges after this step, before starting
928 Flowblade! Do not run Flowblade as root!</b>
929 </p>
930
931 <h4>Tell Flowblade to Use the Device</h4>
932
933 <p>
934 The next step is opening Flowblade, and enabling your device.
935 </p>
936 <p>
937 Go to the <b>Edit</b> menu, select <b>Preferences</b>, and then navigate over
938 to the <b>Jog/Shuttle</b> tab.
939 </p>
940 <p>
941 Check the <b>USB Jog/Shuttle Enabled</b> checkbox.
942 </p>
943 <p>
944 In the <b>Device</b> pull down menu, select the device driver that you wish to
945 use. The entries in this menu correspond to the <b>Flowblade Device Name</b> in
946 the <b>Supported Devices</b> section above.
947 </p>
948 <p>
949 Press <b>OK</b> to close the <b>Preferences</b> window.
950 </p>
951 <p>
952 After this, it will be necessary to exit Flowblade and restart it.
953 </p>
954 <p>
955 At this point, the USB jog/shuttle configuration is part of your saved
956 Flowblade preferences. You will now be able to use the program with or
957 without the jog/shuttle, without any further configuration necessary.
958 </p>
959 <p>
960 Please note that Flowblade will only check for the presence of the USB device
961 at startup, so make sure to have the device plugged in before you start
962 Flowblade if you want to use it.
963 </p>
964
965 <h3>Custom Key Mappings</h3>
966
967 <p>
968 Flowblade ships with XML config files that provide default key mappings
969 between the keys on your USB jog/shuttle device, and various actions in
970 Flowblade. It is possible to customize these mappings, by copying the
971 appropriate file into the correct user preferences directory, and modifying
972 the local copy.
973 </p>
974 <p>
975 The precise location of these config files can vary depending on how you
976 have installed Flowblade. You want to find the `res/usbhid` directory
977 under the Flowblade installation. From there, you will want to copy the config
978 file for your particular USB jog/shuttle device to a location in your local
979 user preferences directory.
980 </p>
981 <p>
982 For example, if you installed Flowblade on Ubuntu using the OS packaging
983 system, and you have a Contour Design ShuttleXpress, then you would want to
984 copy the
985 `/usr/share/flowblade/Flowblade/res/usbhid/contour_design_shuttlexpress.xml`
986 file into
987 `.local/share/flowblade/user_usbhid/contour_design_shuttlexpress.xml` under
988 your home directory.
989 </p>
990 <p>
991 Open up the new local copy of the file under your home directory in a text
992 editor. You will see more information in the comments of the file about how
993 the keys are laid out on your particular device. Under the _keymap_ section
994 of the config file, you can edit the _code_ settings to point to different
995 _target actions_ that Flowblade can perform, for each of the keys on the
996 device.
997 </p>
998 <p>
999 Once your file is complete, save and close the file, and start Flowblade.
1000 Now your new custom key mappings will be in effect every time you run the
1001 program.
1002 </p>
1003 <p>
1004 Take care not to introduce any XML errors into the file, or Flowblade will
1005 not be able to process it correctly.
1006 </p>
1007 <p>
1008 See the next section for all of the target actions that can be mapped to
1009 the keys on your device.
1010 </p>
1011 <h4>Available Target Actions</h4>
1012
1013 <table>
1014 <thead>
1015 <tr>
1016 <th>Target Action </th><th> Description</th>
1017 </tr>
1018 </thead>
1019 <tr>
1020 <td>3_point_overwrite </td><td> Three Point Overwrite
1021 </tr>
1022 <tr>
1023 <td>add_marker </td><td> Add Marker</td>
1024 </tr>
1025 <tr>
1026 <td>append </td><td>Append</td>
1027 </tr>
1028 <tr>
1029 <td>append_from_bin </td><td> Append Selected Media From Bin</td>
1030 </tr>
1031 <tr>
1032 <td>clear_io_marks </td><td> Clear In/Out Marks</td>
1033 </tr>
1034 <tr>
1035 <td>clear_mark_in </td><td> Clear Mark In</td>
1036 </tr>
1037 <tr>
1038 <td>clear_mark_out </td><td> Clear Mark Out</td>
1039 </tr>
1040 <tr>
1041 <td>cut </td><td> Cut Active Tracks</td>
1042 </tr>
1043 <tr>
1044 <td>cut_all </td><td> Cut All Tracks</td>
1045 </tr>
1046 <tr>
1047 <td>delete </td><td> Delete</td>
1048 </tr>
1049 <tr>
1050 <td>display_clip_in_monitor </td><td> Display Clip In Monitor</td>
1051 </tr>
1052 <tr>
1053 <td>display_sequence_in_monitor </td><td> Display Current Sequence In Monitor</td>
1054 </tr>
1055 <tr>
1056 <td>enter_edit </td><td> Enter Editing Mode</td>
1057 </tr>
1058 <tr>
1059 <td>faster </td><td> Faster</td>
1060 </tr>
1061 <tr>
1062 <td>insert </td><td> Insert</td>
1063 </tr>
1064 <tr>
1065 <td>lift </td><td> Lift</td>
1066 </tr>
1067 <tr>
1068 <td>log_range </td><td> Log Range</td>
1069 </tr>
1070 <tr>
1071 <td>mark_in </td><td> Mark In</td>
1072 </tr>
1073 <tr>
1074 <td>mark_out </td><td> Mark Out</td>
1075 </tr>
1076 <tr>
1077 <td>next_cut </td><td> Go To Next Cut</td>
1078 </tr>
1079 <tr>
1080 <td>next_frame </td><td> Go To Next Frame</td>
1081 </tr>
1082 <tr>
1083 <td>nudge_back </td><td> Nudge Move Selection Back 1 Frame</td>
1084 </tr>
1085 <tr>
1086 <td>nudge_back_10 </td><td> Nudge Move Selection Back 10 Frames</td>
1087 </tr>
1088 <tr>
1089 <td>nudge_forward </td><td> Nudge Move Selection Forward 1 Frame</td>
1090 </tr>
1091 <tr>
1092 <td>nudge_forward_10 </td><td> Nudge Move Selection Forward 10 Frames</td>
1093 </tr>
1094 <tr>
1095 <td>open_next </td><td> Open Next Media Item In Monitor</td>
1096 </tr>
1097 <tr>
1098 <td>open_prev </td><td> Open Previous Media Item In Monitor</td>
1099 </tr>
1100 <tr>
1101 <td>overwrite_range </td><td> Overwrite Range</td>
1102 </tr>
1103 <tr>
1104 <td>play </td><td> Play</td>
1105 </tr>
1106 <tr>
1107 <td>play_pause </td><td> Play / Pause</td>
1108 </tr>
1109 <tr>
1110 <td>play_pause_loop_marks </td><td> Play / Pause Mark In to Mark Out Loop</td>
1111 </tr>
1112 <tr>
1113 <td>prev_cut </td><td> Go To Previous Cut</td>
1114 </tr>
1115 <tr>
1116 <td>prev_frame </td><td> Go To Previous Frame</td>
1117 </tr>
1118 <tr>
1119 <td>resync </td><td> Resynchronization</td>
1120 </tr>
1121 <tr>
1122 <td>select_next </td><td> Open Next Clip In Filter Editor</td>
1123 </tr>
1124 <tr>
1125 <td>select_prev </td><td> Open Previous Clip In Filter Editor</td>
1126 </tr>
1127 <tr>
1128 <td>sequence_split </td><td> Sequence Split</td>
1129 </tr>
1130 <tr>
1131 <td>slower </td><td> Slower</td>
1132 </tr>
1133 <tr>
1134 <td>stop </td><td> Stop</td>
1135 </tr>
1136 <tr>
1137 <td>switch_monitor </td><td> Switch Monitor Display</td>
1138 </tr>
1139 <tr>
1140 <td>to_end </td><td> Go To End</td>
1141 </tr>
1142 <tr>
1143 <td>toggle_ripple </td><td> Toggle Ripple</td>
1144 </tr>
1145 <tr>
1146 <td>to_mark_in </td><td> Go To Mark In</td>
1147 </tr>
1148 <tr>
1149 <td>to_mark_out </td><td> Go To Mark Out</td>
1150 </tr>
1151 <tr>
1152 <td>to_start </td><td> Go To Start</td>
1153 </tr>
1154 <tr>
1155 <td>trim_end </td><td> Trim Clip End To Playhead</td>
1156 </tr>
1157 <tr>
1158 <td>trim_start </td><td> Trim Clip Start To Playhead</td>
1159 </tr>
1160 <tr>
1161 <td>zoom_in </td><td> Zoom In</td>
1162 </tr>
1163 <tr>
1164 <td>zoom_out </td><td> Zoom Out</td>
1165 </tr>
1166 </table>
1167
1168
1169 </div>
1170 </div>
1171 </div>
1172
1173
1174 </body>
1175
1176 </html>