Kdenlive/Development/CleaningEffects: Difference between revisions

From KDE Community Wiki
 
(30 intermediate revisions by 2 users not shown)
Line 2: Line 2:
=Goal of the working group=
=Goal of the working group=


There is currently a great deal of effects, of different quality and relevance. The goal is to clean up the effect list, to get better visibility and usability.  One main idea would be to create  a "Legacy" category and place in it non-working, or redundant effects
There is currently a great deal of effects, of different quality and relevance. The goal is to clean up the effect list, to get better visibility and usability, and also to evolve the effect management.
 
The list of [https://invent.kde.org/kde/kdenlive/issues?label_name%5B%5D=Effects Effect related issues] on Gitlab
 
A lot of the discussion is currently happening on [https://invent.kde.org/kde/kdenlive/issues/350 Issue #350].
 
JBM wrote a document for the effects mini sprint of the 2019/11/1 : https://share.kde.org/s/5GMats9HNgeoL3e
 
=Effect management=
 
 
 
== Effect categories ==
 
=== Current paradigm ===
 
There is currently 5 top categories for effects :
   
* Main effects
* Video effects
* Audio effects
* Custom effects
* Favorite effects
 
These categories don't share the same status, though.
 
* The first three are functional categories, divided into subcategories :
* Custom effects are existing effects with a custom preset
 
 
 
 
=== New paradigm ===
 
 
==== How favorites work ====
 
 
 
 
==== Reducing the number of effects ====
 
One main idea would be to create  a "Legacy" category and place in it non-working, or redundant effects
 
 
 
=== Current implementation ===
 
The effects are categorized in [https://invent.kde.org/kde/kdenlive/blob/master/data/kdenliveeffectscategory.rc <code>./data/kdenliveeffectscategory.rc</code>]
 
The structure of XML files for effect description is detailed in [https://invent.kde.org/kde/kdenlive/blob/master/data/effects/README <code>./data/effects/README</code>]
 
 
=== Suggested implementation ===
 
 
 
 
== Searching the effects ==
 
 
Currently the search feature is accessible in the same visual way as the different categories.
 
The idea would be to have it accross the whole box, as described [https://invent.kde.org/kde/kdenlive/issues/350#note_13660 in this comment].
 
[[File:SearchEffects.png|center]]
 
This has been implemented.
 
 
 
== Custom effects versus Presets ==


= Table  of effects =
= Table  of effects =


To get the full list of effects available :  
The full list of effects available from your mlt installation can be retrieved by:  
 
<pre>melt -query filters</pre>
 
Kdenlive will blacklist some of these effects, as listed in [https://invent.kde.org/kde/kdenlive/blob/master/data/blacklisted_effects.txt <code>./data/blacklisted_effects.txt</code>]
 
 
The review of [https://lite.framacalc.org/kdenlive-effects the different effects in a share spreadsheet].
 


<code>melt -query filters</code>


Then further informations can be found in  ./data/kdenliveeffectscategory.rc


== Colour correction ==
== Alpha/Transform ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!19.12 status
!Action decided
!Comments
|-
|-
|-
|-  
|Colour correction
|Alpha gradient
|Lift/gamma/gain
|OK
|
|OK
|No
|
|
|
|
|-
|-
|Colour correction
|Alpha operations
|Brightness (keyframable)
|OK
|Change image brightness with keyframes
|OK
|Yes
|Fixed in 19.08
|
|Controls are missing the radio buttons that were in 18.12, but I don’t know if it affects in a negative way
|
|-
|Alpha Shapes
|OK
|OK
|Cannot see problem
|Min misbehaving
|-
|Chroma Key
|OK
|OK
|Fixed in 19.12
|weird standard configuration
|-
|Chroma-key
|OK
|OK
|OK?
|I guess
|-
|-
|Colour correction
|Key Spill Mop Up
|Gamma
|OK
|Change gamma color value
|OK
|Yes
|
|
|
|
|-
|-
|Colour correction
|Rectangular Alpha mask
|White Balance (LMS space)
|OK
|Do simple color correction, in a physically meaningful
|OK
way
|OK
|Yes
|
|
|
|-
|-
|Colour correction
|Rotoscoping
|White Balance
|OK
|Adjust the white balance / color temperature
|OK
|Yes
|OK
|
|
|
|-
|-
|Colour correction
|}
|Brightness
 
|Adjusts the brightness of a source image
== Analysis and data ==
|No
|What advantages over Brightness (keyframable) ?
{| class="wikitable"
|
!Effect name
!18.12.1d
!19.04 refactoring (046d5002)
!Comments
|-
|-
|Colour correction
|-
|Levels
|Audio Spectrum filter
|Adjust levels
|?
|No
|?
|
|I see no effect or I don’t know how to use it
|
|-
|-
|Colour correction
|Audio Wave
|3 point balance
|?
|Balances colors along with 3 points
|?
|No
|I see no effect or I don’t know how to use it
|
|
|-
|-
|Colour correction
|Oscilloscope
|Curves
|OK
|Color curves adjustment
|OK
|No
|What advantages over Bézier Curves ?
|
|
|-
|-
|Colour correction
|RGB Parade
|RGB adjustment
|OK
|Simple color adjustment
|OK
|Yes
|
|
|
|-
|-
|Colour correction
|Timeout indicator
|SOP/Sat
|OK
|Changes Slope, Offset, and Power of the color components, and the overall Saturation, according to the ASC CDL (Color Decision List).
|OK
|Yes
|Could be enhanced by adding the ability to use sprites or numbers
|
|
|-
|-
|Colour correction
|Vectorscope
|Bézier Curves
|OK
|Color curves adjustment
|OK
|No
|
|
|
|-
|-
|Colour correction
|Video values
|CMYK adjust (avfilter)
|OK
|Apply CMYK correction to specific color ranges
|OK
|No
|Really useful effect but could be enhanced by adding the ability to interact with it in the monitor
|Seems buggy in current git commit 68574e5699e23dd38d40d34e1e3687c5d958eaf7
|
|-
|-
|Colour correction
|Apply LUT
|Apply a Look Up Table (LUT) to the video.
|No
|
|
|}
|}
== Colour  ==
== Artistic ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|-
|3-level Threshold
|OK
|OK
|
|-
|-
|Colour
|Binarize
|Invert
|OK
|Invert colors
|OK
|
|
|
|-
|Binarize dynamically
|OK
|OK
|
|
|-
|-
|Colour
|BurningTV
|Sepia
|MISSING
|Turn clip colors to sepia
|OK
|
|Is this new?
|
|-
|
|Cartoon
|SEMI-BROKEN
|BROKEN
|Changing difference space breaks it in 18.12
|-
|-
|Colour
|Charcoal
|Technicolor
|OK
|Oversaturate the color in video, like in old Technicolor movies
|OK
|
|
|
|
|-
|-
|Colour
|Dither
|Greyscale
|OK
|Discard color information
|OK
|
|
|
|
|-
|-
|Colour
|Dust
|frei0r.B
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Colour
|Emboss
|frei0r.G
|OK
|No file effect found
|OK
|
|I can see very small differences on refactoring but that could be me using proxy clips>'''Defaults fixed in 19.12'''.
|
|
|-
|-
|Colour
|Grain
|frei0r.R
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Colour
|Oldfilm
|Contrast
|OK
|Adjusts the contrast of a source image
|OK
|
|
|
|
|-
|-
|Colour
|Posterize
|Saturation
|OK
|Adjusts the saturation of a source image
|OK
|
|
|
|
|-
|-
|Colour
|Rgbnoise
|Tint
|OK
|Maps source image luminance between two colors specified
|OK
|
|
|
|
|-
|-
|Colour
|Scratchlines
|Primaries
|OK
|Reduce image to primary colors
|OK
|
|
|
|
|-
|-
|Colour
|Sigmoidaltransfer
|Chroma Hold
|OK
|Make image greyscale except for chosen color
|OK
|
|
|
|
|-
|-
|Colour
|Sobel
|frei0r.colorize
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Colour
|Thresold
|Equaliz0r
|OK
|Equalizes the intensity histograms
|OK
|
|
|
|
|-
|-
|Colour
|Vignette
|Hue shift
|OK
|Shifts the hue of a source image
|OK
|
|
|
|
|-
|-
|Colour
|Vignette Effect
|Luminance
|OK
|Creates a luminance map of the image
|OK
|
|
|
|
|-
|-
|Colour
|lumaliftgaingamma
|No file effect found
|
|
|
|}
|}
== Crop and transform ==
 
== Blur and hide ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|Auto Mask
|OK
|SEMI-BROKEN
|This effect needs some improvement. Seems to misbehave on refactoring (selects the incorrect region)
|-
|-
|Blur
|OK
|SEMI-BROKEN
|Works in refactoring but it’s missing the blur types > '''Fixed in 19.08'''
|-
|-
|Crop and transform
|Box Blur
|LetterB0xed
|OK
|Adds black borders at top and bottom for cinema look
|OK
|
|
|
|
|-
|-
|Crop and transform
|Edge glow
|Position and Zoom
|OK
|Adjust size and position of clip
|OK
|
|Keyframes are a very good addition
|Isn't this redundant with Compose and transform ?
|
|-
|-
|Crop and transform
|Glow
|Crop, Scale and Tilt
|OK
|Scales, Tilts and Crops an Image
|OK
|
|
|
|
|-
|-
|Crop and transform
|Medians
|Edge Crop
|OK (?)
|Trim the edges of a clip
|OK (?)
|
|Guess it works. I really don’t know how to use it and have no use for it now
|
|
|-
|-
|Crop and transform
|Obscure
|affine
|OK
|No file effect found
|SEMI-BROKEN
|
|The pixels on refactoring are too wide > '''Fixed in 19.12'''
|
|
|-
|-
|Crop and transform
|Softglow
|affinerotate
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Crop and transform
|Square Blur
|nosync0r
|OK
|Broken TV
|OK
|
|
|
|
|-
|-
|Crop and transform
|Transform
|Position, scale and opacity.
|
|
|
|}
|}
== Audio correction ==
 
== Colour ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|-
|B
|MISSING
|OK
|
|-
|-
|Audio correction
|Chroma Hold
|Volume (keyframable)
|OK
|Adjust audio volume with keyframes
|OK
|
|
|-
|Colorize
|OK
|OK
|
|
|-
|Contrast
|OK
|OK
|
|
|-
|-
|Audio correction
|Equaliz0r
|Normalise
|OK
|Dynamically normalise the audio volume
|OK
|
|
|-
|G
|MISSING
|OK
|
|
|-
|Greyscale
|OK
|OK
|
|
|-
|-
|Audio correction
|Hue shift
|Gain
|OK
|Adjust the audio volume without keyframes
|OK
|
|
|-
|Invert
|OK
|OK
|
|
|-
|LumaLiftGainGamma
|BROKEN
|BROKEN
|Can’t interact with the sliders. Don’t see the use of it with the rest of the colour correction effects > '''Fixed in 19.08'''
|-
|Luminance
|OK
|OK
|
|
|-
|-
|Audio correction
|Primaries
|ladspa.1049
|OK
|No file effect found
|OK
|
|
|-
|R
|MISSING
|OK
|
|
|-
|Saturation
|OK
|OK
|
|
|-
|-
|Audio correction
|Sepia
|ladspa.1048
|OK
|No file effect found
|OK
|
|
|
|-
|Technicolor
|OK
|OK
|
|
|-
|-
|Audio correction
|Tint
|ladspa.1413
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Audio correction
|Mute
|Mute clip
|
|
|
|}
|}


