DeCrawl

Revision as of 02:48, 8 November 2013

Introduction

Removes dot crawl, particularly in animated material.

Requirements

• YV12

Syntax and Parameters

DeCrawl(int "ythresht", int "ythreshs", int "cthresh", int "temporal", int "spatial", int "spatialpasses")

ythresht int = 7

Temporal luma threshold:

Range: 0 to 255

The 2 temporally surrounding pixels must have a luma value within this threshold.

ythreshs int = 8

Spatial luma threshold:

Range: 0 to 255

The 2 vertically surrounding pixels must have a luma value within this threshold.

cthresh int = 2

Chroma threshold:

Range: 0 to 255

All 3 pixels must have a chroma value within this amount of each other.

temporal int = 50

Temporal filtering:

Range: 0 to 100

Strength for temporal filtering. Set to 0 to disable.

Temporal filtering will replace each pixel with 50% of the current pixel (Yc) + 25% of the temporally previous pixel (Yp) + 25% of the next pixel (Yn), if:

• Yc-Yp <= ythresht
• Yc-Yn <= ythresht
• Yp-Yn <= ythresht/8
• chroma conditions are similar if enabled

spatial int = 100

Spatial filtering:

Range: 0 to 100

Strength for spatial filtering. Set to 0 to disable.

Spatial filtering uses 1/2P(x,y) + 1/8P(x,y-1) + 1/8P(x,y+1) + 1/8P(x-w/376,y) + 1/8P(x+w/376,y),

only taking into account the factors that are within the threshold. It does NOT cap those parameters to one threshold away.

If a factor is not within the thresfield, the original pixel is substituted. Overall,

it's not very destructive to most video as long as the threshold isn't set too high.

You might want to use this two or three times in a row, but don't filter temporally at all past the first time.

Note: if a pixel is filtered temporally, it will not be filtered spatially.

spatialpasses int = 1

Number of times to spatially filter, in case the effect is too weak for your source..

Examples

AviSource("Blah.avi")
DeCrawl()

Changelog

    - 0.51 - Minor speedup
    - 0.50 - Major speedup to chroma thresholding
    - 0.42 - Added spatialpasses
    - 0.41 - Bitblt chroma, thresholding tweaks, enable more compiler optimizations (note: 0.40+ are compiled w/ SSE)
    - 0.40 - Chroma for thresholding is now interpolated, chroma thresholding now affects spatial filtering, temporal thresholding slightly improved, defaults changed
    - 0.32 - slight optimizations, spatial filtering no longer takes precedence over temporal filtering
    - 0.31 - slight thresholding fix
    - 0.30 - Spatial filtering is now an adaptive convolution filter. See above...
    - 0.25 - Added basic 3-line spatial filtering. It doesn't work too well at the moment, though.
    - 0.20 - Major changes. This won't even seem like the same filter anymore. Don't set ythresh too high, though, ESPECIALLY if you use it on interlaced video.
             It may be used on interlaced video if you are careful.
    - 0.15 - Fixed a nasty bug (typo) with chroma checking...
    - 0.14 - I had ydiffthresh and ysamethresh reversed in the readme. Made filter more subtle, but still kicking ass on dot crawl.
    - 0.13 - Minor MMX optimization. Changed the averaging to average the current pixel and the 2 temporally surrounding pixels, instead of just the 2 surrounding.
    - 0.12 - HUGE bugfix making crashes quite often...
    - 0.11 - Added defaults (2,10,2)
    - 0.10 - Initial release

Links