Defish

Abstract
Author	wonkey_monkey, Efenstor
Version	v1.1
Download	defish.zip Multithreaded version: defish_mt.zip
Category	Transformation
License	GPLv2
Discussion	Doom9 Thread (original), Doom9 Thread (update)

Description

This filter can be used to correct (or induce) barrel and pincushion distortion.

Requirements

• [x86]: AviSynth+ or AviSynth 2.5.8 or greater
• Supported color formats: RGB32

Syntax and Parameters

defish (clip, float "fov", float "scale", float "aspect", string "direction", string "scaling", float "a", float "b", float "c", bool "pin", int "threads")

[unnamed]:
	Input clip. Must be RGB32 and have even width/height.

fov:
	useful range: -180.0 - 180.0
	default: 0
	The horizontal field of view, in degrees. Positive values will
	correct barrel distortion (induce pincushioning). Negative values
	should correct pincushion distortion (induce barreling), but note
	that this may currently be implemented incorrectly.

scale:
        range: 0.0 - infinity
	default: 1.0
	An adjustment parameter which scales the image after correction.

aspect:
	range: 0.0 - infinity
	default: 1.0
	The pixel aspect ratio of the input clip.

direction:
	values: "x", "y"
	This parameter restricts the correction to either horizontal or
	vertical only.

scaling:
	values: "fitx", "fity", "fitxy"
	This parameter automatically scales the image to fill the image
	horizontally, vertically, or both. The "scale" parameter above is
	still effective.

	The default behaviour when using fov is to scale the image such
	that the central area stays at the original scale.

	This parameter is not effective when using the polynomial values
	below.
a,b,c:
        sensible range: 0.0 - 1.0
        Parameters for correcting distortion polynomially. These are only
        effective when fov=0 (which is the default value).

        a+b+c must be less than or equal to 1.0 when pin=true.

pin:
	boolean
	Set this to true to correct pincushion distortion, and false to
	correct	barrel distortion - this may seem the wrong way around but
	it was chosen to match the behaviour of the similar parameter of
	V.C. Mohan's DeBarrel filter.

threads:
        range: 0 - infinity
        0 (default) sets the number of processing threads to the number of
        autodetected CPU's/cores.
        NOTE: this parameter is only for the MT version.

Examples

defish with default settings:

AviSource("Blah.avi")
defish(fov=0.0, scale=1.0, aspect=1.0, direction="xy", scaling="", a=0.0, b=0.0, c=0.0, pin=false)

Changelog

Version      Date            Changes

v1.1mt       2011/04/28      - multithreaded version by Efenstor
                             - includes additional "threads" parameter
v1.1         2010/02/21      - latest release

Archived Downloads

Version	Download	Mirror
v1.1	defish.zip /// defish_mt.zip	defish.zip /// defish_mt.zip

External Links

---

Back to External Filters ←