== Audio Channels ==  
== Colour correction ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|3 point balance
|OK
|OK
|
|-
|-
|Apply LUT
|OK
|SEMI-BROKEN
|Drag and drop not working in refactoring > '''Fixed in 19.12'''
|-
|-
|Audio channels
|Bézier Curves
|Balance
|OK
|Adjust the left/right balance
|BROKEN
|Does not show the correct overlay for each colour in refactoring > '''Cannot reproduce in 19.12'''
|-
|Brightness
|OK
|OK
|
|
|-
|Brightness (keyframable)
|OK
|OK
|
|
|-
|CMYK adjust (avfilter)
|OK
|BROKEN
|Not implemented in refactoring
|-
|Curves
|OK
|OK
|Does not show the correct overlay for each colour in refactoring> '''Cannot reproduce in 19.12'''
|-
|Gamma
|OK
|OK
|
|
|-
|-
|Audio channels
|Levels
|Pan
|OK
|Adjust the left/right spread of a channel
|OK
|
|
|
|-
|Lift/gamma/gain
|OK
|OK
|A way to interact directly with the numbers under the wheels would be nice
|-
|RGB adjustment
|OK
|OK
|
|
|-
|-
|Audio channels
|SOP/Sat
|Swap channels
|OK
|Move the left channel to the right and right-to-left
|OK
|
|Sometimes gives a black screen in refactoring > '''Fixed in 19.12'''
|
|-
|White Balance
|OK
|OK
|
|
|-
|-
|Audio channels
|White Balance (LMS space)
|ladspa.1406
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Audio channels
|Mono to stereo
|Copy one channel to another
|
|
|
|}
|}


