TCannyMod

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (Syntax and Parameters)
m (minor formatting)
Line 1: Line 1:
[[Category:Plugins]]
+
{{FilterCat4|External_filters|Plugins|Other_filters|Edge_detection}}
{{FilterCat|External_filters|Other_filters|Edge_Detection}}
+
 
 
{{Filter3
 
{{Filter3
 
| {{Author/Chikuzen}}
 
| {{Author/Chikuzen}}
Line 10: Line 10:
 
<br>
 
<br>
 
== Description ==
 
== Description ==
:<tt>TCannyMod</tt> is a Canny edge detection filter. It's based on [[tcanny]] written by Kevin Stone (a.k.a. tritical) but rewritten from scratch exclusively for AviSynth 2.6.
+
<tt>TCannyMod</tt> is a Canny edge detection filter. It's based on [[tcanny]] written by Kevin Stone (a.k.a. tritical) but rewritten from scratch exclusively for AviSynth 2.6.<br>
 
<br>
 
<br>
  
 
== Requirements ==
 
== Requirements ==
:- [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6.0 Alpha5] or greater
+
* [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6.0 Alpha5] or greater
:- Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
+
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
 
<br>
 
<br>
:- [[SSE2]] capable CPU
+
* [[SSE2]] capable CPU
:- [http://www.microsoft.com/en-us/download/details.aspx?id=8328 Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)]
+
* [http://www.microsoft.com/en-us/download/details.aspx?id=8328 Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)]
 
<br>
 
<br>
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
Line 125: Line 125:
 
*[http://github.com/chikuzen/TCannyMod/tree/master/avisynth GitHub] - Source code repository.
 
*[http://github.com/chikuzen/TCannyMod/tree/master/avisynth GitHub] - Source code repository.
 
*[http://forum.doom9.org/showthread.php?t=168449 Doom9 Forum] - TCannyMod discussion.
 
*[http://forum.doom9.org/showthread.php?t=168449 Doom9 Forum] - TCannyMod discussion.
<br>
 
 
<br>
 
<br>
 
<br>
 
<br>
 
-----------------------------------------------
 
-----------------------------------------------
 
'''Back to [[External_filters#Edge_Detection|External Filters]] &larr;'''
 
'''Back to [[External_filters#Edge_Detection|External Filters]] &larr;'''

Revision as of 08:48, 21 September 2014


Abstract
Author Chikuzen
Version v0.1.1
Download tcannymod-0.1.1.zip
Category Edge Detection
License GPLv2
Discussion Doom9 Thread


Contents

Description

TCannyMod is a Canny edge detection filter. It's based on tcanny written by Kevin Stone (a.k.a. tritical) but rewritten from scratch exclusively for AviSynth 2.6.

Requirements



Syntax and Parameters


TCannyMod

Builds an edge map using Canny edge detection.

TCannyMod (clip, int "mode", float "sigma", float "t_h", float "t_l", bool "sobel", int "chroma")


clip   =
Input clip; only planar formats are supported.


int  mode = 0
Sets the output format:
  • 0 : thresholded edge map (255 for edge, 0 for non-edge)
  • 1 : gradient magnitude map.
  • 2 : edge pixel only gradient direction map (non-edge pixels set to 0)
  • 3 : gradient direction map
Gradient direction are normalized to 1, 3, 7 and 15.
1 = horizontal
3 = 45' up
7 = vertical
15 = 45' down
  • 4 : Gaussian blurred frame.


float  sigma = 1.5
Standard deviation of Gaussian blur. 0 means no blurring before edge detection.
(0 <= sigma <= 2.83, default = 1.5)


float  t_h = 8.0
High gradient magnitude threshold for hysteresis.


float  t_l = 1.0
Low gradient magnitude threshold for hysteresis.


bool  sobel = false
If set to true, edge detection will use a Sobel operator instead of [1, 0, -1].


int  chroma = 0
Chroma processing:
  • 0 : do not process
  • 1 : process
  • 2 : copy from input clip.
  • 3 : fill with 0x80(128), output is grayscale.




GBlur

Gaussian blur filter. Just an alias for TCannyMod(mode=4).

GBlur (clip, float "sigma", int "chroma")


clip   =
Input clip; only planar formats are supported.


float  sigma = 0.5
Standard deviation of Gaussian blur. 0 means no blurring before edge detection.
(0 <= sigma <= 2.83, default = 0.5)


int  chroma = 1
Chroma processing:
  • 0 : do not process
  • 1 : process
  • 2 : copy from input clip.
  • 3 : fill with 0x80(128), output is grayscale.


Examples

TCannyMod with default settings:

AviSource("blah.avi")
TCannyMod (mode=0, sigma=1.5, t_h=8.0, t_l=1.0, sobel=false, chroma=0)


GBlur with default settings:

AviSource("blah.avi")
GBlur (sigma=0.5, chroma=1)


Changelog

Version      Date            Changes
v0.1.1 08/21/2013 - fix crash when sigma is too large - add new argument 'sobel' - add new function 'GBlur'
v0.1.0 08/017/2013 - Initial release


Archived Downloads

Version Download Source code Mirror
v0.1.1 tcannymod-0.1.1.zip TCannyMod-master.zip


External Links




Back to External Filters

Personal tools