AWarpsharp2/aWarp: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
mNo edit summary
small documentation update
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Back to [[aWarpSharp2#Filters|aWarpSharp2]]'''
{{FilterCat4|External_filters|Plugin_functions|Adjustment_filters|Sharpeners}}
== Description ==
<tt>aWarp</tt> is designed for a more custom warp-sharpening than <tt>[[/aWarpSharp2|aWarpSharp2]]</tt> allows.  
A warp-sharpening filter.  
== Syntax and Parameters ==
:{{Template:FuncDef|aWarp(edge_mask_clip, int "depth", int "chroma")}}
<br>
<br>
::{{Par|edge_mask_clip| |}}
<br>
<br>
::{{Par|depth|int|3}}
== [[Script variables|Syntax and Parameters]] ==
:::Range: -128 to 127<br>
:{{Template:FuncDef|aWarp (''clip'', ''clip'', ''int'' "depth", ''int'' "chroma")}}
::::Strength of the final warping. Negative values result in warping in opposite direction.
<br>
<br>
::{{Par|chroma|int|1}}
::{{Par2| |clip| |}}
:::Processing mode for chroma planes (U and V):
:::Input clip.
::::* 0 : fill with zeroes
<br>
::::* 1 : don't care, default for aSobel and aBlur
::{{Par2| |clip| |}}
::::* 2 : copy
:::Edge mask clip; usually the input clip  processed by <tt>[[AWarpsharp2/aSobel|aSobel]]</tt> and followed by <tt>[[AWarpsharp2/aBlur|aBlur]]</tt>.
::::* 3 : process
:::If you want more stable results it's good idea to do anti-aliasing and temporal filtering (if necessary) on the edge mask before passing it to the warping stage.
::::* 4 : guide by luma - default for aWarpSharp, aWarp, and aWarp4 only
<br>
::::* 5 : same as 3, but don't process luma
::{{Par2|depth|int|3}}
::::* 6 : same as 4, but don't process luma
:::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
 
:::<span style="color:red">'''Note:'''</span> Chroma channels are internally processed with <code>{{Template:FuncDef|depth}}/2</code>.
<br>
::{{Par2|chroma|int|4}}
:::Processing mode for the chroma channels (U and V):
:::* 0 : fill with 0x80(128), output is grayscale.
:::* 1 : don't care - chroma will be trashed.
:::* 2 : copy chroma channels from the input clip.
:::* 3 : process chroma; create an edge mask from each chroma channel and use those to warp each chroma channel individually.
:::* 4 : process chroma; use the edge mask from the luma to warp the chroma channels.
:::* 5 : same as 3, 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 channel from the input clip.
<br>
 
== Examples ==
The following example is identical to <code>[[/aWarpSharp2|aWarpSharp2()]]</code>:
input    = [[AviSource]]("Blah.avi")
edge_mask = input.aSobel(thresh=128, chroma=1).aBlur(blur=2, type=0, chroma=1)<br>
aWarp(input, edge_mask, depth=16, chroma=4)
<br>
The following examples are written differently but are identical to the one above.
[[AviSource]]("Blah.avi")
aWarp(aSobel().aBlur(blur=2, type=0), depth=16)
 
input    = [[AviSource]]("Blah.avi")
edge_mask = input.aSobel().aBlur(blur=2, type=0)<br>
aWarp(input, edge_mask, depth=16)
<br>
--------------------------------------------------------
'''Back to [[aWarpSharp2#Filters|aWarpSharp2]] &larr;'''

Latest revision as of 02:04, 10 November 2015

aWarp is designed for a more custom warp-sharpening than aWarpSharp2 allows.

aWarp (clip, clip, int "depth", int "chroma")


clip   =
Input clip.


clip   =
Edge mask clip; usually the input clip processed by aSobel and followed by aBlur.
If you want more stable results it's good idea to do anti-aliasing and temporal filtering (if necessary) on the edge mask before passing it to the warping stage.


int  depth = 3
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
Note: Chroma channels are internally processed with depth/2.


int  chroma = 4
Processing mode for the chroma channels (U and V):
  • 0 : fill with 0x80(128), output is grayscale.
  • 1 : don't care - chroma will be trashed.
  • 2 : copy chroma channels from the input clip.
  • 3 : process chroma; create an edge mask from each chroma channel and use those to warp each chroma channel individually.
  • 4 : process chroma; use the edge mask from the luma to warp the chroma channels.
  • 5 : same as 3, 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 channel from the input clip.


Examples

The following example is identical to aWarpSharp2():

input     = AviSource("Blah.avi")
edge_mask = input.aSobel(thresh=128, chroma=1).aBlur(blur=2, type=0, chroma=1)
aWarp(input, edge_mask, depth=16, chroma=4)


The following examples are written differently but are identical to the one above.

AviSource("Blah.avi")
aWarp(aSobel().aBlur(blur=2, type=0), depth=16)
input     = AviSource("Blah.avi")
edge_mask = input.aSobel().aBlur(blur=2, type=0)
aWarp(input, edge_mask, depth=16)



Back to aWarpSharp2