== Analysis and data ==  
== Crop and transform ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|-
|Crop, Scale and Tilt
|OK
|OK
|
|-
|-
|Analysis and data
|Edge Crop
|Audio Wave
|OK
|Display the audio waveform instead of the video
|OK
|
|
|
|-
|LetterB0xed
|OK
|OK
|
|
|-
|-
|Analysis and data
|nosync0r
|audiospectrum
|OK
|No file effect found
|OK
|
|
|
|
|-
|-
|Analysis and data
|Position and Zoom
|Video values
|OK
|Measure video values
|OK
|
|
|
|
|-
|-
|Analysis and data
|Rotate (keyframable)
|Oscilloscope
|OK
|2D video oscilloscope
|OK
|
|
|
|
|-
|-
|Analysis and data
|Rotate and Shear
|RGB Parade
|OK
|Display a histogram of R, G and B components of the video data
|OK
|
|
|
|
|-
|-
|Analysis and data
|Transform
|Timeout indicator
|OK
|
|OK
|
|
|
|
|-
|-
|Analysis and data
|Vectorscope
|Display a vectorscope of the video data
|
|
|
|}
|}
== Fade ==
== Distort ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|-
|Corners
|OK
|SEMI-BROKEN
|Does not seem to let the user change the points in the monitor in refactoring >> '''Seems fixed in 19.08'''
|-
|-
|Fade
|Defish
|Fade from Black
|OK
|Fade video from black
|OK
|
|
|-
|Distort
|OK
|OK
|
|
|-
|Lens Correction
|OK
|OK
|
|
|-
|-
|Fade
|Mirror
|Fade to Black
|OK
|Fade video to black
|OK
|
|
|-
|Pixelize
|OK
|BROKEN
|
|
|-
|Wave
|OK
|BROKEN
|
|
|-
|-
|Fade
|}
|Fade in
 
