AWarpSharp2/aWarpSharp2 - Revision history

Reel.Deal: small documentation update

2015-11-09T22:01:37Z

small documentation update

Reel.Deal: minor touchup

2015-03-25T03:20:47Z

minor touchup

Reel.Deal: /* Examples */ wording

2015-02-17T13:47:36Z

‎Examples: wording

Reel.Deal: /* Examples */ minor changes

2015-02-17T01:44:41Z

‎Examples: minor changes

Reel.Deal: /* Examples */ add examples

2014-10-26T15:41:00Z

‎Examples: add examples

Reel.Deal: minor formatting

2014-09-21T07:35:53Z

minor formatting

Reel.Deal: category

2014-08-23T16:03:43Z

Reel.Deal: correct aWarpSharp2 page

2014-08-23T16:01:41Z

correct aWarpSharp2 page

New page

'''Back to [[aWarpSharp2#Filters|aWarpSharp2]] ←'''
--------------------------------------------------------
 
 
== Description ==
The same as '''[[AWarpsharp2/aWarp|aWarp(]][[AWarpsharp2/aSobel|aSobel().]][[AWarpsharp2/aBlur|aBlur())]]''' but a bit faster.
 
 
==Syntax and Parameters ==
:{{Template:FuncDef|aWarpSharp2 (''clip'', ''int'' "thresh", ''int'' "blur", ''int'' "type", ''int'' "depth", ''int'' "chroma")}}
 
::{{Par2|thresh|int|128}}
:::Range: 0 to 255 
::::Saturation limit for edge detection. Reduce for less aggressive sharpening.
 
::{{Par2|blur|int|2}}
:::Range: 0 to 100 
::::Number of blur passes over edge mask. 
::::Less passes increase sharpening effect, but can produce major artifacts with high {{Template:FuncDef|depth}} and {{Template:FuncDef|thresh}} values. 
::::You can use values higher than 100, but probably won't see any difference. 
::::Chroma is processed with (blur+1)/2 passes. 
:::'''Note:''' Unless {{Template:FuncDef|blur}} is specifically set, it will default to 3 if {{Template:FuncDef|type}}=1.
 
::{{Par2|type|int|0}}
::::Type of blur:
:::::* 0 : radius 6 blur.
:::::* 1 : radius 2 blur, requires around 8x more passes than {{Template:FuncDef|type}}=0 for the same effect (will be 2.5x slower), but will produce better quality.
 
::{{Par2|depth|int|16}}
:::Range: -128 to 127 
::::Strength of the final warping. Negative values result in warping in opposite direction.
 
::{{Par2|chroma|int|4}}
::::Processing mode for chroma planes (U and V):
:::::* 0 : fill with zeroes
:::::* 1 : don't care
:::::* 2 : copy
:::::* 3 : process
:::::* 4 : guide by luma
:::::* 5 : same as 3, but don't process luma
:::::* 6 : same as 4, but don't process luma
 
== Examples ==
aWarpSharp2 with default values:
[[AviSource]]("Blah.avi")
aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)
 
 
--------------------------------------------------------
'''Back to [[aWarpSharp2#Filters|aWarpSharp2]] ←'''

@@ Line 48: / Line 48: @@
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)
 <br>
-Guide chroma with luma bump map but only process chroma (luma channel will be copied from the input clip).
+Guide chroma channels with luma edge mask but only process chroma (luma channel will be copied from the input clip).
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=6''')<br>
   #Identical to [[MergeChroma]](last, aWarpSharp2()) but faster and more memory efficient.
 <br>
-Only process the chroma channels with independent bump map and copy luma from the input clip.
+Process chroma channels with their own independent edge mask and copy luma channel from the input clip.
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=5''')<br>
   #Identical to [[MergeChroma]](last, aWarpSharp2(chroma=3)) but faster and more memory efficient.
 <br>
-Only process the luma channel and copy chroma from the input clip.
+Only process the luma channel and copy chroma channels from the input clip.
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=2''')<br>
   #Identical to [[MergeLuma]](last, aWarpSharp2()) but faster and more memory efficient.

@@ Line 48: / Line 48: @@
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)
 <br>
-Guide chroma with luma but only process chroma (luma channel will be copied from the input clip).
+Guide chroma with luma bump map but only process chroma (luma channel will be copied from the input clip).
- [[AviSource]]("Blah.avi")
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=6''')<br>
-  #identical to [[MergeChroma]](last, aWarpSharp2()) but faster and more memory efficient.
+  #Identical to [[MergeChroma]](last, aWarpSharp2()) but faster and more memory efficient.
 <br>
