DGCube - Revision history

FranceBB: /* Examples */

2023-06-13T14:55:44Z

Examples

← Older revision		Revision as of 16:55, 13 June 2023
Line 58:		Line 58:
	DGSource("THE GREAT WALL.dgi")<br>		DGSource("THE GREAT WALL.dgi")<br>
	# From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range		# 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]		# 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		# 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>		<br>

Reel.Deal: fix examples

2022-08-21T16:17:19Z

fix examples

← Older revision		Revision as of 18:17, 21 August 2022
Line 62:		Line 62:
	DGCube("PQ_to_BT709_v1.cube", expand_in=false, compress_out=false, 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		# 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>		<br>

Line 88:		Line 88:
	\|-		\|-
	!2022/08/20		!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]
	\|		\|
	\|-		\|-

Reel.Deal: /* Changelog */

2022-08-20T19:17:11Z

Changelog

← Older revision		Revision as of 21:17, 20 August 2022
Line 68:		Line 68:
	Version Date Changes		Version Date Changes
	2022/08/20 - "full_range" parameter removed.		2022/08/20 - "full_range" parameter removed.
			- Faster cube loading.
	2022/08/19 - Added "expand_in" and "compress_out" parameters.		2022/08/19 - Added "expand_in" and "compress_out" parameters.
	- "full_range" parameter ignored.		- "full_range" parameter ignored.

Reel.Deal: version 2022/08/20

2022-08-20T14:52:25Z

version 2022/08/20

← Older revision		Revision as of 16:52, 20 August 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|{{Author/Donald Graft}}		\|{{Author/Donald Graft}}
	\|2022/08/19		\|2022/08/20
	\|3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]		\|3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
	\|4=Adjustment Filters		\|4=Adjustment Filters
Line 19:		Line 19:
	== [[Script variables\|Syntax and Parameters]] ==		== [[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>		<br>
	::{{Par2\| \|clip\| }}		::{{Par2\| \|clip\| }}
Line 26:		Line 26:
	::{{Par2\|cube\|string\|""}}		::{{Par2\|cube\|string\|""}}
	:::Full path of the 3D LUT file. This must be an Adobe *.cube file.		:::Full path of the 3D LUT file. This must be an Adobe *.cube file.
	~~<br>~~
	~~::{{Par2\|fullrange\|bool\|true}}~~
	~~:::This parameter is ignored.~~
	~~:::*false : limited range~~
	~~:::*true : full range~~
	<br>		<br>
	::{{Par2\|expand_in\|bool\|false}}		::{{Par2\|expand_in\|bool\|false}}
Line 72:		Line 67:
	== Changelog ==		== Changelog ==
	Version Date Changes		Version Date Changes
			2022/08/20 - "full_range" parameter removed.
	2022/08/19 - Added "expand_in" and "compress_out" parameters.		2022/08/19 - Added "expand_in" and "compress_out" parameters.
	- "full_range" parameter ignored.		- "full_range" parameter ignored.
Line 90:		Line 86:
	!!width="150px"\| Mirror		!!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]
	\|		\|
	\|-		\|-

Reel.Deal: version 2022/08/19

2022-08-20T04:55:38Z

version 2022/08/19

← Older revision		Revision as of 06:55, 20 August 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|{{Author/Donald Graft}}		\|{{Author/Donald Graft}}
	\|2022/08/11		\|2022/08/19
	\|3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]		\|3=[https://rationalqm.us/misc/DGCube.zip DGCube.zip]
	\|4=Adjustment Filters		\|4=Adjustment Filters
Line 14:		Line 14:
	== Requirements ==		== Requirements ==
	* [[AviSynth+]] (x86 and x64)		* [[AviSynth+]] (x86 and x64)
	* Supported color formats: [[RGBP16]]		* Supported color formats: [[RGBP16]], [[YUV420P16]]
	<br>		<br>

	== [[Script variables\|Syntax and Parameters]] ==		== [[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>		<br>
	::{{Par2\| \|clip\| }}		::{{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>		<br>
	::{{Par2\|cube\|string\|""}}		::{{Par2\|cube\|string\|""}}
Line 28:		Line 28:
	<br>		<br>
	::{{Par2\|fullrange\|bool\|true}}		::{{Par2\|fullrange\|bool\|true}}
			:::This parameter is ignored.
	:::*false : limited range		:::*false : limited range
	:::*true : full range		:::*true : full range
			<br>
			::{{Par2\|expand_in\|bool\|false}}
			:::Expand the input from limited range to full range. Default is false.
			<br>
			::{{Par2\|compress_out\|bool\|false}}
			:::Compress the output from full range to limited range. Default is false.
	<br>		<br>
	::{{Par2\|interp\|string\|"tetrahedral"}}		::{{Par2\|interp\|string\|"tetrahedral"}}
Line 44:		Line 51:
	[[Convert\|ConvertToYUV420()]]		[[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>
			# Load and apply [https://github.com/FranceBB/LinearTransformation "PQ_to_BT709_slope" cube]. Input and output is Limited Range YUV420P16
			DGCube("PQ_to_BT709_v1.cube", expand_in=true, compress_out=true, interp="tetrahedral")<br>

			Apply 3D LUT to HDR10 PQ clip obtained from [[DGDecNV\|DGSource]] using external conversions to RGBP16:

	# Source		# Source
	DGSource("THE GREAT WALL.dgi")<br>		DGSource("THE GREAT WALL.dgi")<br>
	# From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range		# 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		# 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>		<br>

	== Changelog ==		== Changelog ==
	Version Date Changes		Version Date Changes
			2022/08/19 - Added "expand_in" and "compress_out" parameters.
			- "full_range" parameter ignored.
			2022/08/17 - Add support for YUV420P16.
	2022/08/11 - VapourSynth support.		2022/08/11 - VapourSynth support.
	- 'device' parameter to select GPU device.		- 'device' parameter to select GPU device.
Line 73:		Line 89:
	!!width="150px"\| Download		!!width="150px"\| Download
	!!width="150px"\| Mirror		!!width="150px"\| Mirror
			\|-
			!2022/08/19
			\|[https://web.archive.org/web/20220819191354if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
			\|
	\|-		\|-
	!2022/08/11		!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]		\|[https://web.archive.org/web/20220811180805if_/https://www.rationalqm.us/misc/DGCube.zip DGCube.zip]
			\|
	\|}		\|}
	<br>		<br>

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]] ←'''