VerticalCleaner

Abstract
Author	Kassandro
Version	V0.1
Download	VericalCleaner
Category	Spatial Denoisers
Requirements	YUY2 YV12
License	GPL
Discussion

Introduction

A fast vertical median plugin.

There are 4 version of the plugin:

• VerticalCleaner.dll = dynamically linked SSE version
• VerticalCleanerS.dll = statically linked SSE version
• VerticalCleanerSSE2.dll = dynamically linked SSE2 version
• VerticalCleanerSSE3.dll = dynamically linked SSE3 version
  

Requirements

• YV12
• YUY2

Syntax and Parameters

VerticalCleaner(clip "input", int "mode", bool "planar")

mode int = 2

Modes:

• 0 : copy the frame
• 1 : vertical median
• 2 : relaxed vertical median (preserves more detail)
  

Description of mode 2:

Let b1, b2, c, t1, t2 be a vertical sequence of pixels. The center pixel c is to be modified in terms of the 4 neighbours.

For simplicity let us assume that b2 <= t1. Then in mode 1, c is clipped with respect to b2 and t1, i.e. c is replaced by max(b2, min(c, t1)).

In mode 2 the clipping intervall is widened, i.e. mode 2 is more conservative than mode 1.

If b2 > b1 and t1 > t2, then c is replaced by max(b2, min(c, max(t1,d1) )), where d1 = min(b2 + (b2 - b1), t1 + (t1 - t2)).

In other words, only if the gradient towards the center is positive on both clipping ends, then the upper clipping bound may be larger.

If b2 < b1 and t1 < t2, then c is replaced by max(min(b2, d2), min(c, t1)), where d2 = max(b2 - (b1 - b2), t1 - (t2 - t1)).

In other words, only if the gradient towards the center is negative on both clipping ends, then the lower clipping bound may be smaller.

In mode 1 the top and the bottom line are always left unchanged. In mode 2 the two first and the two last lines are always left unchanged.

planar bool = false

See SSETools Interleaved2Planar.

Examples

AviSource("Blah.avi")
VerticalCleaner()

Changelog

2008-02-28 :
 - Initial release

Links

- VideoProcessing Forum - Parameter description by Kassandro.
- VideoProcessing Forum - Mode 2 explanation by Kassandro.