-Only process the chroma channels and copy luma from the input clip.
+Only process the chroma channels with independent bump map and copy luma from the input clip.
- [[AviSource]]("Blah.avi")
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=5''')<br>
-  #identical to [[MergeChroma]](last, aWarpSharp2(chroma=3)) but faster and more memory efficient.
+  #Identical to [[MergeChroma]](last, aWarpSharp2(chroma=3)) but faster and more memory efficient.
 <br>
 Only process the luma channel and copy chroma from the input clip.
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, '''chroma=2''')<br>
-  #identical to [[MergeLuma]](last, aWarpSharp2()) but faster and more memory efficient.
+  #Identical to [[MergeLuma]](last, aWarpSharp2()) but faster and more memory efficient.
 <br>
 --------------------------------------------------------
 '''Back to [[aWarpSharp2#Filters|aWarpSharp2]] &larr;'''

← Older revision		Revision as of 16:03, 23 August 2014
Line 1:		Line 1:
		+	[[Category:Plugin_Filters]]
		+	[[Category:Sharpening]]
	'''Back to [[aWarpSharp2#Filters\|aWarpSharp2]] ←'''		'''Back to [[aWarpSharp2#Filters\|aWarpSharp2]] ←'''
	--------------------------------------------------------		--------------------------------------------------------

@@ Line 1: / Line 1: @@
 {{FilterCat4|External_filters|Plugin_functions|Adjustment_filters|Sharpeners}}
-The same as '''[[AWarpsharp2/aWarp|aWarp(]][[AWarpsharp2/aSobel|aSobel().]][[AWarpsharp2/aBlur|aBlur())]]''' but a bit faster.
+<tt>aWarpSharp2</tt> performs edge detection, blurring, and warping, all in one.
 <br>
 <br>
@@ Line 10: / Line 10: @@
 <br>
 ::{{Par2|thresh|int|128}}
-:::Saturation limit for edge detection. Reduce for less aggressive sharpening.
+:::Saturation limit for edge detection; no pixel in the edge mask will have a value greater than {{Template:FuncDef3|thresh}}. Reduce for less aggressive sharpening.
 :::Range: 0 to 255
 <br>
 ::{{Par2|blur|int|2}}
-:::Number of blur passes over edge mask. Less passes increase sharpening effect, but can produce major artifacts with high {{Template:FuncDef|depth}} and {{Template:FuncDef|thresh}} values.<br>
+:::Number of blur passes over edge mask. Less passes increase sharpening effect, but can produce major artifacts with high {{Template:FuncDef3|depth}} and {{Template:FuncDef3|thresh}} values.<br>
-:::You can use values higher than 100, but probably won't see any difference. Chroma is processed with (blur+1)/2 passes.<br>
+:::You can use values higher than 100, but probably won't see any difference. Chroma is processed with <code>({{Template:FuncDef3|blur}}+1)/2</code> passes.<br>
 :::Range: 0 to 100
-:::<span style="color:red">'''Note:'''</span> Unless {{Template:FuncDef|blur}} is specifically set, it will default to 3 if {{Template:FuncDef|type}}=1.
+:::<span style="color:red">'''Note:'''</span> Unless {{Template:FuncDef3|blur}} is specifically set, it will default to 3 if {{Template:FuncDef3|type}}=1.
 <br>
 ::{{Par2|type|int|0}}
 :::Type of blur:
-:::* 0 : radius 6 blur.
+:::* 0 : radius 6 blur (some kind of 13x13 average).
-:::* 1 : radius 2 blur, requires around 8x more passes than {{Template:FuncDef|type}}=0 for the same effect (will be 2.5x slower), but will produce better quality.
+:::* 1 : radius 2 blur (some kind of 5x5 average), requires around 8x more passes than {{Template:FuncDef3|type}}=0 for the same effect (will be 2.5x slower), but will produce better quality.
 <br>
 ::{{Par2|depth|int|16}}
-:::Strength of the final warping. Negative values result in warping in opposite direction.
+:::Strength of the final warping. Negative values result in warping in opposite direction, i.e. will blur the image instead of sharpening.
 :::Range: -128 to 127
 <br>
 ::{{Par2|chroma|int|4}}
-:::Processing mode for chroma planes (U and V):
+:::Processing mode for the chroma channels (U and V):
-:::* 0 : fill with zeroes
+:::* 0 : fill with 0x80(128), output is grayscale.
-:::* 1 : don't care
+:::* 1 : don't care - chroma will be trashed.
-:::* 2 : copy
+:::* 2 : copy chroma channels from the input clip.
-:::* 3 : process
+:::* 3 : process chroma; create an edge mask from each chroma channel and use those to warp each chroma channel individually.
-:::* 4 : guide by luma
+:::* 4 : process chroma; use the edge mask from the luma to warp the chroma channels.
-:::* 5 : same as 3, but don't process luma
+:::* 5 : same as 3, but don't process luma.
-:::* 6 : same as 4, but don't process luma
+:::* 6 : same as 4, but don't process luma.
-:::Luma plane (Y) is always processed, except for mode 5 and 6 which simply copy the luma plane from the input clip.
+:::Luma plane (Y) is always processed, except for mode 5 and 6 which simply copy the luma channel from the input clip.
 <br>
 == Examples ==
 aWarpSharp2 with default values:
   [[AviSource]]("Blah.avi")
-  aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)
+  aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)<br>
 <br>
 Guide chroma channels with luma edge mask but only process chroma (luma channel will be copied from the input clip).

