Table of Contents

Class VideoEffectLUT

Namespace
VisioForge.Core.Types.VideoEffects
Assembly
VisioForge.Core.dll

Represents a Look-Up Table (LUT) effect for professional color grading using 3D LUT files.

public class VideoEffectLUT : VideoEffect, IVideoEffectLUT, IVideoEffect

Inheritance

Implements

Inherited Members

Remarks

SDK Availability: Video Capture SDK .NET (Classic)

Platform: Windows only (DirectShow-based)

This classic effect applies color grading transformations using 3D Look-Up Tables (LUTs), a professional color grading technique used in film and video post-production. LUTs map input colors to output colors, enabling sophisticated color corrections, stylistic looks, and color space conversions with a single file.

The LUT effect supports standard LUT file formats:

  • .cube files: Industry-standard 3D LUT format
  • .3dl files: Autodesk/Lustre format
  • Other formats: Platform-specific LUT formats

The LUT effect is commonly used for:

  • Color Grading: Apply cinematic color looks and styles
  • Color Correction: Fix color balance and exposure issues
  • Film Emulation: Replicate analog film stock characteristics
  • Creative Looks: Apply stylized color palettes (vintage, bleach bypass, etc.)
  • Color Space Conversion: Transform between different color spaces (Rec.709, Log, etc.)
  • Camera Matching: Match colors between different camera sources

The VisioForge.Core.Types.VideoEffects.VideoEffectLUT.InterpolationMode controls how intermediate colors (not explicitly defined in the LUT) are calculated. Tetrahedral interpolation (default) provides the best balance of quality and performance for most applications.

This is a Windows-only DirectShow filter effect. For cross-platform LUT support, use VisioForge.Core.Types.X.VideoEffects.LUTVideoEffect from the Media Blocks SDK which supports multiple platforms and provides consistent LUT processing.

Performance: Real-time capable for standard resolution video. Performance depends on LUT size and interpolation method. Tetrahedral interpolation offers good quality with reasonable performance. Trilinear interpolation is faster but lower quality. 3D LUTs are cached in GPU/memory for efficient lookup.

LUT File Requirements: LUT files must be properly formatted and contain valid color mapping data. Ensure LUT dimensions match expected format (e.g., 33x33x33 is common). Test LUTs before production use to verify desired color output.

Constructors

VideoEffectLUT(bool, string, LUTInterpolationMode, string, TimeSpan, TimeSpan)

Initializes a new instance of the VisioForge.Core.Types.VideoEffects.VideoEffectLUT class.

public VideoEffectLUT(bool enabled, string filename, LUTInterpolationMode interpolationMode = LUTInterpolationMode.Nearest, string name = "LUT", TimeSpan startTime = default, TimeSpan stopTime = default)

Parameters

enabled bool

true to enable the effect immediately; false to add it disabled.

filename string

The full path to the LUT file (.cube, .3dl, or other supported format).

interpolationMode LUTInterpolationMode

The interpolation method for color lookups. Default is VisioForge.Core.Types.X.VideoEffects.LUTInterpolationMode.Tetrahedral.

name string

The unique name for this effect instance. Used to retrieve and control the effect at runtime. Defaults to "LUT".

startTime TimeSpan

The time when the effect should start being applied. Use default (TimeSpan.Zero) to apply from the beginning. Only applicable in Video Edit SDK scenarios with timeline-based effects.

stopTime TimeSpan

The time when the effect should stop being applied. Use default (TimeSpan.Zero) to apply until the end. Only applicable in Video Edit SDK scenarios with timeline-based effects.

Properties

Filename

Gets the path to the LUT file.

public string Filename { get; }

Property Value

string

Remarks

The LUT file contains the 3D color transformation table. Common formats include:

  • .cube - Adobe/Resolve format (most common)
  • .3dl - Autodesk/Lustre format
Ensure the file exists and is readable before applying the effect.

InterpolationMode

Gets the interpolation method used for color lookups.

public LUTInterpolationMode InterpolationMode { get; }

Property Value

LUTInterpolationMode

Remarks

Interpolation determines how colors between LUT grid points are calculated:

  • VisioForge.Core.Types.X.VideoEffects.LUTInterpolationMode.Tetrahedral: Best quality, good performance (default, recommended)
  • VisioForge.Core.Types.X.VideoEffects.LUTInterpolationMode.Trilinear: Faster but lower quality
  • VisioForge.Core.Types.X.VideoEffects.LUTInterpolationMode.Pyramid: Alternative interpolation method
Tetrahedral interpolation provides smooth gradients and accurate color reproduction for most applications.

Methods

GetEffectType()

Gets type.

public VideoEffectType GetEffectType()

Returns

VideoEffectType

The VisioForge.Core.Types.VideoEffects.VideoEffectType.