GreyScale: Difference between revisions
From Avisynth wiki
Jump to navigationJump to search
No edit summary |
mNo edit summary |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<div {{BlueBox2|40|0|3px solid purple}} > | |||
{{AvsPlusFullname}}<br> | |||
Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/greyscale.html https://avisynthplus.readthedocs.io] | |||
</div> | |||
Converts the input clip to greyscale (no color), without changing the [[Convert|color format]]. | Converts the input clip to greyscale (no color), without changing the [[Convert|color format]]. | ||
UK (''Gr'''''e'''''yscale'') and US (''Gr'''''a'''''yscale'') spellings are both allowed. | |||
{{ | {{Func2Def | ||
|Greyscale(clip ''clip'' [, string ''matrix'']) | |||
|Grayscale(clip ''clip'' [, string ''matrix'']) | |||
}} | |||
:{{Par2|matrix|string|"Rec601"}} | :{{Par2|matrix|string|"Rec601"}} | ||
::In RGB based formats, the conversion produces the luma using the coefficients given in the matrix parameter. | ::In RGB based formats, the conversion produces the luma using the coefficients given in the matrix parameter. | ||
::*"Rec601" : Use Rec.601 coefficients (and keeping luma range unchanged) | ::*"Rec601" : Use Rec.601 coefficients (and keeping luma range unchanged) | ||
::*"Rec709" : Use Rec.709 coefficients (and keeping luma range unchanged) | ::*"Rec709" : Use Rec.709 (HD) coefficients (and keeping luma range unchanged) | ||
::*"Rec2020" : Use Rec.2020 (UHD) coefficients (and keeping luma range unchanged) {{AvsPluscon}} | |||
::*"AVERAGE" : Use averaged coefficients (''Y'' = (R + G + B) / 3) | ::*"AVERAGE" : Use averaged coefficients (''Y'' = (R + G + B) / 3) | ||
If {{FuncArg|clip}} is [[YUV]], the chroma channels are simply set to grey (128) – {{FuncArg|matrix}} is not used '''and must not''' be specified otherwise an error will be thrown. | If {{FuncArg|clip}} is [[YUV]], the chroma channels are simply set to grey (128{{D}}) – {{FuncArg|matrix}} is not used '''and must not''' be specified otherwise an error will be thrown. | ||
See [[Color conversions]] for an explanation of the coefficients. Broadly speaking though, | See [[Color conversions]] for an explanation of the coefficients. Broadly speaking though, | ||
| Line 17: | Line 29: | ||
:*using ''Average'', '''blue''' contributes more. | :*using ''Average'', '''blue''' contributes more. | ||
In all cases, Luma range is not changed (0-255 in → 0-255 out; 16-235 in → 16-235 out) | In all cases, Luma range is not changed (0{{D}}-255{{D}} in → 0{{D}}-255{{D}} out; 16{{D}}-235{{D}} in → 16{{D}}-235{{D}} out) | ||
[[Category:Internal filters]] | [[Category:Internal filters]] | ||
[[Category:Levels_and_Chroma_filters]] | [[Category:Levels_and_Chroma_filters]] | ||
Latest revision as of 06:31, 18 September 2022
AviSynth+
Up-to-date documentation: https://avisynthplus.readthedocs.io
Converts the input clip to greyscale (no color), without changing the color format.
UK (Greyscale) and US (Grayscale) spellings are both allowed.
Greyscale(clip clip [, string matrix])
Grayscale(clip clip [, string matrix])
- string matrix = "Rec601"
- In RGB based formats, the conversion produces the luma using the coefficients given in the matrix parameter.
- "Rec601" : Use Rec.601 coefficients (and keeping luma range unchanged)
- "Rec709" : Use Rec.709 (HD) coefficients (and keeping luma range unchanged)
- "Rec2020" : Use Rec.2020 (UHD) coefficients (and keeping luma range unchanged) AVS+
- "AVERAGE" : Use averaged coefficients (Y = (R + G + B) / 3)
- In RGB based formats, the conversion produces the luma using the coefficients given in the matrix parameter.
If clip is YUV, the chroma channels are simply set to grey (128d) – matrix is not used and must not be specified otherwise an error will be thrown.
See Color conversions for an explanation of the coefficients. Broadly speaking though,
- using Rec709, green contributes more to the output, compared to the default Rec601;
- using Average, blue contributes more.
In all cases, Luma range is not changed (0d-255d in → 0d-255d out; 16d-235d in → 16d-235d out)
