VsTCanny - Revision history

Reel.Deal: /* Syntax and Parameters */ typo

2022-11-05T21:54:31Z

‎Syntax and Parameters: typo

Asd: Update the version

2022-03-27T22:21:51Z

Update the version

Asd: Update the version

2022-03-10T02:05:29Z

Update the version

Asd: VsTCanny 1.1.5

2022-01-25T18:26:52Z

VsTCanny 1.1.5

Asd: Update to the latest version

2022-01-11T21:58:48Z

Update to the latest version

Reel.Deal: vsTCanny

2020-09-20T19:36:49Z

vsTCanny

New page

{{FilterCat6|External_filters|Plugins|Plugins_x64|Other_filters|Edge_detection|Deep_color_tools}}
{{Filter3
|1={{Author/Asd-g}}
|2=v1.0.0
|3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/tag/1.0.0 vsTCanny-1.0.0.7z]
|4=Edge Detection
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=
}}

== Description ==
Builds an edge map using canny edge detection.

[[vsTCanny]] is a port of the VapourSynth plugin TCanny.

== 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/32-bit, Y, YUV(A), and RGB(A) with or without alpha) are supported.
 
== [[Script variables|Syntax and Parameters]] ==

:{{Template:FuncDef|vsTCanny (clip, float "sigmaY", float "sigmaU", float "sigmaV", float sigma_vY", float "sigma_vU", float "sigma_vV", float "t_h", float "t_l", int "mode", int "op", float "gmmax", int "y", int "u", int "v", int "opt")}}
 
::{{Par2| |clip| }}
:::A clip to process. All [[planar]] formats are supported.
 
::{{Par2|sigmaY|float|1.5}}
::{{Par2|sigmaU|float|}}
::{{Par2|sigmaV|float|}}
:::Standard deviation of horizontal gaussian blur.
:::Must be greater than 0.0.
:::Default: sigmaY = 1.5; sigmaU = sigmaV = 0.75 for half resolution chroma and sigmaU = sigmaV = 1.5 for full resolution chroma.
 
::{{Par2|sigma_vY|float|1.5}}
::{{Par2|sigma_vU|float|}}
::{{Par2|sigma_vV|float|}}
:::Standard deviation of vertical gaussian blur.
:::Must be greater than 0.0.
:::Default: sigma_vY = 1.5; sigma_vU = sigma_vV = 0.75 for half resolution chroma and sigma_vU = sigma_vV = 1.5 for full resolution chroma.
 
::{{Par2|t_h|float|8.0}}
:::High gradient magnitude threshold for hysteresis.
 
::{{Par2|t_l|float|1.0}}
:::Low gradient magnitude threshold for hysteresis.
 
::{{Par2|mode|int|0}}
:::Sets the output format:

:::*-1 : Gaussian blur only.
:::*0 : Thresholded edge map (2^bitdepth-1 for edge, 0 for non-edge).
:::* 1: Gradient magnitude map.
 
::{{Par2|op|int|1}}
:::Sets the operator for edge detection:

:::*0: The operator used in tritical's original filter.
:::*1: The operator proposed by P. Zhou et al.
:::*2: The Sobel operator.
:::*3: The Scharr operator.
 
::{{Par2|gmmax|float|50.0}}
:::Used for scaling gradient magnitude into [0, 2^bitdepth-1] for {{Template:FuncDef3|mode}}=1.
:::Musbe greater than or equal to 1.0.
 
::{{Par2|y|int|3}}
::{{Par2|u|int|3}}
::{{Par2|v|int|3}}
:::Planes to process.
:::*1 : Return garbage.
:::*2 : Copy plane.
:::*3 : Process plane. Always process planes when the clip is RGB.
 
::{{Par2|opt|int|-1}}
:::Sets which cpu optimizations to use.
:::*-1 : Auto-detect.
:::*0 : Use C++ code.
:::*1 : Use SSE2 code.
:::*2 : Use AVX2 code.
 
== Examples ==
{{Template:FuncDef3|vsTCanny}} with default settings (for YUV420):
[[AviSource]]("blah.avi")
TCannyMod(sigmaY=1.50, sigmaU=0.75, sigmaV=0.75, sigma_vY=1.50, sigma_vU=0.75, sigma_vV=0.75, \
t_h=8.0, t_l=1.0, mode=0, op=1, gmmax=50.0, Y=3, U=3, V=3, opt=-1)

{{Template:FuncDef3|vsTCanny}} with default settings (for YUV444):
[[AviSource]]("blah.avi")
TCannyMod(sigmaY=1.50, sigmaU=1.50, sigmaV=1.50, sigma_vY=1.50, sigma_vU=1.50, sigma_vV=1.50, \
t_h=8.0, t_l=1.0, mode=0, op=1, gmmax=50.0, Y=3, U=3, V=3, opt=-1)
 

== Changelog ==
Version Date Changes 
v1.0.0 2020/09/15 - Initial release; port of the VapourSynth plugin

 

== External Links ==
[https://github.com/Asd-g/AviSynth-vsTCanny GitHub] - Source code repository.
 
 
-----------------------------------------------
'''Back to [[External_filters#Edge_Detection|External Filters]] ←'''

@@ Line 74: / Line 74: @@
 :::*4 : The Kroon operator.
 :::*5 : The Kirsch operator.
-:::*6 : he FDoG operator.
+:::*6 : The FDoG operator.
 <br>
 ::{{Par2|scale|float|1.0}}
@@ Line 97: / Line 97: @@
 :::*3 : Use AVX512 code.
 <br>
 == Examples ==
 {{Template:FuncDef3|vsTCanny}} with default settings (for YUV420):

@@ Line 2: / Line 2: @@
 {{Filter3
 |1={{Author/Asd-g}}
-|2=v1.1.7
+|2=v1.1.8
 |3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/ vsTCanny]
 |4=Edge Detection
@@ Line 111: / Line 111: @@
 == Changelog ==
   Version      Date            Changes<br>
   v1.1.7       2022/03/10      - Changed the behavior of default sigma_vU.<br>
   v1.1.6       2022/03/07      - Fixed default sigma_U/V/vU/vV for RGB formats.

@@ Line 2: / Line 2: @@
 {{Filter3
 |1={{Author/Asd-g}}
-|2=v1.1.5
+|2=v1.1.7
 |3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/ vsTCanny]
 |4=Edge Detection
@@ Line 34: / Line 34: @@
 :::Must be positive value.
 :::Setting to 0 disables gaussian blur.
-:::Default: sigmaY = 1.5; sigmaU = sigmaV = sigmaY/2 for half resolution chroma and sigmaU = sigmaV = sigmaY for full resolution chroma.
+:::Default:
 <br>
 ::{{Par2|sigma_vY|float|sigmaY}}
@@ Line 42: / Line 45: @@
 :::Must be positive value.
 :::Setting to 0 disables gaussian blur.
-:::Default: sigma_vY = sigmaY; sigma_vU = sigma_vV = sigma_vY/2 for half resolution chroma and sigma_vU = sigma_vV = sigma_vY for full resolution chroma.
+:::Default:
 <br>
 ::{{Par2|t_h|float|8.0}}
@@ Line 104: / Line 111: @@
 == Changelog ==
   Version      Date            Changes<br>
   v1.1.5       2022/01/25      - Fixed the processing of planes for RGB formats.
                                - Properly clamped float mask to 0-1 range in mode=1. (VS plugin r14)<br>

@@ Line 2: / Line 2: @@
 {{Filter3
 |1={{Author/Asd-g}}
-|2=v1.1.4
+|2=v1.1.5
 |3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/ vsTCanny]
 |4=Edge Detection
@@ Line 104: / Line 104: @@
 == Changelog ==
   Version      Date            Changes<br>
   v1.1.4       2022/01/03      - Fixed the behavior when y/u/v=1<br>
   v1.1.3       2021/12/28      - Fixed the uninitialized variables when the clip has only one plane<br>
@@ Line 109: / Line 111: @@
   v1.1.1       2021/12/26      - Fixed the processing of clips with one plane<br>
   v1.1.0       2021/12/17      - Changed chroma planes range from -0.5..0.5 to 0.0..1.0 (float clips). (VS plugin r13)
-                                                  - Added AVX512 code. (VS plugin r13)
+                              - Added AVX512 code. (VS plugin r13)
-                                                  - Added Kroon, Kirsch and FDoG operatos. (VS plugin r13)
+                              - Added Kroon, Kirsch and FDoG operatos. (VS plugin r13)
-                                                  - Renamed gmmax parameter to scale and changed its default to 1.0. (VS plugin r13)
+                              - Renamed gmmax parameter to scale and changed its default to 1.0. (VS plugin r13)
-                                                  - Changed default sigma_vY from 1.5 to sigmaY<br>
+                              - Changed default sigma_vY from 1.5 to sigmaY<br>
   v1.0.1       2021/08/25      - Fixed sigma for RGB clips<br>
   v1.0.0       2020/09/15      - Initial release; port of the VapourSynth plugin<br>

@@ Line 2: / Line 2: @@
 {{Filter3
 |1={{Author/Asd-g}}
-|2=v1.0.0
+|2=v1.1.4
-|3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/tag/1.0.0 vsTCanny-1.0.0.7z]
+|3=[https://github.com/Asd-g/AviSynth-vsTCanny/releases/ vsTCanny]
 |4=Edge Detection
 |5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 |6=
@@ Line 23: / Line 23: @@
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|vsTCanny (clip, float "sigmaY", float "sigmaU", float "sigmaV", float sigma_vY", float "sigma_vU", float "sigma_vV", float "t_h", float "t_l", int "mode", int "op", float "gmmax", int "y", int "u", int "v", int "opt")}}
+:{{Template:FuncDef|vsTCanny (clip, float "sigmaY", float "sigmaU", float "sigmaV", float sigma_vY", float "sigma_vU", float "sigma_vV", float "t_h", float "t_l", int "mode", int "op", float "scale", int "y", int "u", int "v", int "opt")}}
 <br>
 ::{{Par2| |clip| }}
@@ Line 32: / Line 32: @@
 ::{{Par2|sigmaV|float|}}
 :::Standard deviation of horizontal gaussian blur.
-:::Must be greater than 0.0.
+:::Must be positive value.
-:::Default: sigmaY = 1.5; sigmaU = sigmaV = 0.75 for half resolution chroma and sigmaU = sigmaV = 1.5 for full resolution chroma.
+:::Setting to 0 disables gaussian blur.
 <br>
-::{{Par2|sigma_vY|float|1.5}}
+::{{Par2|sigma_vY|float|sigmaY}}
 ::{{Par2|sigma_vU|float|}}
 ::{{Par2|sigma_vV|float|}}
 :::Standard deviation of vertical gaussian blur.
-:::Must be greater than 0.0.
+:::Must be positive value.
-:::Default: sigma_vY = 1.5; sigma_vU = sigma_vV = 0.75 for half resolution chroma and sigma_vU = sigma_vV = 1.5 for full resolution chroma.
+:::Setting to 0 disables gaussian blur.
 <br>
 ::{{Par2|t_h|float|8.0}}
@@ Line 47: / Line 49: @@
 ::{{Par2|t_l|float|1.0}}
 :::Low gradient magnitude threshold for hysteresis.
 <br>
 ::{{Par2|mode|int|0}}
@@ Line 53: / Line 56: @@
 :::*-1 : Gaussian blur only.
 :::*0 : Thresholded edge map (2^bitdepth-1 for edge, 0 for non-edge).
-:::* 1: Gradient magnitude map.
+:::*1 : Gradient magnitude map.
 <br>
 ::{{Par2|op|int|1}}
 :::Sets the operator for edge detection:
-:::*0: The operator used in tritical's original filter.
+:::*0 : The operator used in tritical's original filter.
-:::*1: The operator proposed by P. Zhou et al.
+:::*1 : The operator proposed by P. Zhou et al.
-:::*2: The Sobel operator.
+:::*2 : The Sobel operator.
-:::*3: The Scharr operator.
+:::*3 : The Scharr operator.
 <br>
-::{{Par2|gmmax|float|50.0}}
+::{{Par2|scale|float|1.0}}
-:::Used for scaling gradient magnitude into [0, 2^bitdepth-1] for {{Template:FuncDef3|mode}}=1.
+:::Multiplies the gradient.
-:::Musbe greater than or equal to 1.0.
+:::This can be used to increase or decrease the intensity of edges in the output.
 <br>
 ::{{Par2|y|int|3}}
@@ Line 81: / Line 88: @@
 :::*1 : Use SSE2 code.
 :::*2 : Use AVX2 code.
 <br>
 == Examples ==
 {{Template:FuncDef3|vsTCanny}} with default settings (for YUV420):
   [[AviSource]]("blah.avi")
-  TCannyMod(sigmaY=1.50, sigmaU=0.75, sigmaV=0.75, sigma_vY=1.50, sigma_vU=0.75, sigma_vV=0.75, \
+  vsTCanny(sigmaY=1.50, sigmaU=0.75, sigmaV=0.75, sigma_vY=1.50, sigma_vU=0.75, sigma_vV=0.75, \
-            t_h=8.0, t_l=1.0, mode=0, op=1, gmmax=50.0, Y=3, U=3, V=3, opt=-1)
+            t_h=8.0, t_l=1.0, mode=0, op=1, scale=1.0, Y=3, U=3, V=3, opt=-1)
 {{Template:FuncDef3|vsTCanny}} with default settings (for YUV444):
   [[AviSource]]("blah.avi")
-  TCannyMod(sigmaY=1.50, sigmaU=1.50, sigmaV=1.50, sigma_vY=1.50, sigma_vU=1.50, sigma_vV=1.50, \
+  vsTCanny(sigmaY=1.50, sigmaU=1.50, sigmaV=1.50, sigma_vY=1.50, sigma_vU=1.50, sigma_vV=1.50, \
-            t_h=8.0, t_l=1.0, mode=0, op=1, gmmax=50.0, Y=3, U=3, V=3, opt=-1)
+            t_h=8.0, t_l=1.0, mode=0, op=1, scale=1.0, Y=3, U=3, V=3, opt=-1)
 <br>
 == Changelog ==
   Version      Date            Changes<br>
-  v1.0.0       2020/09/15      - Initial release; port of the VapourSynth plugin
+ v1.1.4       2022/01/03      - Fixed the behavior when y/u/v=1<br>
+ v1.1.3       2021/12/28      - Fixed the uninitialized variables when the clip has only one plane<br>
-<br>
+ v1.1.2       2021/12/28      - Fixed a bug when sigma=0 and the plane is not processed<br>
 == External Links ==