|Fade in audio track
== Enhancement ==
{| class="wikitable"
!Effect name
!18.12.1d
!19.04 refactoring (046d5002)
!Comments
|-
|-
|Denoiser
|OK
|OK
|
|
|-
|Nikon D90 Stairstepping fix
|OK (?)
|OK (?)
|Guess it works, I don’t have Nikon D90 footage to test
|-
|Sharpen
|BROKEN
|OK
|Fixed in refactoring (Thanks!)
|-
|Spillsupress
|OK
|OK
|
|
|-
|}
== Motion ==
{| class="wikitable"
!Effect name
!18.12.1d
!19.04 refactoring (046d5002)
!Comments
|-
|-
|Freeze
|OK
|OK
|
|
|-
|-
|Fade
|Fade out
|Fade out audio track
|
|
|
|}
|}
== Artistic ==  
== Misc ==  
{| class="wikitable"
{| class="wikitable"
!Category
!Effect name
!Effect name
!Description
!18.12.1d
!K.F.
!19.04 refactoring (046d5002)
!Notes
!Comments
!Action decided
|-
|-
|-
|Apply a filter mask
|?
|?
|Don’t know how to use
|-
|-
|Artistic
|Atadenoise
|burningtv
|BROKEN
|No file effect found
|MISSING
|
|
|-
|Avgblur
|BROKEN (?)
|MISSING
|Doesn’t look right to me
|-
|Baltan
|OK
|OK
|
|
|-
|BgSubtract0r
|BROKEN (?)
|BROKEN (?)
|Black screen
|-
|Bitplanedenoise
|BROKEN (?)
|BROKEN (?)
|Either broken or don’t know it’s use
|-
|Boxblur
|OK
|OK
|Deduplicated in refactoring
|-
|BurningTV
|MISSING
|OK
|Duplicated in Artistic (Artistcic is it’s place)
|-
|Bwdif
|BROKEN
|MISSING
|
|
|-
|-
|Artistic
|Cairogradient
|Charcoal
|OK
|Charcoal drawing effect
|OK
|“Start color” and “End color” strings missing in refactoring
|-
|Cairoimagegrid
|OK
|OK
|
|
|-
|Chromakey
|BROKEN
|MISSING
|Not needed
|-
|Ciescope
|BROKEN (?)
|OK
|Implemented in refactoring (?)
|-
|Color Distance
|OK
|OK
|
|
|-
|Color Effect
|OK
|OK
|Should be in “Colour”
|-
|Colorbalance
|MISSING
|OK
|Should be in “Colour”
|-
|Colorchannelmixer
|OK
|OK
|Should be in “Colour”
|-
|Colorhalftone
|OK
|OK
|Should be in “Colour”. More stable in refactoring
|-
|Colorkey
|BROKEN
|MISSING
|Not needed
|-
|Colorlevels
|OK
|OK
|Should be in “Colour”
|-
|Colormatrix
|BROKEN
|MISSING
|
|
|-
|-
|Artistic
|Colorspace
|Dust
|BROKEN
|Add dust and specks to the video, as in old movies
|MISSING
|
|
|-
|Convolution
|BROKEN
|MISSING
|
|
|-
|Cropdetect
|BROKEN
|MISSING
|
|
|-
|-
|Artistic
|Dance
|Cartoon
|OK (?)
|Cartoonify video, do a form of edge detect
|OK (?)
|Guess it works, did not test with compositing to make it work
|-
|Datascope
|BROKEN
|MISSING
|
|
|-
|Dctdnoiz
|BROKEN (?)
|MISSING
|I don’t know if it’s broken or if it is a weird effect
|-
|Deband
|BROKEN
|MISSING
|
|
|-
|Deflate
|BROKEN
|MISSING
|
|
|-
|-
|Artistic
|Deflicker
|frei0r.dither
|MISSING
|No file effect found
|?
|Don’t know what’s supposed to do
|-
|Delay grab
|OK
|OK
|Yeah cool, but what use does it have in a video editor?
|-
|delay0r
|OK (?)
|OK (?)
|I think it has an effect but I don’t know how to use it
|-
|Delogo
|?
|?
|Don’t know anything at all about this effect
|-
|Deshake
|?
|MISSING
|Don’t know anything at all about this effect
|-
|Denoise_vaapi
|MISSING
|?
|Don’t know if it has an effect
|-
|Dilation
|?
|?
|No idea
|-
|Drawbox
|OK (?)
|MISSING
|Draws a box around the video, simple enough. Why has it been removed?
|-
|Drawgraph
|?
|?
|
|
|-
|Drawgrid
|BROKEN
|MISSING
|
|
|-
|Dynamic Text
|OK
|OK
|
|
|-
|-
|Artistic
|Edgedetect
|frei0r.emboss
|OK
|No file effect found
|OK
|Artistic?
|-
|Elbg
|BROKEN
|MISSING
|
|
|-
|Entropy
|MISSING
|?
|What it is supposed to do?
|-
|Eq
|?
|MISSING
|
|
|-
|Erosion
|?
|?
|
|
|-
|-
|Artistic
|Face blur
|frei0r.posterize
|MISSING
|No file effect found
|CRASH
|
|
|-
|Face detect
|MISSING
|?
|Don’t know what is supposed to do
|-
|Fftfilt
|?
|?
|Makes colours
|-
|Field order
|MISSING
|?
|
|
|-
|Fillborders
|MISSING
|?
|
|
|-
|-
|Artistic
|Flippo
|frei0r.rgbnoise
|OK
|No file effect found
|OK
|Should be in “Crop and transform”
|-
|Fspp
|OK (?)
|MISSING
|Why has it been removed?
|-
|Gblur
|OK (?)
|MISSING
|Seems to work, but I’m not sure
|-
|Glitch0r
|OK
|OK
|Should be in “Artistic” or “Distort”
|-
|Gradfun
|OK
|BROKEN
|Should be fixed
|-
|Greyscale
|MISSING
|OK
|Duplicated?
|-
|Histeq
|OK
|OK
|Interesting effect. Could fit in “Artistic”
|-
|Histogram
|BROKEN
|OK
|Should be in “Analysis and data”
|-
|Hqdn3d
|BROKEN
|MISSING
|
|
|-
|Hqx
|?
|MISSING
|
|
|-
|Hue
|?
|MISSING
|
|
|-
|-
|Artistic
|Hwmap
|frei0r.sigmoidaltransfer
|MISSING
|No file effect found
|?
|
|
|
|
|-
|-
|Artistic
|Hwupload
|Sobel
|MISSING
|Sobel filter
|?
|
|
|
|
|-
|-
|Artistic
|Hwupload_cuda
|3-level Threshold
|?
|Dynamic 3-level thresholding
|MISSING
|
|
|
|
|-
|-
|Artistic
|Idet
|Threshold
|?
|Thresholds a source image
|MISSING
|
|
|
|
|-
|-
|Artistic
|Inflate
|Binarize dynamically
|?
|Dynamic thresholding
|?
|
|
|
|
|-
|-
|Artistic
|K-Means Clustering
|Vignette
|OK
|Natural lens vignetting effect
|OK
|
|Should be in “Artistic”
|
|
|-
|-
|Artistic
|Kerndeint
|Grain
|MISSING
|Grain over the image
|?
|
|
|
|
|-
|-
|Artistic
|Lenscorrection
|lines
|BROKEN
|No file effect found
|MISSING
|
|Not neede and seems glitched
|
|
|-
|-
|Artistic
|Light Graffiti
|Light Graffiti
|This effect allows to do Light Painting (i.e. painting with light sources on a photo by keeping the shutter opened for a while), but for video.
|?
|?
|Don’t know how to use
|-
|Light Show
|?
|?
|
|
|-
|Limiter
|MISSING
|?
|
|
|-
|Loop
|?
|MISSING
|
|
|-
|-
|Artistic
|Lumakey
|Oldfilm
|OK
|Moves the Picture up and down and random brightness change
|OK
|
|
|-
|Lut
|?
|MISSING
|
|
|-
|Lutrgb
|?
|MISSING
|
|
|-
|-
|Artistic
|Lutyuv
|Binarize
|?
|Make monochrome clip
|MISSING
|
|
|-
|Mestimate
|?
|MISSING
|
|
|-
|Motion tracker
|OK (?)
|MISSING
|Could be useful
|-
|NDVI filter
|OK
|OK
|
|
|-
|-
|Artistic
|Nervous
|Vignette Effect
|OK
|Adjustable Vignette
|OK
|
|
|-
|Nlmeans
|BROKEN
|MISSING
|
|
|-
|Noise
|BROKEN
|OK
|
|
|}
== Blur and hide ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Normaliz0r
|OK
|OK
|Missing strings “BlackPt” and “WhitePt”
|-
|-
|Blur and hide
|Normalize
|Box Blur
|MISSING
|Box blur (separate horizontal and vertical blur)
|?
|
|
|
|
|-
|-
|Blur and hide
|Ocv
|Obscure
|MISSING
|Hide a region of the clip
|?
|
|
|
|
|-
|-
|Blur and hide
|Oscilloscope
|autotrack_rectangle
|MISSING
|No file effect found
|BROKEN (?)
|
|Duplicated
|
|
|-
|-
|Blur and hide
|Owdenoise
|Square Blur
|?
|Square blur
|MISSING
|
|
|
|
|-
|-
|Blur and hide
|Pad
|Glow
|?
|Creates a Glamorous Glow
|MISSING
|
|
|
|
|-
|-
|Blur and hide
|Perspective
|Blur
|BROKEN
|Blur using 2D IIR filters (Exponential, Lowpass, Gaussian)
|MISSING
|
|
|
|
|-
|-
|Blur and hide
|Pp
|Edge glow
|?
|Edge glow filter
|MISSING
|
|
|
|
|-
|-
|Blur and hide
|Pp7
|Medians
|?
|Implements several median-type filters
|MISSING
|
|
|
|
|-
|-
|Blur and hide
|Premultiply or Unpremultiply
|frei0r.softglow
|?
|No file effect found
|?
|
|
|
|
|}
== Motion ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Prewitt
|OK (?)
|MISSING
|Could fit in “Artistic”
|-
|-
|Motion
|Precamp_vaapi
|Speed
|MISSING
|Make clip play faster or slower
|?
|
|
|
|
|-
|-
|Motion
|Pseudocolor
|Freeze
|MISSING
|Freeze video on a chosen frame
|OK
|
|
|
|
|}
==  Distort ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Qtext
|OK
|MISSING
|Don’t know which use does it have with Title Clips but wouldn’t remove it either
|-
|-
|Distort
|Random
|Wave
|?
|Make waves on your clip with keyframes
|?
|
|
|
|
|-
|-
|Distort
|Removegrain
|Mirror
|?
|Flip your image in any direction
|MISSING
|
|Maybe it works, don’t have appropiate footage to test
|
|
|-
|-
|Distort
|Rescale
|Distort
|MISSING
|Plasma
|OK
|
|
|
|
|-
|-
|Distort
|Rgbsplit0r
|Lens Correction
|BROKEN (?)
|Allows compensation of lens distortion
|MISSING
|
|Black screen
|
|
|-
|-
|Distort
|Rotate
|Corners
|BROKEN
|Four corners geometry engine
|MISSING
|
|
|
|
|-
|-
|Distort
|Sab
|Defish
|?
|Non rectilinear lens mappings
|?
|
|Don’t know what’s supposed to do
|
|
|-
|-
|Distort
|scanline0r
|Pixelize
|OK
|Pixelize input image.
|OK
|
|I wonder if it could use some parameters
|
|
|}
== Alpha manipulation ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Setrange
|MISSING
|?
|I see no effect, don’t know if it works
|-
|-
|Alpha manipulation
|Setup a filter mask
|Chroma Key
|OK (?)
|Make selected color transparent
|MISSING
|
|Just leaves a square similar to shape alpha
|
|
|-
|-
|Alpha manipulation
|Shape Alpha
|Alpha operations
|BROKEN
|Display and manipulation of the alpha channel
|BROKEN
|
|Non functional and duplicated
|
|
|-
|-
|Alpha manipulation
|Sharpness_vaapi
|Alpha gradient
|MISSING
|Fill the alpha channel with a specified gradient
|?
|
|Vaapi effects have no effect for me, but could be my setup
|
|
|-
|-
|Alpha manipulation
|Shuffleframes
|Alpha shapes
|?
|Draws simple shapes into the alpha channel
|MISSING
|
|No effect/Don’t know what it does
|
|
|-
|-
|Alpha manipulation
|Shuffleplanes
|frei0r.transparency
|?
|No file effect found
|?
|
|No effect/Don’t know what it does
|
|
|-
|-
|Alpha manipulation
|Signalstats
|Color Selection
|BROKEN
|Color based alpha selection
|MISSING
|
|
|
|
|-
|-
|Alpha manipulation
|Smartblur
|Rectangular Alpha mask
|OK
|Creates an square alpha-channel mask
|OK
|
|Should be in “Blur and hide”
|Isn't it redundant with Alpha Shapes ?
|
|-
|-
|Alpha manipulation
|Spot Remover
|Rotoscoping
|?
|Keyframable vector based rotoscoping
|MISSING
|
|
|
|
|-
|-
|Alpha manipulation
|Spp
|Key Spill Mop Up
|?
|Reduces the visibility of key color spill in chroma keying
|?
|
|
|
|
|}
== Enhancement ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Swaprect
|OK (?)
|OK (?)
|Different behaviour in refactoring
|-
|-
|Enhancement
|Tblend
|Nikon D90 Stairstepping fix
|?
|Removes stairstepping artifacts from Nikon D90's 720p videos.
|MISSING
|
|
|
|-
|TehRoxx0r
|OK (?)
|MISSING
|
|
|-
|-
|Enhancement
|Text
|Denoiser
|OK
|High quality 3D denoiser
|MISSING
|
|Same case with Qtext, don’t know which use does it have with Title Clips but wouldn’t remove it either
|
|
|-
|-
|Enhancement
|Timer
|Sharpen
|OK
|Unsharp masking (port from Mplayer)
|MISSING
|
|Could be useful in some situations, wouldn’t remove it
|
|
|-
|-
|Enhancement
|Transpose
|frei0r.spillsupress
|BROKEN
|No file effect found
|MISSING
|
|
|
|
|}
== GPU effects ==
{| class="wikitable"
!Category
!Effect name
!Description
!K.F.
!Notes
!Action decided
|-
|-
|Unsharp
|BROKEN (?)
|BROKEN (?)
|I see no effect
|-
|-
|GPU effects
|Uspp
|Blur (GPU)
|?
|
|?
|
|I see no effect or I don’t know how to use it
|
|
|-
|-
|GPU effects
|Vaguedenoiser
|movit.sharpen
|BROKEN (?)
|No file effect found
|BROKEN (?)
|
|Don’t really know if it’s broken or not
|
|
|-
|-
|GPU effects
|Vertigo
|Diffusion (GPU)
|BROKEN
|
|MISSING
|
|Black screen
|
|
|-
|-
|GPU effects
|Vid.Stab Deshake
|Glow (GPU)
|BROKEN
|
|MISSING
|
|Problem adding effect to clip
|
|
|-
|-
|GPU effects
|Vid.Stab Detect and Transform
|Lift/gamma/gain (GPU)
|OK (?)
|
|MISSING
|
|It could work but did not test extensively, and there are other ways to use stabilization in kdenlive
|
|
|-
|-
|GPU effects
|Visualize Motion Vectors
|Mirror (GPU)
|MISSING
|
|?
|
|
|
|
|-
|-
|GPU effects
|W3fdif
|Opacity (GPU)
|BROKEN
|
|MISSING
|
|
|
|
|-
|-
|GPU effects
|Waveform
|Pan and Zoom (GPU)
|BROKEN
|
|OK
|
|Should be in “Analysis and data”
|
|
|-
|-
|GPU effects
|Weave
|Saturation (GPU)
|MISSING
|
|OK
|
|Could use some parameters
|
|
|-
|-
|GPU effects
|Xbr
|Unsharp mask (GPU)
|?
|
|MISSING
|
|
|
|
|-
|-
|GPU effects
|Zoompan
|Vignette (GPU)
|BROKEN (?)
|
|MISSING
|
|No effect/Don’t know what it does
|
|
|-
|-
|GPU effects
|White Balance (GPU)
|
|
|
|}
|}