@@ Line 1: / Line 1: @@
-[[Category:Plugin_Filters]]
+{{FilterCat4|External_filters|Plugin_functions|Adjustment_filters|Sharpeners}}
-[[Category:Sharpening]]
 '''Back to [[aWarpSharp2#Filters|aWarpSharp2]] &larr;'''
 --------------------------------------------------------
 <br>
 == Description ==
@@ Line 9: / Line 7: @@
 <br>
 <br>
-==Syntax and Parameters ==
+== [[Script variables|Syntax and Parameters]] ==
 :{{Template:FuncDef|aWarpSharp2 (''clip'', ''int'' "thresh", ''int'' "blur", ''int'' "type", ''int'' "depth", ''int'' "chroma")}}
 <br>
 ::{{Par2|thresh|int|128}}
-:::Range: 0 to 255<br>
+:::Saturation limit for edge detection. Reduce for less aggressive sharpening.
-::::Saturation limit for edge detection. Reduce for less aggressive sharpening.
+:::Range: 0 to 255
 <br>
 ::{{Par2|blur|int|2}}
-:::Range: 0 to 100<br>
+:::Number of blur passes over edge mask. Less passes increase sharpening effect, but can produce major artifacts with high {{Template:FuncDef|depth}} and {{Template:FuncDef|thresh}} values.<br>
-::::Number of blur passes over edge mask.<br>
+:::You can use values higher than 100, but probably won't see any difference. Chroma is processed with (blur+1)/2 passes.<br>
-::::Less passes increase sharpening effect, but can produce major artifacts with high {{Template:FuncDef|depth}} and {{Template:FuncDef|thresh}} values.<br>
+:::Range: 0 to 100
-::::You can use values higher than 100, but probably won't see any difference.<br>
-::::Chroma is processed with (blur+1)/2 passes.<br>
 :::<span style="color:red">'''Note:'''</span> Unless {{Template:FuncDef|blur}} is specifically set, it will default to 3 if {{Template:FuncDef|type}}=1.
 <br>
 ::{{Par2|type|int|0}}
-::::Type of blur:
+:::Type of blur:
-:::::* 0 : radius 6 blur.
+::::* 0 : radius 6 blur.
-:::::* 1 : radius 2 blur, requires around 8x more passes than {{Template:FuncDef|type}}=0 for the same effect (will be 2.5x slower), but will produce better quality.
+::::* 1 : radius 2 blur, requires around 8x more passes than {{Template:FuncDef|type}}=0 for the same effect (will be 2.5x slower), but will produce better quality.
 <br>
 ::{{Par2|depth|int|16}}
-:::Range: -128 to 127<br>
+:::Strength of the final warping. Negative values result in warping in opposite direction.
-::::Strength of the final warping. Negative values result in warping in opposite direction.
+:::Range: -128 to 127
 <br>
 ::{{Par2|chroma|int|4}}
-::::Processing mode for chroma planes (U and V):
+:::Processing mode for chroma planes (U and V):
-:::::* 0 : fill with zeroes
+::::* 0 : fill with zeroes
-:::::* 1 : don't care
+::::* 1 : don't care
-:::::* 2 : copy
+::::* 2 : copy
-:::::* 3 : process
+::::* 3 : process
-:::::* 4 : guide by luma
+::::* 4 : guide by luma
-:::::* 5 : same as 3, but don't process luma
+::::* 5 : same as 3, but don't process luma
-:::::* 6 : same as 4, but don't process luma
+::::* 6 : same as 4, but don't process luma
 <br>
 == Examples ==
@@ Line 47: / Line 47: @@
   [[AviSource]]("Blah.avi")
   aWarpSharp2(thresh=128, blur=2, type=0, depth=16, chroma=4)
 <br>
 --------------------------------------------------------
 '''Back to [[aWarpSharp2#Filters|aWarpSharp2]] &larr;'''