nnedi3 is an intra-field only deinterlacer. It takes a frame, throws away one field, and then interpolates the missing pixels using only information from the remaining field. It is also good for enlarging images by powers of two.
This plugin no longer provides the nnedi3_rpow2 filter. A replacement can be found here: http://forum.doom9.org/showthread.php?t=172652
This is a port of tritical's nnedi3 filter.
The file nnedi3_weights.bin
is required. In Windows, it must be
located in the same folder as libnnedi3.dll
. Everywhere else it
can be located either in the same folder as
libnnedi3.so
/libnnedi3.dylib
, or in $prefix/share/nnedi3/
.
The build system installs it at the latter location automatically.
nnedi3.nnedi3(clip clip, int field[, bint dh=False, int[] planes=[0, 1, 2], int nsize=6, int nns=1, int qual=1, int etype=0, int pscrn=2, bint opt=True, bint int16_prescreener=True, bint int16_predictor=True, int exp=0, bint show_mask=False, bint combed_only=False])
- Parameters:
- clip
- Clip to process. It must have constant format and dimensions, and integer samples with 8..16 bits or float samples with 32 bits.
- field
Selects the mode of operation. Possible values:
- 0: Same rate, keep bottom field.
- 1: Same rate, keep top field.
- 2: Double rate, start with bottom field.
- 3: Double rate, start with top field.
If dh is True, the
_Field
frame property is used to determine each frame's field dominance. The field parameter is only a fallback for frames that don't have the_Field
property.If dh is False, the
_FieldBased
frame property is used to determine each frame's field dominance. The field parameter is only a fallback for frames that don't have the_FieldBased
property, or where said property indicates that the frame is progressive.- dh
Doubles the height, keeping both fields. If field is 0, the input is copied to the odd lines of the output (the bottom field). If field is 1, the input is copied to the even lines of the output (the top field).
If dh is True, field must be 0 or 1.
Default: False.
- planes
Planes to process. Planes that are not processed will contain uninitialised memory.
Default: all.
- nsize
Size of the local neighbourhood around each pixel used by the predictor neural network. Possible settings:
- 0: 8x6
- 1: 16x6
- 2: 32x6
- 3: 48x6
- 4: 8x4
- 5: 16x4
- 6: 32x4
For image enlargement it is recommended to use 0 or 4. A taller neighbourhood will result in sharper output.
For deinterlacing a wider neighbourhood will allow connecting lines of smaller slope. However, the setting to use depends on the amount of aliasing (lost information) in the source. If the source was heavily low-pass filtered before interlacing then aliasing will be low and a wide neighbourhood won't be needed, and vice-versa.
Default: 6.
- nns
Number of neurons in the predictor neural network. Possible values:
- 0: 16
- 1: 32
- 2: 64
- 3: 128
- 4: 256
Higher values are slower, but provide better quality. However, quality differences are usually small. The difference in speed will become larger if qual is increased.
Default: 1.
- qual
The number of different neural network predictions that are blended together to compute the final output value. Each neural network was trained on a different set of training data. Blending the results of these different networks improves generalisation to unseen data. Possible values are 1 and 2.
A value of 2 is recommended for image enlargement.
Default: 1.
- etype
The set of weights used in the predictor neural network. Possible values:
- 0: Weights trained to minimise absolute error.
- 1: Weights trained to minimise squared error.
Default: 0.
- pscrn
The prescreener used to decide which pixels should be processed by the predictor neural network, and which can be handled by simple cubic interpolation. Since most pixels can be handled by cubic interpolation, using the prescreener generally results in much faster processing. Possible values:
- 0: No prescreening. No pixels will be processed with cubic interpolation. This is really slow.
- 1: Old prescreener.
- 2: New prescreener level 0.
- 3: New prescreener level 1.
- 4: New prescreener level 2.
The new prescreener works faster than the old one, and it also causes more pixels to be processed with cubic interpolation. The higher levels cause a bit more pixels to be processed with the predictor neural network, therefore they are slower than the lowest level.
The new prescreener is not available with float input.
Default: 2 for integer input, 1 for float input.
- opt
If True, the best optimised functions supported by the CPU will be used. If False, only scalar functions will be used.
Default: True.
- int16_prescreener
If True, the prescreener will perform the dot product calculations using 16 bit integers. Otherwise, it will use single precision floats.
This parameter is ignored when the input has float samples.
Default: True.
- int16_predictor
If True, the predictor will perform the dot product calculations using 16 bit integers. Otherwise, it will use single precision floats.
This parameter is ignored when the input has more than 15 bits per sample.
Default: True.
- exp
The exp function approximation to use in the predictor. 0 is the fastest and least accurate. 2 is the slowest and most accurate.
Default: 0.
- show_mask
If True, the pixels that would be processed with the predictor neural network are instead set to white.
Default: False.
- combed_only
If True, only frames where the
_Combed
property is 1 will be processed. The rest will be returned unchanged.Default: False.
./autogen.sh ./configure make
On x86, yasm is currently not optional.
DLLs can be found in the "releases" section.
GPLv2.