Latest revision as of 22:09, 3 November 2019

Goal of the working group

There is currently a great deal of effects, of different quality and relevance. The goal is to clean up the effect list, to get better visibility and usability, and also to evolve the effect management.

The list of Effect related issues on Gitlab

A lot of the discussion is currently happening on Issue #350.

JBM wrote a document for the effects mini sprint of the 2019/11/1 : https://share.kde.org/s/5GMats9HNgeoL3e

Effect management

Effect categories

Current paradigm

There is currently 5 top categories for effects :

  • Main effects
  • Video effects
  • Audio effects
  • Custom effects
  • Favorite effects

These categories don't share the same status, though.

  • The first three are functional categories, divided into subcategories :
  • Custom effects are existing effects with a custom preset



New paradigm

How favorites work

Reducing the number of effects

One main idea would be to create a "Legacy" category and place in it non-working, or redundant effects


Current implementation

The effects are categorized in ./data/kdenliveeffectscategory.rc

The structure of XML files for effect description is detailed in ./data/effects/README


Suggested implementation

Searching the effects

Currently the search feature is accessible in the same visual way as the different categories.

The idea would be to have it accross the whole box, as described in this comment.

This has been implemented.


Custom effects versus Presets

Table of effects

The full list of effects available from your mlt installation can be retrieved by:

