Avisynth wiki - User contributions [en]

DGHDRtoSDR

2020-11-12T14:08:37Z

Izuchi: update dates

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters|Deep_color_tools}}
{{Filter3
|{{Author/Donald Graft}}
|v1.14
|3=[http://rationalqm.us/hdr/DGHDRtoSDR_1.14.rar DGHDRtoSDR_1.14.rar]
|4=Adjustment Filters
|5=Closed source
|6=[https://forum.doom9.org/showthread.php?t=175624 Doom9 Forum]
}}
== Description ==
This AviSynth+/VapourSynth filter converts HDR10 PQ or HLG from UHD blurays to 8-bit SDR YV12 or 10-bit SDR stored in YUV420P16. The input must be YUV420P16, e.g., from DGSource() with a HDR10 source stream.

This filter runs on both CUDA and in software mode. If you try to run in CUDA mode without an nVidia card and driver installed, you will get an error. Use the parameter <code>impl="sw"</code> to run in software mode. 
 

== Requirements ==
* [[AviSynth+]] (x86 and x64)
* Supported color formats: [[YUV420P16]]
 

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

:{{Template:FuncDef|DGHDRtoSDR (clip, int "white", int "black", float "gamma", float "hue", float "r", float "g", float "b", float tm", float "roll", bool "fulldepth", string "impl", string "mode")}}
 
::{{Par2| |clip| }}
:::Input clip; must be [[YUV420P16]] colospace.
 
::{{Par2|white|int|400}}
:::This is an integer (with arbitrary scale) that controls the overall brightness of the output. Higher values increase the resulting output brightness.
:::For <code>mode="pq"</code>, the valid range for white is 1-2000. For <code>mode="hlg"</code>, the valid range is 1-10000.
 
::{{Par2|black|int|0}}
:::This is an integer (with arbitrary scale) that controls the black level of the output. Higher values increase the resulting black level.
:::This parameter is relevant only for <code>mode="hlg"</code>. The valid range is 0-1000.
 
::{{Par2|gamma|float|0.42}}
:::Final gamma for the output. The default is 0.42, standard for Rec.709.
 
::{{Par2|hue|float|0.0}}
:::Hue adjustment used to correct hue shift. Values above 0.0 shift toward red. Values below 0.0 shift toward green. The default value is 0.0.
 
::{{Par2|r|float|1.0}}
:::Saturation adjustment used to desaturate or resaturate red in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.0.
 
::{{Par2|g|float|1.0}}
:::Saturation adjustment used to desaturate or resaturate green in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.0.
 
::{{Par2|b|float|1.15}}
:::Saturation adjustment used to desaturate or resaturate blue in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.15.
 
::{{Par2|tm|float|0.9}}
:::Strength of tonemapping. Reduce this towards 0.0 to smoothly transition to blowout (clipping) of highlights.
:::This value controls a LERP between Reinhard tonemapping and no tonemapping. Default is 0.9.
 
::{{Par2|roll|float|}}
:::Rolloff strength of the tonemapping. Increase this towards 1.0 to soften and desaturate the result. The default value of 0.7 is effective at retaining saturation and contrast.
:::This parameter also affects overall brightness so you may have to adjust the light parameter as needed when changing the rolloff.
 
::{{Par2|fulldepth|bool|false}}
:::When set to false, 8-bit YV12 is output. When set to true, 10-bit stored in YUV420P16 is output.
:::Use <code>fulldepth=true</code> if you intend to a 10-bit encoding. The default is false.
 
::{{Par2|impl|string|"255"}}
:::*<code>impl="sw"</code> - Software mode (very slow).
:::*<code>impl="255"</code> - Use CUDA, device is chosen automatically.
:::*<code>impl="0"</code> - Use CUDA on device 0 (use desired device number).
 
::{{Par2|mode|string|"pq"}}
:::*<code>mode="pq"</code> - Source stream is HDR Perceptual Quantizer (PQ)
:::*<code>mode="hlg"</code> - Source stream is HDR Hybrid Log Gamma (HLG)
 

== Examples ==
Here is a typical AviSynth+ script:

<pre>
loadplugin("dgdecodenv.dll")
loadplugin("dghdrtosdr.dll")
DGSource("hdr_sample.dgi")
DGHDRtoSDR(mode="pq",white=400)
</pre>
 

== Cropping and Resizing ==

Often the goal is to convert to HD bluray with a size of 1920 x 1080.
And sometimes one wants to crop as well. The fastest way to do this is to
use DGSource() cropping and resizing. Following is a typical script:

<pre>
dgsource("hdr sample.dgi",crop_t=276,crop_b=276,resize_w=1920,resize_h=804)
dghdrtosdr(...)
</pre>

Alternatively, the cropping and resizing can be done in Avisynth. Do it before
calling dghdrtosdr() for best performance. Here is a script corresponding
to the one above:

<pre>
dgsource("hdr sample.dgi")
crop(0,276,-0,-276)
spline36resize(1920,804)
dghdrtosdr(...)
</pre>

== Changelog ==
Version Date Changes
v1.14 2020/08/10 - Make the PQ white parameter somewhat more relative (like HLG), so that the good values of the white parameter are not all bunched up at the very high end of the scale. Fixed a bug in HLG parameter checking for Avisynth.
v1.13 2019/09/22
 
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.13
|[http://rationalqm.us/hdr/DGHDRtoSDR_1.13.rar DGHDRtoSDR_1.13.rar]
|[https://web.archive.org/web/20200217162818/http://rationalqm.us/hdr/DGHDRtoSDR_1.13.rar DGHDRtoSDR_1.13.rar]
|}
 

==External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] ←'''

DGHDRtoSDR

2020-11-12T14:05:51Z

Izuchi: Update to version 1.14

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters|Deep_color_tools}}
{{Filter3
|{{Author/Donald Graft}}
|v1.14
|3=[http://rationalqm.us/hdr/DGHDRtoSDR_1.14.rar DGHDRtoSDR_1.14.rar]
|4=Adjustment Filters
|5=Closed source
|6=[https://forum.doom9.org/showthread.php?t=175624 Doom9 Forum]
}}
== Description ==
This AviSynth+/VapourSynth filter converts HDR10 PQ or HLG from UHD blurays to 8-bit SDR YV12 or 10-bit SDR stored in YUV420P16. The input must be YUV420P16, e.g., from DGSource() with a HDR10 source stream.

This filter runs on both CUDA and in software mode. If you try to run in CUDA mode without an nVidia card and driver installed, you will get an error. Use the parameter <code>impl="sw"</code> to run in software mode. 
 

== Requirements ==
* [[AviSynth+]] (x86 and x64)
* Supported color formats: [[YUV420P16]]
 

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

:{{Template:FuncDef|DGHDRtoSDR (clip, int "white", int "black", float "gamma", float "hue", float "r", float "g", float "b", float tm", float "roll", bool "fulldepth", string "impl", string "mode")}}
 
::{{Par2| |clip| }}
:::Input clip; must be [[YUV420P16]] colospace.
 
::{{Par2|white|int|400}}
:::This is an integer (with arbitrary scale) that controls the overall brightness of the output. Higher values increase the resulting output brightness.
:::For <code>mode="pq"</code>, the valid range for white is 1-2000. For <code>mode="hlg"</code>, the valid range is 1-10000.
 
::{{Par2|black|int|0}}
:::This is an integer (with arbitrary scale) that controls the black level of the output. Higher values increase the resulting black level.
:::This parameter is relevant only for <code>mode="hlg"</code>. The valid range is 0-1000.
 
::{{Par2|gamma|float|0.42}}
:::Final gamma for the output. The default is 0.42, standard for Rec.709.
 
::{{Par2|hue|float|0.0}}
:::Hue adjustment used to correct hue shift. Values above 0.0 shift toward red. Values below 0.0 shift toward green. The default value is 0.0.
 
::{{Par2|r|float|1.0}}
:::Saturation adjustment used to desaturate or resaturate red in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.0.
 
::{{Par2|g|float|1.0}}
:::Saturation adjustment used to desaturate or resaturate green in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.0.
 
::{{Par2|b|float|1.15}}
:::Saturation adjustment used to desaturate or resaturate blue in the output. Do not overdo it; 0.5 to 1.5 is probably the most you can get away with without ruining colors.
:::Values below 1.0 reduce saturation and values above 1.0 increase saturation. The default is 1.15.
 
::{{Par2|tm|float|0.9}}
:::Strength of tonemapping. Reduce this towards 0.0 to smoothly transition to blowout (clipping) of highlights.
:::This value controls a LERP between Reinhard tonemapping and no tonemapping. Default is 0.9.
 
::{{Par2|roll|float|}}
:::Rolloff strength of the tonemapping. Increase this towards 1.0 to soften and desaturate the result. The default value of 0.7 is effective at retaining saturation and contrast.
:::This parameter also affects overall brightness so you may have to adjust the light parameter as needed when changing the rolloff.
 
::{{Par2|fulldepth|bool|false}}
:::When set to false, 8-bit YV12 is output. When set to true, 10-bit stored in YUV420P16 is output.
:::Use <code>fulldepth=true</code> if you intend to a 10-bit encoding. The default is false.
 
::{{Par2|impl|string|"255"}}
:::*<code>impl="sw"</code> - Software mode (very slow).
:::*<code>impl="255"</code> - Use CUDA, device is chosen automatically.
:::*<code>impl="0"</code> - Use CUDA on device 0 (use desired device number).
 
::{{Par2|mode|string|"pq"}}
:::*<code>mode="pq"</code> - Source stream is HDR Perceptual Quantizer (PQ)
:::*<code>mode="hlg"</code> - Source stream is HDR Hybrid Log Gamma (HLG)
 

== Examples ==
Here is a typical AviSynth+ script:

<pre>
loadplugin("dgdecodenv.dll")
loadplugin("dghdrtosdr.dll")
DGSource("hdr_sample.dgi")
DGHDRtoSDR(mode="pq",white=400)
</pre>
 

== Cropping and Resizing ==

Often the goal is to convert to HD bluray with a size of 1920 x 1080.
And sometimes one wants to crop as well. The fastest way to do this is to
use DGSource() cropping and resizing. Following is a typical script:

<pre>
dgsource("hdr sample.dgi",crop_t=276,crop_b=276,resize_w=1920,resize_h=804)
dghdrtosdr(...)
</pre>

Alternatively, the cropping and resizing can be done in Avisynth. Do it before
calling dghdrtosdr() for best performance. Here is a script corresponding
to the one above:

<pre>
dgsource("hdr sample.dgi")
crop(0,276,-0,-276)
spline36resize(1920,804)
dghdrtosdr(...)
</pre>

== Changelog ==
Version Date Changes
v1.14 2019/09/22 - Make the PQ white parameter somewhat more relative (like HLG), so that the good values of the white parameter are not all bunched up at the very high end of the scale. Fixed a bug in HLG parameter checking for Avisynth.
v1.13 2019/09/22
 
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.13
|[http://rationalqm.us/hdr/DGHDRtoSDR_1.13.rar DGHDRtoSDR_1.13.rar]
|[https://web.archive.org/web/20200217162818/http://rationalqm.us/hdr/DGHDRtoSDR_1.13.rar DGHDRtoSDR_1.13.rar]
|}
 

==External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] ←'''