TweakColor

Latest revision as of 17:07, 10 June 2020

[edit] Description

TweakColor has the ability to target specific hue and saturation ranges for hue and saturation adjustments. For example, you can target highly saturated reds (> 75% saturated) and reduce just them, leaving things like skin tones alone.

Based on the built in Tweak filter.

[edit] Requirements

• [x86]: AviSynth+ or AviSynth 2.6
• [x64]: AviSynth+
• Supported color formats: YUY2, YV12

[edit] Syntax and Parameters

TweakColor (clip, float "hue", float "sat", float "bright", float "cont", bool "coring", int "startHue", int "endHue", int "maxSat", int "minSat", int "smooth")

clip   =

Input clip.

float  hue = 0.0

Adjust the color hue of the image.

• hue>0.0 shifts the image towards red.
• hue<0.0 shifts the image towards green.

Range -180.0 to +180.0, default=0.0

float  sat = 1.0

Adjust the color saturation of the image by controlling gain of the color channels.

• sat>1.0 increases the saturation.
• sat<1.0 reduces the saturation.

Use sat=0 to convert to GreyScale.

Range 0.0 to 10.0, default=1.0

float  bright = 0.0

Change the brightness of the image by applying a constant bias to the luma channel.

• bright>0.0 increases the brightness.
• bright<0.0 decreases the brightness.

Range -255.0 to 255.0, default=0.0

float  cont = 1.0

Change the contrast of the image by multiplying the luma values by a constant.

• cont>1.0 increase the contrast (the luma range will be stretched).
• cont<1.0 decrease the contrast (the luma range will be contracted).

Range 0.0 to 10.0, default=1.0

bool  coring = true

When set to true (the default), the luma (Y) and chroma are clipped to TV-range;

When set to false, the luma and chroma are unconstrained.

int  startHue = 0

Starting hue to effect, in degrees. Exact magenta is ~ 50 degrees.

Colors are 60 degrees apart. +/-30 around center covers full color.

Colors run clockwise: magenta(50), red(110), yellow(170), green(230), cyan(290), blue(350)

Range: 0 to 359, default=0

int  endHue = 359

Ending hue. If < startHue, we go clockwise.

Range: 0 to 359, default=359

int  maxSat = 115

Max saturation level to effect. Sat is in percents running from 115%-0%.

Default=115

int  minSat = 0

Min saturation level to effect. Must be < maxSat.

Default=0

int  smooth = 16

Interpolates past max/min sats to smooth out changes (avoid contours).

Range: 0-64, default=16

[edit] Examples

TweakColor with default settings:

AviSource("blah.avi")
TweakColor(hue=0.0, sat=1.0, bright=0.0, cont=1.0, coring=true, startHue=0, endHue=359, maxSat=115, minSat=0, smooth=16)

[edit] Changelog

Version         Date            Changes

2020/04/14      2020/04/20      - Update to AviSynth 2.6 api
                                - x64 binary only
                                - updated by videoh

2004/04/12      2004/04/12      - Initial release

[edit] Archived Downloads

[edit] External Links

Back to External Filters ←