melt -query filters

Kdenlive will blacklist some of these effects, as listed in ./data/blacklisted_effects.txt


The review of the different effects in a share spreadsheet.



Alpha/Transform

Effect name 18.12.1d 19.04 refactoring (046d5002) 19.12 status Comments
Alpha gradient OK OK
Alpha operations OK OK Fixed in 19.08 Controls are missing the radio buttons that were in 18.12, but I don’t know if it affects in a negative way
Alpha Shapes OK OK Cannot see problem Min misbehaving
Chroma Key OK OK Fixed in 19.12 weird standard configuration
Chroma-key OK OK OK? I guess
Key Spill Mop Up OK OK
Rectangular Alpha mask OK OK OK
Rotoscoping OK OK OK

Analysis and data

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Audio Spectrum filter ? ? I see no effect or I don’t know how to use it
Audio Wave ? ? I see no effect or I don’t know how to use it
Oscilloscope OK OK
RGB Parade OK OK
Timeout indicator OK OK Could be enhanced by adding the ability to use sprites or numbers
Vectorscope OK OK
Video values OK OK Really useful effect but could be enhanced by adding the ability to interact with it in the monitor

Artistic

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
3-level Threshold OK OK
Binarize OK OK
Binarize dynamically OK OK
BurningTV MISSING OK Is this new?
Cartoon SEMI-BROKEN BROKEN Changing difference space breaks it in 18.12
Charcoal OK OK
Dither OK OK
Dust OK OK
Emboss OK OK I can see very small differences on refactoring but that could be me using proxy clips>Defaults fixed in 19.12.
Grain OK OK
Oldfilm OK OK
Posterize OK OK
Rgbnoise OK OK
Scratchlines OK OK
Sigmoidaltransfer OK OK
Sobel OK OK
Thresold OK OK
Vignette OK OK
Vignette Effect OK OK

