AWarpSharp

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with "{{FilterCat|External_filters|Restoration_filters|Sharpeners}} {{Filter | {{Author/Marc FD}} | Beta 1 | [http://www.avisynth.nl/users/warpenterprises/files/awarpsharp_5F25_dll_...")
 
(→‎Known Issues)
 
(16 intermediate revisions by one user not shown)
Line 1: Line 1:
−
{{FilterCat|External_filters|Restoration_filters|Sharpeners}}
+
{{FilterCat4|External_filters|Plugins|Adjustment_filters|Sharpeners}}
−
{{Filter
+
{{Filter3
 
| {{Author/Marc FD}}
 
| {{Author/Marc FD}}
−
| Beta 1
+
| beta 1
−
| [http://www.avisynth.nl/users/warpenterprises/files/awarpsharp_5F25_dll_20030203.zip aWarpSharp]
+
| [http://web.archive.org/web/20070105185349/http://ziquash.chez-alice.fr/aWarpSharp%20beta%201.zip aWarpSharp beta 1.zip]
 
| Sharpeners
 
| Sharpeners
−
|
+
| Closed source
−
* YV12
+
|6=[http://forum.doom9.org/showthread.php?t=44843 Doom9 Thread]}}
−
|
+
−
|}}
+
 
<br>
 
<br>
−
== Introduction ==
+
== Description ==
−
:a WarpSharpenning filter for Avisynth 2.5<br>
+
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>
−
==== Requirements ====
+
−
::* [[YV12]]
+
−
::* ISSE compatible CPU.
+
 
<br>
 
<br>
−
== Parameters ==
+
'''Note:''' aWarpsharp is considered deprecated, [[aWarpSharp2]] is highly recommended as a drop-in replacement.<br>
−
 
+
−
{{Template:FuncDef|aWarpSharp(float "depth", int "blurlevel", float "thresh", int "cm", int "bm", bool "show")}}
+
 
<br>
 
<br>
 +
 +
== 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>
−
:{{Par|depth|float|16.0}}
 
−
::range: 0.0 - 64.0
 
  
−
:{{Par|blurlevel|int|2}}
+
== Requirements ==
−
::range: 1 - 4<br>
+
* 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]]
  
−
:::These are the only settings you need to tweak to achieve any effect.
+
* [[ISSE]] compatible CPU.
−
:::Blurlevel consumes CPU power, but gives a big boost to the warpsharpenning.
+
 
<br>
 
<br>
−
:{{Par|thresh|float|0.5}}
 
−
::range: 0.0 - 1.0<br>
 
  
−
:::A float value of 1.0 means 100% (max). It's the bump mapping saturation setting.
+
== [[Script variables|Syntax and Parameters]] ==
−
:::Default value is recommended for maximum quality.
+
:{{Template:FuncDef|aWarpSharp (''clip'', ''float'' "depth", ''int'' "blurlevel", ''float'' "thresh", ''int'' "cm", ''int'' "bm", ''bool'' "show")}}
−
:::If you tweak this setting, keep in mind it will enhance inequality of warping between edges.<br>
+
 
<br>
 
<br>
−
:{{Par|cm|int|2}}
+
::{{Par2| |clip| }}
−
::chroma mode:
+
:::Input clip.
 +
<br>
 +
::{{Par2|depth|float|16.0}}
 +
:::Range: 0.0 - 64.0
 +
::::{{Template:FuncDef|depth}} determines the amount of warping. It directly affects how thin your lines will end up.
 +
<br>
 +
::{{Par2|blurlevel|int|2}}
 +
:::Range: 1 - 4<br>
 +
::::Higher {{Template:FuncDef|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.
 +
<br>
 +
::{{Par2|thresh|float|0.5}}
 +
:::Range: 0.0 - 1.0<br>
 +
::::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.<br>
 +
<br>
 +
::{{Par2|cm|int|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)
  
−
:::* 0 : disables chroma filtering
+
:::<span style="color:red">'''Note:'''</span> Default in the included documentation is wrong. This wiki documentation has been revised and it's correct. 
−
:::* 1 : enables chroma warping with luma bump map (recommended)
+
−
:::* 2 : enables chroma independent warping & bump map
+
−
:::* 3 : chroma -> luma
+
−
:::* 4 : chroma -> chroma
+
 
<br>
 
<br>
−
:{{Par|bm|int|2}}
+
::{{Par2|bm|int|2}}
−
::blur modes:
+
:::Blur modes:
−
:::* 0 : hq 3-pass
+
::::* 0 : hq 3-pass
−
:::* 1 : fast 3-pass
+
::::* 1 : fast 3-pass
−
:::* 2 : fast 1-pass
+
::::* 2 : fast 1-pass
−
:::* 3 : light blur
+
::::* 3 : light blur
 
<br>
 
<br>
−
:{{Par|show|bool|false}}
+
::{{Par2|show|bool|false}}
−
::If true, it will show an edge mask. Useful for adjusting depth, blurlevel, and thresh.  
+
:::If true, it will show an edge mask; useful for adjusting {{Template:FuncDef|depth}}, {{Template:FuncDef|blurlevel}}.  
 
<br>
 
<br>
 +
 
== Examples ==
 
== Examples ==
 +
aWarpSharp with all default settings:
 
  [[AviSource]]("Blah.avi")
 
  [[AviSource]]("Blah.avi")
−
  aWarpSharp()
+
  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 undocumented "tweak" parameter
+
−
      - removed "show" parameter
+
−
      - 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>
 
<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>
 +
 
== 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.
 +
*[http://www.aquilinestudios.org/avsfilters/sharpeners.html#awarpsharp Scintilla's Guide] - Additional information.
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''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 ←

Retrieved from "http://avisynth.nl/index.php?title=AWarpSharp&oldid=10116"
Personal tools