DGCube - Revision history

FranceBB: /* Examples */

2023-06-13T14:55:44Z

‎Examples

Reel.Deal: fix examples

2022-08-21T16:17:19Z

fix examples

Reel.Deal: /* Changelog */

2022-08-20T19:17:11Z

‎Changelog

Reel.Deal: version 2022/08/20

2022-08-20T14:52:25Z

version 2022/08/20

Reel.Deal: version 2022/08/19

2022-08-20T04:55:38Z

version 2022/08/19

Reel.Deal: DGCube (2022/08/11)

2022-08-11T18:53:34Z

DGCube (2022/08/11)

New page

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters|Deep_color_tools}}
{{Filter3
|{{Author/Donald Graft}}
|2022/08/11
|3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
|4=Adjustment Filters
|5=Closed source
|6=[https://www.rationalqm.us/board/viewtopic.php?f=14&t=1180 DG Tools Support Forum]
}}
== Description ==
[[AviSynth+]] plugin to load and apply Adobe [https://en.wikipedia.org/wiki/3D_lookup_table 3D LUTs] to a clip. [[DGCube]] is a [https://en.wikipedia.org/wiki/CUDA CUDA] version of the [[AVSCube]] filter. 
 

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

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

:{{Template:FuncDef|DGCube (clip, string "cube", bool "fullrange", string "interp", int "device")}}
 
::{{Par2| |clip| }}
:::Input clip; the filter receives and delivers the RGBP16 color space.
 
::{{Par2|cube|string|""}}
:::Full path of the 3D LUT file. This must be an Adobe *.cube file.
 
::{{Par2|fullrange|bool|true}}
:::*false : limited range
:::*true : full range
 
::{{Par2|interp|string|"tetrahedral"}}
:::String specifying the interpolation method: "tetrahedral" (default) or "trilinear".
 
::{{Par2|device|int|255}}
:::GPU device number to use. If device is 255 (default), then the GPU device will be automatically selected.
 

== Examples ==
Apply 3D LUT to clip obtained from BlankClip:
[[BlankClip]](pixel_type="RGBP16", color=$ff0000)
DGCube("...\test.cube")
[[Convert|ConvertToYUV420()]]

Apply 3D LUT to HDR10 PQ clip obtained from [[DGDecNV|DGSource]]:

# Source
DGSource("THE GREAT WALL.dgi") 
# From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range
[[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", resample_filter_uv="spline64", dither_type="error_diffusion") 
#Load and apply cube
DGCube("PQ_to_BT709_slope.cube", fullrange=true, interp="tetrahedral") 
# From RGB 16bit planar Full Range to YUV420 10bit planar Limited Range with dithering
[[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:std-b67:2020:full=>2020:std-b67:2020:limited", resample_filter_uv="spline64", dither_type="error_diffusion")

 

== Changelog ==
Version Date Changes
2022/08/11 - VapourSynth support.
- 'device' parameter to select GPU device.
- Updated user manual.
2022/08/10 - Added tetrahedral interpolation.
2022/08/08 - Ability to open any size cube file, no longer limited to 65.
2022/08/07 - Initial release
 

== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!2022/08/11
|[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
|[https://web.archive.org/web/20220811180805if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
|}
 

==External Links ==
*[https://forum.doom9.org/showthread.php?t=176091 Doom9 Forum] - FranceBB LUT Collection
*[https://github.com/TomArrow/ColorMatch3D/releases GitHub] - ColorMatch3D - tool that creates a .cube 3D LUT that matches colors of a reference image with a different grading. [https://forum.fanres.com/thread-3609.html Discussion thread]
*[https://github.com/wswartzendruber/hlg-tools GitHub] - hlg-tools - this tool suite consists of the basics needed to generate 3D LUTs that will convert video streams from Perceptual Quantizer (PQ) HDR into Hybrid-Log Gamma (HLG) HDR. [https://forum.doom9.org/showthread.php?t=182499 Discussion thread], [https://forum.doom9.org/showthread.php?t=181282 original discussion thread]
 
 
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] ←'''

@@ Line 58: / Line 58: @@
   DGSource("THE GREAT WALL.dgi")<br>
   # From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range
-  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", dither_type="error_diffusion")<br>
+  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", resample_filter_uv="Spline64", dither_type="error_diffusion", use_props=0)<br>
   # Load and apply [https://github.com/FranceBB/LinearTransformation "PQ_to_BT709_slope" cube]
-  DGCube("PQ_to_BT709_v1.cube", expand_in=false, compress_out=false, interp="tetrahedral")<br>
+  DGCube("PQ_to_BT709_v1.cube", in="full", out="full", lut="full", interp="tetrahedral")<br>
   # From RGB 16bit planar Full Range to YUV420 10bit planar Limited Range with dithering
-  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:709:709:full=>709:709:709:limited", dither_type="error_diffusion")
+  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:709:709:full=>709:709:709:limited", resample_filter_uv="Spline64", dither_type="error_diffusion", use_props=0)
 <br>

@@ Line 62: / Line 62: @@
   DGCube("PQ_to_BT709_v1.cube", expand_in=false, compress_out=false, interp="tetrahedral")<br>
   # From RGB 16bit planar Full Range to YUV420 10bit planar Limited Range with dithering
-  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:std-b67:2020:full=>2020:std-b67:2020:limited", dither_type="error_diffusion")
+  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:709:709:full=>709:709:709:limited", dither_type="error_diffusion")
 <br>
@@ Line 88: / Line 88: @@
 |-
 !2022/08/20
-|[https://web.archive.org/web/20220820145007if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
+|[https://web.archive.org/web/20220821161252if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
+|
 |-

@@ Line 68: / Line 68: @@
   Version         Date            Changes
 /08/20      - "full_range" parameter removed.
 /08/19      - Added "expand_in" and "compress_out" parameters.
                                   - "full_range" parameter ignored.

@@ Line 2: / Line 2: @@
 {{Filter3
 |{{Author/Donald Graft}}
-|2022/08/19
+|2022/08/20
 |3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
 |4=Adjustment Filters
@@ Line 19: / Line 19: @@
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|DGCube (clip, string "cube", bool "fullrange", bool "expand_in", bool "compress_out", string "interp", int "device")}}
+:{{Template:FuncDef|DGCube (clip, string "cube", bool "expand_in", bool "compress_out", string "interp", int "device")}}
 <br>
 ::{{Par2| |clip| }}
@@ Line 26: / Line 26: @@
 ::{{Par2|cube|string|""}}
 :::Full path of the 3D LUT file. This must be an Adobe *.cube file.
 <br>
 ::{{Par2|expand_in|bool|false}}
@@ Line 72: / Line 67: @@
 == Changelog ==
   Version         Date            Changes
 /08/19      - Added "expand_in" and "compress_out" parameters.
                                   - "full_range" parameter ignored.
@@ Line 90: / Line 86: @@
 !!width="150px"| Mirror
 |-
-!2022/08/19
+!2022/08/20
-|[https://web.archive.org/web/20220819191354if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
+|[https://web.archive.org/web/20220820145007if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
+|
 |-

@@ Line 2: / Line 2: @@
 {{Filter3
 |{{Author/Donald Graft}}
-|2022/08/11
+|2022/08/19
 |3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
 |4=Adjustment Filters
@@ Line 14: / Line 14: @@
 == Requirements ==
 * [[AviSynth+]] (x86 and x64)
-* Supported color formats: [[RGBP16]]
+* Supported color formats: [[RGBP16]], [[YUV420P16]]
 <br>
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|DGCube (clip, string "cube", bool "fullrange", string "interp", int "device")}}
+:{{Template:FuncDef|DGCube (clip, string "cube", bool "fullrange", bool "expand_in", bool "compress_out", string "interp", int "device")}}
 <br>
 ::{{Par2| |clip| }}
-:::Input clip; the filter receives and delivers the RGBP16 color space.
+:::Input clip; the filter receives and delivers either RGBP16 or YUV420P16 color space.
 <br>
 ::{{Par2|cube|string|""}}
@@ Line 28: / Line 28: @@
 <br>
 ::{{Par2|fullrange|bool|true}}
 :::*false : limited range
 :::*true : full range
 <br>
 ::{{Par2|interp|string|"tetrahedral"}}
@@ Line 44: / Line 51: @@
   [[Convert|ConvertToYUV420()]]
-Apply 3D LUT to HDR10 PQ clip obtained from [[DGDecNV|DGSource]]:
+Apply 3D LUT to HDR10 PQ clip obtained from [[DGDecNV|DGSource]] using internal YUV<->RGB conversions:
   # Source
   DGSource("THE GREAT WALL.dgi")<br>
   # From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range
-  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", resample_filter_uv="spline64", dither_type="error_diffusion")<br>
+  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", dither_type="error_diffusion")<br>
-  #Load and apply cube
+  # Load and apply [https://github.com/FranceBB/LinearTransformation "PQ_to_BT709_slope" cube]
-  DGCube("PQ_to_BT709_slope.cube", fullrange=true, interp="tetrahedral")<br>
+  DGCube("PQ_to_BT709_v1.cube", expand_in=false, compress_out=false, interp="tetrahedral")<br>
   # From RGB 16bit planar Full Range to YUV420 10bit planar Limited Range with dithering
-  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:std-b67:2020:full=>2020:std-b67:2020:limited", resample_filter_uv="spline64", dither_type="error_diffusion")
+  [[Avsresize#z_ConvertFormat|z_ConvertFormat]](pixel_type="YUV420P10", colorspace_op="rgb:std-b67:2020:full=>2020:std-b67:2020:limited", dither_type="error_diffusion")
-−
 <br>
 == Changelog ==
   Version         Date            Changes
 /08/11      - VapourSynth support.
                                   - 'device' parameter to select GPU device.
@@ Line 73: / Line 89: @@
 !!width="150px"| Download
 !!width="150px"| Mirror
 |-
 !2022/08/11
 |[https://web.archive.org/web/20220811180805if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
 |}
 <br>