Blur and hide

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Auto Mask OK SEMI-BROKEN This effect needs some improvement. Seems to misbehave on refactoring (selects the incorrect region)
Blur OK SEMI-BROKEN Works in refactoring but it’s missing the blur types > Fixed in 19.08
Box Blur OK OK
Edge glow OK OK Keyframes are a very good addition
Glow OK OK
Medians OK (?) OK (?) Guess it works. I really don’t know how to use it and have no use for it now
Obscure OK SEMI-BROKEN The pixels on refactoring are too wide > Fixed in 19.12
Softglow OK OK
Square Blur OK OK

Colour

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
B MISSING OK
Chroma Hold OK OK
Colorize OK OK
Contrast OK OK
Equaliz0r OK OK
G MISSING OK
Greyscale OK OK
Hue shift OK OK
Invert OK OK
LumaLiftGainGamma BROKEN BROKEN Can’t interact with the sliders. Don’t see the use of it with the rest of the colour correction effects > Fixed in 19.08
Luminance OK OK
Primaries OK OK
R MISSING OK
Saturation OK OK
Sepia OK OK
Technicolor OK OK
Tint OK OK

Colour correction

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
3 point balance OK OK
Apply LUT OK SEMI-BROKEN Drag and drop not working in refactoring > Fixed in 19.12
Bézier Curves OK BROKEN Does not show the correct overlay for each colour in refactoring > Cannot reproduce in 19.12
Brightness OK OK
Brightness (keyframable) OK OK
CMYK adjust (avfilter) OK BROKEN Not implemented in refactoring
Curves OK OK Does not show the correct overlay for each colour in refactoring> Cannot reproduce in 19.12
Gamma OK OK
Levels OK OK
Lift/gamma/gain OK OK A way to interact directly with the numbers under the wheels would be nice
RGB adjustment OK OK
SOP/Sat OK OK Sometimes gives a black screen in refactoring > Fixed in 19.12
White Balance OK OK
White Balance (LMS space) OK OK

Crop and transform

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Crop, Scale and Tilt OK OK
Edge Crop OK OK
LetterB0xed OK OK
nosync0r OK OK
Position and Zoom OK OK
Rotate (keyframable) OK OK
Rotate and Shear OK OK
Transform OK OK

Distort

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Corners OK SEMI-BROKEN Does not seem to let the user change the points in the monitor in refactoring >> Seems fixed in 19.08
Defish OK OK
Distort OK OK
Lens Correction OK OK
Mirror OK OK
Pixelize OK BROKEN
Wave OK BROKEN

Enhancement

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Denoiser OK OK
Nikon D90 Stairstepping fix OK (?) OK (?) Guess it works, I don’t have Nikon D90 footage to test
Sharpen BROKEN OK Fixed in refactoring (Thanks!)
Spillsupress OK OK

Motion

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Freeze OK OK

Misc

