Reel.Deal: Manual_WP (2020/09/04)

2020-11-09T06:50:18Z

Manual_WP (2020/09/04)

New page

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters|Deep_color_tools}}
{{Filter3
|[https://github.com/crabshank crabshank]
|2020-09-04
|3=[https://github.com/crabshank/Avisynth-filters/blob/master/C_Manual_WP_x64.dll C_Manual_WP_x64.dll]
|4=Adjustment Filters
|5=Open source
|6=[https://forum.doom9.org/showthread.php?t=177045 Doom9 Forum]
}}
== Description ==
[[Manual_WP]] allows you to fix the white balance of media by changing the white point of it using the appropriate Bradford transform and transfer functions for 11 colour spaces (see <code>"mode"</code> parameter).

It allows you to enter the xy value directly or, much more easily, enter the RGB values (0-255/0-65535) that you wish to turn grey. It also allows you to enter a target white point for the final output (<code>"dst_x"</code> and <code>"dst_y"</code> parameters).
 
 

== Requirements ==
* [[AviSynth+]] (x64 only)
* Supported color formats: [[RGB32]], [[RGB64]]
 

== [[Script variables|Syntax and Parameters]] ==

:{{Template:FuncDef|Manual_WP (clip, float "x", float "y", int "R", int "G", int "B", int "mode", int "debug", float "debug_val", bool "sixtyFour", float "dst_x", float "dst_y", bool "auto_WP", string "file", string "log_id", bool "overwrite", bool "linear", string "edits", int "ed_off")}}
 
::{{Par2| |clip| }}
:::Input clip, must be RGB32 or RGB64.
 
::{{Par2|x|float|0.312727}}
::{{Par2|y|float|0.329023}}
:::Range: 0.0 to 1.0 by 0.0001
 
::{{Par2|R|int|-1}}
::{{Par2|G|int|-1}}
::{{Par2|B|int|-1}}
:::Set R, G and B as valid integers (0-255/0-65535) and it will use the xy value required to turn this specified RGB colour grey, even if x and y are specified as well (so it takes precedence).
 
::{{Par2|mode|int|0}}
:::*0 - sRGB (default)
:::*1 - Rec. 601 NTSC
:::*2 - Rec. 601 PAL
:::*3 - Rec. 709
:::*4 - Rec. 2020
:::*5 - DCI-P3
:::*6 - Display P3
:::*7 - Orginal NTSC (47 CFR § 73.682 - TV transmission standards)
:::*8 - Rec. 601 D93 (Use for Japanese media)
:::*9 - Rec. 709 D93 (Some Japanese media may use this)
:::*10 - DCI-P3 (D60/ACES)
:::*11 - Rec. 2100/2020 Hybrid Log-Gamma
 
::{{Par2|debug|int|0}}
:::*0 - Off (default)
:::*1 - pow(Saturation, debug_val)
:::*2 - Outputs all pixels >= debug_val (0-1), and blacks out all pixels < debug_val in saturation.
:::*3 - Outputs, in black, all pixels that have had at least a (debug_val)% reduction in saturation.
:::*4 - Outputs:
:::**Saturation decreased: Hues from 157.5° (min) to 240° (max) (Cyan -> Blue)
:::**Saturation increased: Hues from 307.5° (min) to 7.5° (max) (Magenta -> Orange)
:::**Value (HSV): 1-debug_val
 
::{{Par2|debug_val|float|1.0}}
:::Range: 0.0 to 1.0 by 0.001
 
::{{Par2|sixtyFour|bool|false}}
:::It's not necessary to set this argument, because the plugin will automatically detect if RGB64 is used.
:::True (not recommended) - Force 64-bit processing in plugin.
 
::{{Par2|dst_x|float|0.312727}}
::{{Par2|dst_y|float|0.329023}}
:::Set a target output white point for the output (other than D65).
 
::{{Par2|auto_WP|bool|false}}
:::If set to true, it attempts to find the ideal pixel in the frame for the white point.
 
::{{Par2|file|string|""}}
:::Enter the path to the file which you would like to write the debug data for auto_WP mode (e.g. "C:\vid_WP.txt").
 
::{{Par2|log_id|string|""}}
:::On each line of the debug file will be written: "log_id: R, G, B - Frame number". N.B. the RGB values are the input to the plugin.
 
::{{Par2|overwrite|bool|true}}
:::By default (true), the debug file will be overwritten if a file with the same name already exists every time the plugin is loaded; setting this to false will append to the file if it already exists.
 
::{{Par2|linear|bool|false}}
:::Takes linear RGB as input and outputs linear RGB.
 
::{{Par2|edits|string|""}}
<div style="margin-left: 6em; max-width: 67em">
<pre>
e.g.

s="""

{247,250,254,0,3473,0.312727,0.329023}

{-1,-1,-1,3474,18628,0.3234151,0.3058452}

{250,240,255,18629,18831,0.312727,0.329023}

"""

{R,G,B,start,end,x,y}

= trim(start, end).Manual_WP(R=R, G=G, B=B, x=x, y=y, ..., edits=s)

N.B. All characters except: "{",", "-", "0-9", ".", "," and "}"; are removed from the input string.

N.N.B. The maximum number of edits in one string is defined as "MAX_PATH" in Windows (260 usually).
</pre>
</div>
 
::{{Par2|ed_off|int|0}}
:::e.g. ed_off=-1: use the RGB values from the previous (current-1) {R,G,B,start,end}, from the edits' string.
 
::'''Note:''' It's important to use D93 modes where appropriate.
 
== Examples ==
[[TODO]]

 
==External Links ==
*[https://github.com/crabshank/Avisynth-filters GitHub] - Source code repository.
 
 
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] ←'''

Manual WP - Revision history

Reel.Deal: Manual_WP (2020/09/04)