View source for DPID

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Resizers|Deep_color_tools}}
{{Filter3
|1={{Author/Asd-g}}
|2=v1.0.0
|3=[https://github.com/Asd-g/AviSynth-DPID/releases DPID-1.0.0.7z]
|4=Resize 
|5=[https://github.com/Asd-g/AviSynth-DPID/blob/main/LICENSE.txt BSD 3-Clause]
|6=}}

== Description ==
[http://www.gcc.tu-darmstadt.de/home/proj/dpid/ dpid] is an algorithm that preserves visually important details in downscaled images and is especially suited for large downscaling factors.

It acts like a convolutional filter where input pixels contribute more to the output image the more their color deviates from their local neighborhood, which preserves visually important details.

This is [https://github.com/WolframRhodium/VapourSynth-dpid a port of the VapourSynth plugin dpid.]

<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
** AviSynth+: all [[planar]] formats (8/10/12/14/16/32bit, Y/YUV/RGB with or without alpha) are supported.
<br>
== [[Script variables|Syntax and Parameters]] ==

===DPID===
[[avsresize]] is required in order to use this function (DPID).
<br>
<br>
:{{Template:FuncDef|DPID (clip input, int target_width, int target_height, float "lambdaY", float "lambdaU", float "lambdaV", float "src_leftY", float "src_leftU", float "src_leftV", float "src_topY", float "src_topU", float "src_topV", int "cloc")}}

<br>
::{{Par2| |clip| }}
:::<code>input</code>: a clip to process. It must be in planar format.
<br>
::{{Par2| |int| }}
:::<code>target_width</code>: the width of the output.
<br>
::{{Par2| |int| }}
:::<code>target_height</code>: the height of the output.
<br>
::{{Par2|lambdaY|float|1.0}}
::{{Par2|lambdaU|float|lambdaY}}
::{{Par2|lambdaV|float|lambdaU}}
:::The power factor of range kernel.
:::It can be used to tune the amplification of the weights of pixels that represent detail—from a box filter over an emphasis of distinct pixels towards a selection of only the most distinct pixels.
:::Must be greater than 0.1.
:::Default: lambdaY = 1.0; lambdaU = lambdaV = lambdaY.
<br>
::{{Par2|srcY_left|float|0.0}}
::{{Par2|srcU_left|float|0.0}}
::{{Par2|srcV_left|float|0.0}}
::: Cropping of the left edge.
<br>
::{{Par2|srcY_top|float|0.0}}
::{{Par2|srcU_top|float|0.0}}
::{{Par2|srcV_top|float|0.0}}
:::Cropping of the top edge.
<br>
::{{Par2|cloc|int|-1}}
:::Chroma location.
:::*-1: If frame properties are supported and frame property "_ChromaLocation" exists - "_ChromaLocation" value is used.
::::If frame properties aren't supported or there is no frame property "_ChromaLocation" - 0.
:::*0: Left.
:::*1: Center.
:::*2: Top left.
:::*3: Top.
:::*4: Bottom left.
:::*5: Bottom.
:::Default: -1.
<br>

===DPIDraw===
DPIDraw uses a user supplied downscaled clip.
<br>
<br>
:{{Template:FuncDef| DPIDraw (clip input, clip input2, float "lambdaY", float "lambdaU", float "lambdaV", float "src_leftY", float "src_leftU", float "src_leftV", float "src_topY", float "src_topU", float "src_topV", int "cloc", int "y", int "u", int "v")}}

<br>
::{{Par2| |clip| }}
:::<code>input</code>: a clip to process. It must be in planar format.
<br>
::{{Par2| |clip| }}
:::<code>input2</code>: user-defined downsampled clip.
:::Must be of the same format and number of frames as <code>input</code>.
<br>
::{{Par2|lambdaY|float|1.0}}
::{{Par2|lambdaU|float|lambdaY}}
::{{Par2|lambdaV|float|lambdaU}}
:::The power factor of range kernel.
:::It can be used to tune the amplification of the weights of pixels that represent detail—from a box filter over an emphasis of distinct pixels towards a selection of only the most distinct pixels.
:::Must be greater than 0.1.
:::Default: lambdaY = 1.0; lambdaU = lambdaV = lambdaY.
<br>
::{{Par2|srcY_left|float|0.0}}
::{{Par2|srcU_left|float|0.0}}
::{{Par2|srcV_left|float|0.0}}
::: Cropping of the left edge.
<br>
::{{Par2|srcY_top|float|0.0}}
::{{Par2|srcU_top|float|0.0}}
::{{Par2|srcV_top|float|0.0}}
:::Cropping of the top edge.
<br>
::{{Par2|cloc|int|-1}}
:::Chroma location.
:::*-1: If frame properties are supported and frame property "_ChromaLocation" exists - "_ChromaLocation" value is used.
::::If frame properties aren't supported or there is no frame property "_ChromaLocation" - 0.
:::*0: Left.
:::*1: Center.
:::*2: Top left.
:::*3: Top.
:::*4: Bottom left.
:::*5: Bottom.
:::Default: -1.
<br>
::{{Par2|y|int|3}}
::{{Par2|u|int|3}}
::{{Par2|v|int|3}}
:::Planes to process.
:::*1: Return garbage.
:::*2: Copy plane from <code>input2</code>.
:::*3: Process plane. Always process planes when clip is RGB.
:::Default: y = u = v = 3.
<br>
== Examples == 

 src =  [[AviSource]]("Blah.avi") # assume the clip is 1920x1080
 DPID(src, 1280, 720)

is equivalent to:

 src =  [[AviSource]]("Blah.avi")
 down = z_BilinearResize(src, target_width=1280, target_height=720)
 DPIDRaw(src, down)
<br>
== Changelog ==
 Version      Date            Changes<br>
 v1.0.0       2021/07/23      - Initial release
                              - AviSynth+: self-registers as [[MT_MULTI_INSTANCE]]
<br>
== External Links ==
*[https://github.com/Asd-g/AviSynth-DPID GitHub] - Source code repository.
*[https://github.com/WolframRhodium/VapourSynth-dpid GitHub] - Source code repository (VapourSynth version).
*[https://forum.doom9.org/showthread.php?t=172871 Doom9 Forum] - Perceptually Based Downscaling of Images.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Resizers|External Filters]] &larr;'''