HSVAdjust

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(redirect for convenient searching)
 
(HSVAdjust: add documentation)
Line 1: Line 1:
#REDIRECT [[External_filters#Levels_and_Chroma]]
+
{{FilterCat4|External_filters|Plugins|Adjustment_filters|Levels_and_Chroma_filters}}
{{FilterCat|External_filters|Adjustment_filters|Levels_and_Chroma_filters}}
+
{{Filter3
 +
|1={{author/Wilbert Dijkhof}}
 +
|2=v0.1
 +
|3=[http://www.wilbertdijkhof.com/HSVAdjust_v01.zip HSVAdjust_v01.zip]
 +
|4=Effects
 +
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 +
|6=[http://forum.doom9.org/showthread.php?t=162022 Doom9 Forum]}}
 +
 
 +
== Description ==
 +
<code>HSVAdjust/HSLAdjust/HSIAdjust</code> let's you rotate hues, control the strength of color (saturation), or modify the brightness of a clip. The type of brightness depends on the filter. It's value for <code>HSVAdjust</code>, lightness for <code>HSLAdjust</code> or intensity for <code>HSIAdjust</code>.
 +
 
 +
The adjustments hue, saturation and brightness values are clipped to their valid ranges before they are converted back to RGB.
 +
 
 +
Note that all of the three spaces (HSV, HSL and HSI) are in fact approximations and the values are different with the exception that the hue in HSV and HSL coincide.
 +
<br>
 +
<br>
 +
== Requirements ==
 +
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
 +
* Supported color formats: [[RGB24]], [[RGB32]]
 +
<br>
 +
 
 +
== [[Script variables|Syntax and Parameters]] ==
 +
 
 +
:{{Template:FuncDef|HSVAdjust (clip, float "hue", float "sat", float "bright", float "cont", string "brightness")}}
 +
 
 +
:{{Template:FuncDef|HSLAdjust (clip, float "hue", float "sat", float "bright", float "cont")}}
 +
 
 +
:{{Template:FuncDef|HSIAdjust (clip, float "hue", float "sat", float "bright", float "cont")}}
 +
<br>
 +
::{{Par2| |clip| }}
 +
:::Input clip, must be RGB.
 +
<br>
 +
::{{Par2|hue|float|0.0}}
 +
:::Hue
 +
<br>
 +
::{{Par2|sat|float|1.0}}
 +
:::Saturation
 +
<br>
 +
::{{Par2|bright|float|0.0}}
 +
:::Brightness
 +
<br>
 +
::{{Par2|cont|float|1.0}}
 +
:::Contrast
 +
<br>
 +
::{{Par2|brightness|string|"lightness"}}
 +
:::Must be "value" or "lightness".
 +
<br>
 +
== Examples ==
 +
Default settings:
 +
 
 +
HSVAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0, brightness="lightness")
 +
 +
HSLAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0)
 +
 +
HSIAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0)
 +
<br>
 +
 
 +
== Changelog ==
 +
Version      Date            Changes<br>
 +
v0.1        2011/07/24      - initial release
 +
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
|-
 +
!v0.1
 +
|[http://www.wilbertdijkhof.com/HSVAdjust_v01.zip HSVAdjust_v01.zip]
 +
|[https://web.archive.org/web/20180828075523if_/http://www.wilbertdijkhof.com/HSVAdjust_v01.zip HSVAdjust_v01.zip]
 +
|}
 +
<br>
 +
 
 +
==External Links ==
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] &larr;'''

Revision as of 04:17, 3 July 2020

Abstract
Author Wilbert Dijkhof
Version v0.1
Download HSVAdjust_v01.zip
Category Effects
License GPLv2
Discussion Doom9 Forum

Contents

Description

HSVAdjust/HSLAdjust/HSIAdjust let's you rotate hues, control the strength of color (saturation), or modify the brightness of a clip. The type of brightness depends on the filter. It's value for HSVAdjust, lightness for HSLAdjust or intensity for HSIAdjust.

The adjustments hue, saturation and brightness values are clipped to their valid ranges before they are converted back to RGB.

Note that all of the three spaces (HSV, HSL and HSI) are in fact approximations and the values are different with the exception that the hue in HSV and HSL coincide.

Requirements


Syntax and Parameters

HSVAdjust (clip, float "hue", float "sat", float "bright", float "cont", string "brightness")
HSLAdjust (clip, float "hue", float "sat", float "bright", float "cont")
HSIAdjust (clip, float "hue", float "sat", float "bright", float "cont")


clip   =
Input clip, must be RGB.


float  hue = 0.0
Hue


float  sat = 1.0
Saturation


float  bright = 0.0
Brightness


float  cont = 1.0
Contrast


string  brightness = "lightness"
Must be "value" or "lightness".


Examples

Default settings:

HSVAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0, brightness="lightness")

HSLAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0)

HSIAdjust(hue=0.0, sat=1.0, bright=0.0, cont=1.0) 


Changelog

Version      Date            Changes
v0.1 2011/07/24 - initial release


Archived Downloads

Version Download Mirror
v0.1 HSVAdjust_v01.zip HSVAdjust_v01.zip


External Links




Back to External Filters

Personal tools