DGCube

Revision as of 06:55, 20 August 2022

Description

AviSynth+ plugin to load and apply Adobe 3D LUTs to a clip. DGCube is a CUDA version of the AVSCube filter.

Requirements

• AviSynth+ (x86 and x64)
• Supported color formats: RGBP16, YUV420P16

Syntax and Parameters

DGCube (clip, string "cube", bool "fullrange", bool "expand_in", bool "compress_out", string "interp", int "device")

clip   =

Input clip; the filter receives and delivers either RGBP16 or YUV420P16 color space.

string  cube = ""

Full path of the 3D LUT file. This must be an Adobe *.cube file.

bool  fullrange = true

This parameter is ignored.

• false : limited range
• true : full range

bool  expand_in = false

Expand the input from limited range to full range. Default is false.

bool  compress_out = false

Compress the output from full range to limited range. Default is false.

string  interp = "tetrahedral"

String specifying the interpolation method: "tetrahedral" (default) or "trilinear".

int  device = 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")
ConvertToYUV420()

Apply 3D LUT to HDR10 PQ clip obtained from DGSource using internal YUV<->RGB conversions:

# Source
DGSource("THE GREAT WALL.dgi")

# Load and apply "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")

Apply 3D LUT to HDR10 PQ clip obtained from DGSource using external conversions to RGBP16:

# Source
DGSource("THE GREAT WALL.dgi")

# From 4:2:0 10bit planar Limited Range to RGB Planar 16bit Full Range
z_ConvertFormat(pixel_type="RGBP16", colorspace_op="2020:st2084:2020:limited=>rgb:st2084:2020:full", dither_type="error_diffusion")

# Load and apply "PQ_to_BT709_slope" cube
DGCube("PQ_to_BT709_v1.cube", expand_in=false, compress_out=false, interp="tetrahedral")

# From RGB 16bit planar Full Range to YUV420 10bit planar Limited Range with dithering
z_ConvertFormat(pixel_type="YUV420P10", colorspace_op="rgb:std-b67:2020:full=>2020:std-b67:2020:limited", dither_type="error_diffusion")

Changelog

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.
                                - '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

External Links

• Doom9 Forum - FranceBB LUT Collection
• GitHub - ColorMatch3D - tool that creates a .cube 3D LUT that matches colors of a reference image with a different grading. Discussion thread
• 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. Discussion thread, original discussion thread

Back to External Filters ←