View source for EEDI2CUDA

{{FilterCat6|External_filters|Plugins|Plugins_x64|Restoration_filters|Deinterlacers|Deep_color_tools}}
{{Filter3
|1=[https://github.com/misakikasumi misakikasumi], [https://github.com/WolframRhodium WolframRhodium]
|2=M2u1test1
|3=[https://files.videohelp.com/u/223002/EEDI2CUDA.7z EEDI2CUDA.7z] /// [https://web.archive.org/web/20230130090527if_/https://files.videohelp.com/u/223002/EEDI2CUDA.7z Archived]
|4=Denoisers 
|5=[https://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=
}}

== Description ==
[[EEDI2]] filter using CUDA. [[EEDI2CUDA]] includes 3 functions:
*<code>EEDI2_CUDA</code>: deinterlace
*<code>EEDI2_CUDA_AA2</code>: anti-aliasing  
*<code>EEDI2_CUDA_Enlarge2</code>: upscale by 2
<br>
== Requirements ==
* [x86] / [x64]: [[AviSynth+]]
* Supported color formats: all [[planar]] 8-16bit Y/YUV/RGB

*CUDA-enabled GPU(s) of [https://developer.nvidia.com/cuda-gpus compute capability] 5.0 or higher (Maxwell+).
*GPU driver 450 or newer.
<br>

== [[Script variables|Syntax and Parameters]] ==
{{FuncDef|EEDI2_CUDA (clip, int field, int "mthresh", int "lthresh", int "vthresh", int "estr", int "dstr", int "maxd", int "field", int "map", int "nt", int "pp", int "num_streams", int "device_id")}}

{{FuncDef|EEDI2_CUDA_AA2 (clip, int "mthresh", int "lthresh", int "vthresh", int "estr", int "dstr", int "maxd", int "field", int "map", int "nt", int "pp", int "num_streams", int "device_id")}}

{{FuncDef|EEDI2_CUDA_Enlarge2 (clip, int "mthresh", int "lthresh", int "vthresh", int "estr", int "dstr", int "maxd", int "field", int "map", int "nt", int "pp", int "num_streams", int "device_id")}}
<br>
<br>
::{{Par2| |clip| }}
:::Input clip to process. It must be in 8..16-bit planar format with or without alpha.
<br>
::{{Par2| |int| }}
:::<code>field</code>: Controls which field in the resized image the original image will be copied to.
:::*0 = bottom field
:::*1 = top field
:::*2 = alternates each frame, starts with bottom
:::*3 = alternates each frame, starts with top
<br>
::{{Par2|mthresh|int|10}}
::{{Par2|lthresh|int|20}}
::{{Par2|vthresh|int|20}}
:::These all control edge detection used for building the initial edge map.  
:::*{{FuncDef3|mthresh}} is the edge magnitude threshold... its range is from 0 to 255, lower values will detect weaker edges.
:::*{{FuncDef3|lthresh}} is the laplacian threshold... its range is 0 to 510, lower values will detect weaker lines.
:::*{{FuncDef3|vthresh}} is the variance threshold... its range is 0 to a large number, lower values will detect weaker edges. 
:::Use the {{FuncDef3|"map"}} option to tweak these settings as needed.
<br>
::{{Par2|estr|int|2}}
::{{Par2|dstr|int|4}}
:::These are used for dilation and erosion of the edge map. 
:::*{{FuncDef3|estr}} sets the required number of edge pixels (<=) in a 3x3 area, in which the center pixel has been detected as an edge pixel, for the center pixel to be removed from the edge map.
:::*{{FuncDef3|dstr}} sets the required number of edge pixels (>=) in a 3x3 area, in which the center pixel has not been detected as an edge pixel, for the center pixel to be added to the edge map.
:::Use the {{FuncDef3|"map"}} option to tweak these settings as needed.
<br>
::{{Par2|maxd|int|24}}
:::Sets the maximum pixel search distance for determining the interpolation direction.
:::Larger values will be able to connect edges and lines of smaller slope but can lead to artifacts. Sometimes using a smaller {{FuncDef3|maxd}} will give better results than a larger setting. The maximum possible value for {{FuncDef3|maxd}} is 29.
<br>
::{{Par2|map|int|0}}
:::Allows one of three possible maps to be shown.  Possible settings:
:::*0 - no map
:::*1 - edge map (edge pixels will be set to 255 and non-edge pixels will be set to 0.)
:::*2 - original scale direction map
:::*3 - 2x scale direction map
<br>
::{{Par2|nt|int|50}}
:::Defines a noise threshold between pixels in the sliding vectors, this is used to set initial starting values. 
:::Lower values should reduce artifacts but sacrifice edge reconstruction... while higher values should improve edge reconstruction but lead to more artifacts. The possible range of values is 0 to 256.
<br>
::{{Par2|pp|int|1}}
:::Only pp=1 is implemented.
:::*1 - check for spatial consistency of final interpolation directions
<br>
::{{Par2|num_streams|int|1}}
:::Specify the number of CUDA streams. A larger value increases the concurrency and also increases the GPU memory usage. The default value <code>num_streams=1</code> is already fast enough.
<br>
::{{Par2|device_id|int|-1}}
:::Set the GPU device ID to use. You must specify this argument for each call if you have multiple GPUs.
<br>

<br>
== Examples ==
[[TODO]]
<br>
<br>
== Changelog ==
 Version      Date            Changes<br>
 M2u1test1    2021/08/26      - Unified Multi-bindings.
 M2p2         2021/08/11      - Fix #2 - add copy init for BridgePass.
 M2p1         2021/08/08      - This release contains workaround of #2.
                                Force num_streams=1, there is something wrong with multiple streams. 
<br>
== External Links ==
*[https://github.com/ruihe774/VapourSynth-EEDI2CUDA GitHub] - Source code repository.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] &larr;'''