AWarpSharp

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (AWarpSharp beta 2)
(Known Issues)
 
(13 intermediate revisions by one user not shown)
Line 1: Line 1:
{{FilterCat|External_filters|Restoration_filters|Sharpeners}}
+
{{FilterCat4|External_filters|Plugins|Adjustment_filters|Sharpeners}}
{{Filter2
+
{{Filter3
 
| {{Author/Marc FD}}
 
| {{Author/Marc FD}}
| beta 2?
+
| beta 1
| [http://web.archive.org/web/20131103155757/http://leak.no-ip.org/AviSynth/AWarpSharpDering/AWarpSharp(Pruned).zip aWarpSharp(Pruned).zip]
+
| [http://web.archive.org/web/20070105185349/http://ziquash.chez-alice.fr/aWarpSharp%20beta%201.zip aWarpSharp beta 1.zip]
 
| Sharpeners
 
| Sharpeners
 
| Closed source
 
| Closed source
|}}
+
|6=[http://forum.doom9.org/showthread.php?t=44843 Doom9 Thread]}}
 
<br>
 
<br>
 
== Description ==
 
== Description ==
:A warp sharpening filter. aWarpSharp implements high-quality original warp sharpening.  
+
A warp sharpening filter. aWarpSharp implements high-quality original warp sharpening. "original" meaning the algorithm used differs on several points to other warp sharpening filters. The code is fully [[ISSE]] optimized with high accuracy.<br>
:"original" meaning the algorithm used differs on several points to other warp sharpening filters. The code is fully [[ISSE]] optimized with high accuracy.
+
<br>
 +
'''Note:''' aWarpsharp is considered deprecated, [[aWarpSharp2]] is highly recommended as a drop-in replacement.<br>
 
<br>
 
<br>
== Requirements: ==
 
:- AviSynth 2.5.8 or later
 
:- [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
 
:- Supported color formats: [[YV12]]
 
  
:- [[ISSE]] compatible CPU.
+
== Known Issues ==
 +
<tt>aWarpSharp</tt> is known to cause some color artifacts around the edges, read the following threads for more information.
 +
 
 +
*[https://web.archive.org/web/20080405172038/https://forum.doom9.org/showthread.php?t=113677 <tt>aWarpSharp</tt> edge artifacts]
 +
*[https://web.archive.org/web/20140719220807/http://forum.doom9.org/showthread.php?t=170914 <tt>aWarpSharp</tt> green artifacts on edges.]
 +
*[http://forum.doom9.org/showpost.php?p=1068841&postcount=9 Using <tt>BorderMirror</tt> to pad the input before using <tt>aWarpSharp</tt>.]
 
<br>
 
<br>
  
 +
== Requirements ==
 +
* AviSynth 2.5.8 or later
 +
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
 +
* Supported color formats: [[YV12]]
 +
 +
* [[ISSE]] compatible CPU.
 
<br>
 
<br>
== Syntax and Parameters ==
+
 
:{{Template:FuncDef|aWarpSharp (''clip'', ''float'' "depth", ''int'' "blurlevel", ''float'' "thresh", ''int'' "cm", ''int'' "bm", ''int'' "tweak")}}
+
== [[Script variables|Syntax and Parameters]] ==
 +
:{{Template:FuncDef|aWarpSharp (''clip'', ''float'' "depth", ''int'' "blurlevel", ''float'' "thresh", ''int'' "cm", ''int'' "bm", ''bool'' "show")}}
 
<br>
 
<br>
::{{Par|depth|float|16.0}}
+
::{{Par2| |clip| }}
 +
:::Input clip.
 +
<br>
 +
::{{Par2|depth|float|16.0}}
 
:::Range: 0.0 - 64.0
 
:::Range: 0.0 - 64.0
::::depth and blurlevel are the only settings you need to tweak to achieve any effect.
+
::::{{Template:FuncDef|depth}} determines the amount of warping. It directly affects how thin your lines will end up.
 
<br>
 
<br>
::{{Par|blurlevel|int|2}}
+
::{{Par2|blurlevel|int|2}}
 
:::Range: 1 - 4<br>
 
:::Range: 1 - 4<br>
::::depth and blurlevel are the only settings you need to tweak to achieve any effect.
+
::::Higher {{Template:FuncDef|blurlevel}} values are slower, but can give a big boost to the warp sharpening.
::::blurlevel consumes CPU power, but gives a big boost to the warp sharpening.
+
::::If you find that the warping is distorting certain shapes too much, try lowering this parameter first.  
 
<br>
 
<br>
::{{Par|thresh|float|0.5}}
+
::{{Par2|thresh|float|0.5}}
 
:::Range: 0.0 - 1.0<br>
 
:::Range: 0.0 - 1.0<br>
::::A float value of 1.0 means 100% (max). It's the bump mapping saturation setting.
+
::::The bump mapping saturation setting:
::::Default value is recommended for maximum quality.
+
:::::A float value of 1.0 means 100% (max).
 +
:::::The default value (0.5) is recommended for maximum quality.
 
::::If you tweak this setting, keep in mind it will enhance inequality of warping between edges.<br>
 
::::If you tweak this setting, keep in mind it will enhance inequality of warping between edges.<br>
 
<br>
 
<br>
::{{Par|cm|int|2}}
+
::{{Par2|cm|int|3}}
 
:::Chroma mode:
 
:::Chroma mode:
 
::::* 0 : disables chroma filtering
 
::::* 0 : disables chroma filtering
 
::::* 1 : enables chroma warping with luma bump map (recommended)
 
::::* 1 : enables chroma warping with luma bump map (recommended)
 
::::* 2 : enables chroma independent warping & bump map
 
::::* 2 : enables chroma independent warping & bump map
::::* 3 : chroma -> luma
+
::::* 3 : chroma -> chroma (default)
::::* 4 : chroma -> chroma
+
 
 +
:::<span style="color:red">'''Note:'''</span> Default in the included documentation is wrong. This wiki documentation has been revised and it's correct. 
 
<br>
 
<br>
::{{Par|bm|int|1}}
+
::{{Par2|bm|int|2}}
 
:::Blur modes:
 
:::Blur modes:
 
::::* 0 : hq 3-pass
 
::::* 0 : hq 3-pass
Line 54: Line 68:
 
::::* 3 : light blur
 
::::* 3 : light blur
 
<br>
 
<br>
::{{Par|tweak|int|0}}
+
::{{Par2|show|bool|false}}
::::* 0 : disabled
+
:::If true, it will show an edge mask; useful for adjusting {{Template:FuncDef|depth}}, {{Template:FuncDef|blurlevel}}.  
::::* 1 : shows an edge mask. Useful for adjusting depth, blurlevel, and thresh.  
+
 
<br>
 
<br>
 +
 
== Examples ==
 
== Examples ==
aWarpSharp with all default values.
+
aWarpSharp with all default settings:
 
  [[AviSource]]("Blah.avi")
 
  [[AviSource]]("Blah.avi")
  Awarpsharp(depth=16.0, blurlevel=2, thresh=0.5, cm=2, bm=1, tweak=0)
+
  aWarpSharp(depth=16.0, blurlevel=2, thresh=0.5, cm=3, bm=2, show=false)
 
<br>
 
<br>
 +
 
== Changelog ==
 
== Changelog ==
  Changes [http://leak.no-ip.org/AviSynth/AWarpSharpDering/AWarpSharp(Pruned).zip 2004-05-25:]
+
  Version      Date            Changes<br>
    beta 2?
+
  beta 1      2003/02/03     - Initial release
      - added "tweak" parameter
+
      - removed "show" parameter
+
      - changed defaults to "bm" and "cm"
+
      - document previously undocumented "bm" parameter<br>
+
  Changes [http://www.avisynth.nl/users/warpenterprises/files/awarpsharp_5F25_dll_20030203.zip 2003-02-03:]
+
    beta 1
+
      - Initial release
+
<br>
+
== aWarpSharp beta 1 ==
+
[[aWarpSharp beta 1]] documentation.
+
 
<br>
 
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
!!width="150px"| Mirror 2
 +
|-
 +
!beta 1
 +
|[http://web.archive.org/web/20070105185349/http://ziquash.chez-alice.fr/aWarpSharp%20beta%201.zip aWarpSharp beta 1.zip]
 +
|[http://ziquash.chez-alice.fr/aWarpSharp%20beta%201.zip aWarpSharp beta 1.zip]
 +
|[http://www.avisynth.nl/users/warpenterprises/files/awarpsharp_5F25_dll_20030203.zip awarpsharp_dll_20030203.zip]
 +
|}
 
<br>
 
<br>
 +
 
== External Links ==
 
== External Links ==
- [http://forum.doom9.org/showthread.php?t=44843 Doom9 Forum] - Discussion about aWarpSharp.
+
*[http://forum.doom9.org/showthread.php?t=44843 Doom9 Forum] - aWarpSharp discussion.
<br>
+
*[http://www.aquilinestudios.org/avsfilters/sharpeners.html#awarpsharp Scintilla's Guide] - Additional information.
 
<br>
 
<br>
 
<br>
 
<br>
 
-----------------------------------------------
 
-----------------------------------------------
 
'''Back to [[External_filters#Sharpeners|External Filters]] &larr;'''
 
'''Back to [[External_filters#Sharpeners|External Filters]] &larr;'''

Latest revision as of 18:13, 24 November 2017

Abstract
Author Marc FD
Version beta 1
Download aWarpSharp beta 1.zip
Category Sharpeners
License Closed source
Discussion Doom9 Thread


Contents

[edit] Description

A warp sharpening filter. aWarpSharp implements high-quality original warp sharpening. "original" meaning the algorithm used differs on several points to other warp sharpening filters. The code is fully ISSE optimized with high accuracy.

Note: aWarpsharp is considered deprecated, aWarpSharp2 is highly recommended as a drop-in replacement.

[edit] Known Issues

aWarpSharp is known to cause some color artifacts around the edges, read the following threads for more information.


[edit] Requirements

  • AviSynth 2.5.8 or later
  • Progressive input only
  • Supported color formats: YV12
  • ISSE compatible CPU.


[edit] Syntax and Parameters

aWarpSharp (clip, float "depth", int "blurlevel", float "thresh", int "cm", int "bm", bool "show")


clip   =
Input clip.


float  depth = 16.0
Range: 0.0 - 64.0
depth determines the amount of warping. It directly affects how thin your lines will end up.


int  blurlevel = 2
Range: 1 - 4
Higher blurlevel values are slower, but can give a big boost to the warp sharpening.
If you find that the warping is distorting certain shapes too much, try lowering this parameter first.


float  thresh = 0.5
Range: 0.0 - 1.0
The bump mapping saturation setting:
A float value of 1.0 means 100% (max).
The default value (0.5) is recommended for maximum quality.
If you tweak this setting, keep in mind it will enhance inequality of warping between edges.


int  cm = 3
Chroma mode:
  • 0 : disables chroma filtering
  • 1 : enables chroma warping with luma bump map (recommended)
  • 2 : enables chroma independent warping & bump map
  • 3 : chroma -> chroma (default)
Note: Default in the included documentation is wrong. This wiki documentation has been revised and it's correct.


int  bm = 2
Blur modes:
  • 0 : hq 3-pass
  • 1 : fast 3-pass
  • 2 : fast 1-pass
  • 3 : light blur


bool  show = false
If true, it will show an edge mask; useful for adjusting depth, blurlevel.


[edit] Examples

aWarpSharp with all default settings:

AviSource("Blah.avi")
aWarpSharp(depth=16.0, blurlevel=2, thresh=0.5, cm=3, bm=2, show=false)


[edit] Changelog

Version      Date            Changes
beta 1 2003/02/03 - Initial release


[edit] Archived Downloads

Version Download Mirror Mirror 2
beta 1 aWarpSharp beta 1.zip aWarpSharp beta 1.zip awarpsharp_dll_20030203.zip


[edit] External Links




Back to External Filters

Personal tools