LimitedSharpen - Revision history

FranceBB: Updated the default radius value

2025-06-23T04:40:52Z

Updated the default radius value

Reel.Deal: /* Required Plugins */ typo

2015-11-28T00:03:50Z

‎Required Plugins: typo

Reel.Deal: /* Requirements */ update link

2015-10-27T03:06:02Z

‎Requirements: update link

Reel.Deal: /* Required Plugins */ space

2015-10-27T02:48:47Z

‎Required Plugins: space

Reel.Deal: /* Required Plugins */ add note

2015-10-27T02:48:26Z

‎Required Plugins: add note

Reel.Deal: finally add script

2015-06-14T16:30:41Z

finally add script

Reel.Deal: overhaul

2015-01-18T23:07:18Z

overhaul

Show changes

Reel.Deal: formatting

2014-09-26T22:15:23Z

formatting

Show changes

Admin: 1 revision

2013-05-19T22:03:49Z

1 revision

Wilbert at 21:25, 19 May 2013

2013-05-19T21:25:30Z

New page

__TOC__
{{FilterCat|External_filters|Adjustment_filters|Sharpeners}}
{{Filter|Didée|2.0b|[[Media:LimitedSharpenFaster.avs|LimitedSharpenFaster.avs]]|Sharpeners|
* YV12
|}}
{{FuncDef|LimitedSharpen(clip clp, float ''ss_x'', float ''ss_y'', int ''dest_x'', int ''dest_y'', int ''Smode'', int ''strength'', int ''radius'', int ''Lmode'', bool ''wide'', int ''overshoot'', int ''undershoot'', int ''soft'', int ''edgemode'', bool ''special'', int ''exborder'')}}

== Abstract ==

Applies a strong sharpening to edges and fine details by controlling halos and minimising artifacts. All sharpening is a 3-way struggle between edge-halos, edge-aliasing, and confetti artifacts; LimitedSharpen is an attempt to minimize each in the most visually pleasing way. For a similar filter that integrates denoising and sharpening into a single step, look at [[SeeSaw]].

=== Requires Filters ===
*[[MaskTools]] 1.5x
*[[MaskTools2]] 2a21+
*[[Removegrain]] 1.0-pre (Do not use SSE3 or it'll crash)
*[[Warpsharp]] for UnsharpMask

== Description ==

This should be used as the last filter in a chain if possible, like any sharpener. The different Smodes cause different defaults to be used in certain cases, or limit the ranges differently. See the source for specifics.

{{ParR|Smode|int|3|1-4}}
Sharpen mode:
* 1 : [[WarpSharp|UnsharpMask]]
* 2 : [[Sharpen]]
* 3 : Range sharpening.
* 4 : nonlinear sharpening.
Each mode has progressively less haloing in its sharpening.

{{Par|ss_x|float|1.5}}
{{Par|ss_y|float|1.5}}
[[Supersampling]] when > 1, which reduces aliasing on edges.

{{Par|dest_x|float|width}}
{{Par|dest_y|float|height}}
Resize directly to final size, saves a resize step.

{{Par|strength|int|160}}
Sharpening strength:
* For Smode=1, it can be 0~127 (simple sharpening), 128~255 (simple overdrive), 255~4096 (big overdrive).
* For Smode=2, values 0~100 are handled over to Sharpen() as 0.0~1.0. Values >100 are mapped to 100.
* For Smode=3, 0~100 is common, but 100~inf. can be used if necessary.
Default is strength=160 for Smode=1, and strength=100 otherwise.

{{ParR|radius|int|1|1-10}}
Radius of UnsharpMask, only used in Smode=1.

{{Par|overshoot|int|1}}
Sharpening limit: a sharpened pixel may not exceed [min,max] of the local neighborhood by more than 'overshoot'.
(High values remove the "Limited" of LimitedSharpen, and cause excessive haloing.)

{{Par|undershoot|int|[overshoot]}}
Separate limit for pixels that get darker during sharpening. Good for cartoons with strong lines.
(If not specified, then undershoot==overshoot.)

{{ParR|Lmode|int|1|0-3}}
Lmode:
* 0 : No effect
* 1 : Clamp to over/undershoot.
* 3 : Zero over/undershoot on edges, normal over/undershoot on not-edges.

{{ParR|soft|int|0|0-100}}
Softens the effect of sharpening. -1 will (try to) autocalculate a good value.

{{ParR|edgemode|int|0|-1 to 2}}
* -1 : shows edges.
* 0 : does nothing.
* 1 : restricts sharpening to edges
* 2 : restricts sharpening to mostly non-edges (I think?)

{{Par|special|bool|false}}
special=true tries to raise detail contrast in dark areas of a frame.
(Usage not really recommended - the method is simple and might cause artefacts.)

{{Par|wide|bool|false}}
With wide=true, the local [min,max] limits are gathered from the 5x5 neighborhood, instead just 3x3.
Enables more gain in detail contrast. Increasingly useful with increasing [[supersampling]] factors.

{{ParR|exborder|int|0|0-16}}

== Examples ==
<pre>
avisource("Blah.avi")
LimitedSharpenFaster()
</pre>
== Changelog ==

== Links ==
* Download [[Media:LimitedSharpenFaster.avs|LimitedSharpenFaster.avs]] : Current version, using masktools2.<br/>

* Advanced version, alias "v3.x" : [[LSFmod]]

* [http://forum.doom9.org/showthread.php?s=&threadid=84196 LimitedSharpen thread in doom9]

@@ Line 56: / Line 56: @@
 :::Default is strength=160 for Smode=1, and strength=100 otherwise.
 <br>
-::{{Par2|radius|int|1}}
+::{{Par2|radius|int|2}}
 :::Radius of UnsharpMask, only used in Smode=1.
 :::Range: 1 to 10

@@ Line 21: / Line 21: @@
 *<strike>RemoveGrain- part of the [[RemoveGrain v1.0b]] package.</strike>
 *[[RgTools]] - recommended drop-in replacement for RemoveGrain!
-*[[WarpSharp]] - only required when <code>{{FuncDef3|Smode}}=3</code>
+*[[WarpSharp]] - only required when <code>{{FuncDef3|Smode}}=1</code>
 <br>

@@ Line 13: / Line 13: @@
 <br>
 == Requirements ==
-* AviSynth 2.5.8 or later
+* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
 * Supported color formats: [[YV12]]

@@ Line 22: / Line 22: @@
 *[[RgTools]] - recommended drop-in replacement for RemoveGrain!
 *[[WarpSharp]] - only required when <code>{{FuncDef3|Smode}}=3</code>
 == [[Script variables|Syntax and Parameters]] ==

@@ Line 21: / Line 21: @@
 *<strike>RemoveGrain- part of the [[RemoveGrain v1.0b]] package.</strike>
 *[[RgTools]] - recommended drop-in replacement for RemoveGrain!
-*[[WarpSharp]]
+*[[WarpSharp]] - only required when <code>{{FuncDef3|Smode}}=3</code>
-−
 == [[Script variables|Syntax and Parameters]] ==

@@ Line 3: / Line 3: @@
 |Didée
 |2.0b
-|[[Media:LimitedSharpenFaster.avs|LimitedSharpenFaster.avs]]
+|[[Media:LimitedSharpenFaster.avsi|LimitedSharpenFaster.avsi]]
 |Sharpeners
+|