Effect name 18.12.1d 19.04 refactoring (046d5002) Comments
Apply a filter mask ? ? Don’t know how to use
Atadenoise BROKEN MISSING
Avgblur BROKEN (?) MISSING Doesn’t look right to me
Baltan OK OK
BgSubtract0r BROKEN (?) BROKEN (?) Black screen
Bitplanedenoise BROKEN (?) BROKEN (?) Either broken or don’t know it’s use
Boxblur OK OK Deduplicated in refactoring
BurningTV MISSING OK Duplicated in Artistic (Artistcic is it’s place)
Bwdif BROKEN MISSING
Cairogradient OK OK “Start color” and “End color” strings missing in refactoring
Cairoimagegrid OK OK
Chromakey BROKEN MISSING Not needed
Ciescope BROKEN (?) OK Implemented in refactoring (?)
Color Distance OK OK
Color Effect OK OK Should be in “Colour”
Colorbalance MISSING OK Should be in “Colour”
Colorchannelmixer OK OK Should be in “Colour”
Colorhalftone OK OK Should be in “Colour”. More stable in refactoring
Colorkey BROKEN MISSING Not needed
Colorlevels OK OK Should be in “Colour”
Colormatrix BROKEN MISSING
Colorspace BROKEN MISSING
Convolution BROKEN MISSING
Cropdetect BROKEN MISSING
Dance OK (?) OK (?) Guess it works, did not test with compositing to make it work
Datascope BROKEN MISSING
Dctdnoiz BROKEN (?) MISSING I don’t know if it’s broken or if it is a weird effect
Deband BROKEN MISSING
Deflate BROKEN MISSING
Deflicker MISSING ? Don’t know what’s supposed to do
Delay grab OK OK Yeah cool, but what use does it have in a video editor?
delay0r OK (?) OK (?) I think it has an effect but I don’t know how to use it
Delogo ? ? Don’t know anything at all about this effect
Deshake ? MISSING Don’t know anything at all about this effect
Denoise_vaapi MISSING ? Don’t know if it has an effect
Dilation ? ? No idea
Drawbox OK (?) MISSING Draws a box around the video, simple enough. Why has it been removed?
Drawgraph ? ?
Drawgrid BROKEN MISSING
Dynamic Text OK OK
Edgedetect OK OK Artistic?
Elbg BROKEN MISSING
Entropy MISSING ? What it is supposed to do?
Eq ? MISSING
Erosion ? ?
Face blur MISSING CRASH
Face detect MISSING ? Don’t know what is supposed to do
Fftfilt ? ? Makes colours
Field order MISSING ?
Fillborders MISSING ?
Flippo OK OK Should be in “Crop and transform”
Fspp OK (?) MISSING Why has it been removed?
Gblur OK (?) MISSING Seems to work, but I’m not sure
Glitch0r OK OK Should be in “Artistic” or “Distort”
Gradfun OK BROKEN Should be fixed
Greyscale MISSING OK Duplicated?
Histeq OK OK Interesting effect. Could fit in “Artistic”
Histogram BROKEN OK Should be in “Analysis and data”
Hqdn3d BROKEN MISSING
Hqx ? MISSING
Hue ? MISSING
Hwmap MISSING ?
Hwupload MISSING ?
Hwupload_cuda ? MISSING
Idet ? MISSING
Inflate ? ?
K-Means Clustering OK OK Should be in “Artistic”
Kerndeint MISSING ?
Lenscorrection BROKEN MISSING Not neede and seems glitched
Light Graffiti ? ? Don’t know how to use
Light Show ? ?
Limiter MISSING ?
Loop ? MISSING
Lumakey OK OK
Lut ? MISSING
Lutrgb ? MISSING
Lutyuv ? MISSING
Mestimate ? MISSING
Motion tracker OK (?) MISSING Could be useful
NDVI filter OK OK
Nervous OK OK
Nlmeans BROKEN MISSING
Noise BROKEN OK
Normaliz0r OK OK Missing strings “BlackPt” and “WhitePt”
Normalize MISSING ?
Ocv MISSING ?
Oscilloscope MISSING BROKEN (?) Duplicated
Owdenoise ? MISSING
Pad ? MISSING
Perspective BROKEN MISSING
Pp ? MISSING
Pp7 ? MISSING
Premultiply or Unpremultiply ? ?
Prewitt OK (?) MISSING Could fit in “Artistic”
Precamp_vaapi MISSING ?
Pseudocolor MISSING OK
Qtext OK MISSING Don’t know which use does it have with Title Clips but wouldn’t remove it either
Random ? ?
Removegrain ? MISSING Maybe it works, don’t have appropiate footage to test
Rescale MISSING OK
Rgbsplit0r BROKEN (?) MISSING Black screen
Rotate BROKEN MISSING
Sab ? ? Don’t know what’s supposed to do
scanline0r OK OK I wonder if it could use some parameters
Setrange MISSING ? I see no effect, don’t know if it works
Setup a filter mask OK (?) MISSING Just leaves a square similar to shape alpha
Shape Alpha BROKEN BROKEN Non functional and duplicated
Sharpness_vaapi MISSING ? Vaapi effects have no effect for me, but could be my setup
Shuffleframes ? MISSING No effect/Don’t know what it does
Shuffleplanes ? ? No effect/Don’t know what it does
Signalstats BROKEN MISSING
Smartblur OK OK Should be in “Blur and hide”
Spot Remover ? MISSING
Spp ? ?
Swaprect OK (?) OK (?) Different behaviour in refactoring
Tblend ? MISSING
TehRoxx0r OK (?) MISSING
Text OK MISSING Same case with Qtext, don’t know which use does it have with Title Clips but wouldn’t remove it either
Timer OK MISSING Could be useful in some situations, wouldn’t remove it
Transpose BROKEN MISSING
Unsharp BROKEN (?) BROKEN (?) I see no effect
Uspp ? ? I see no effect or I don’t know how to use it
Vaguedenoiser BROKEN (?) BROKEN (?) Don’t really know if it’s broken or not
Vertigo BROKEN MISSING Black screen
Vid.Stab Deshake BROKEN MISSING Problem adding effect to clip
Vid.Stab Detect and Transform OK (?) MISSING It could work but did not test extensively, and there are other ways to use stabilization in kdenlive
Visualize Motion Vectors MISSING ?
W3fdif BROKEN MISSING
Waveform BROKEN OK Should be in “Analysis and data”
Weave MISSING OK Could use some parameters
Xbr ? MISSING
Zoompan BROKEN (?) MISSING No effect/Don’t know what it does