Table of Contents

Enum GPUVideoEffectType

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

Defines the types of GPU-accelerated video effects available in the VisioForge framework.

public enum GPUVideoEffectType

Fields

Undefined = -1

Represents an undefined or uninitialized effect type.

This value is used as a default or error state. An effect with this type should not be processed by the video pipeline.

Greyscale = 0

Converts color video to grayscale by removing all color information.

The grayscale conversion uses standard luminance weights (0.299R + 0.587G + 0.114B) to create perceptually accurate monochromatic images that preserve brightness relationships.

Blur = 1

Applies a Gaussian blur filter to soften the video image.

This effect averages neighboring pixels using a Gaussian kernel, creating a smooth, out-of-focus appearance. Useful for backgrounds, privacy protection, or artistic effects. The blur intensity can be adjusted through the effect's Value property.

Invert = 2

Inverts all color values in the video to create a negative image effect.

Each pixel's RGB values are inverted (255 - original value), creating an effect similar to photographic negatives. White becomes black, red becomes cyan, etc.

OldMovie = 3

Simulates the appearance of old film footage with grain, scratches, and sepia toning.

This complex effect combines multiple techniques including noise generation, random scratches, vignetting, and color grading to recreate the nostalgic look of vintage cinema.

DirectionalBlur = 4

Applies motion blur in a specific direction to simulate movement or speed.

Unlike standard blur which is uniform in all directions, directional blur creates streaking effects along a specified angle. Commonly used to convey motion or create dynamic visual effects.

Monochrome = 5

Converts video to a two-color (typically black and white) image using threshold-based processing.

Different from grayscale, monochrome uses a threshold value to determine whether each pixel becomes pure black or pure white, creating high-contrast artistic effects or improving text readability.

Pixelate = 6

Creates a mosaic effect by reducing the resolution and displaying enlarged pixels.

This effect divides the image into blocks and fills each block with a single color, creating a blocky, pixelated appearance. Often used for censorship or retro gaming aesthetics.

Brightness = 7

Adjusts the overall luminance of the video by adding or subtracting brightness values.

Brightness adjustment uniformly increases or decreases the RGB values of all pixels, making the entire image lighter or darker. Values above 128 lighten, below 128 darken.

Contrast = 8

Adjusts the difference between light and dark areas to enhance or reduce image definition.

Contrast modification expands or compresses the tonal range around the midpoint, making lights lighter and darks darker (high contrast) or bringing all tones closer to middle gray (low contrast).

Saturation = 9

Controls the intensity of colors in the video from vibrant to completely desaturated.

Saturation adjustment modifies the purity of colors without affecting brightness. Zero saturation produces grayscale, while high saturation creates vivid, intense colors.

Darkness = 10

Applies a darkening effect to create moody or dramatic atmospheres.

Similar to brightness reduction but optimized for creating specific atmospheric effects, often preserving some highlight detail while deepening shadows and midtones.

Contour = 11

Detects and highlights edges in the video to create line-art style effects.

Uses edge detection algorithms (typically Sobel or similar) to identify areas of high contrast change, rendering them as lines while suppressing uniform areas.

DeinterlaceBlend = 12

Removes interlacing artifacts by blending alternating scan lines.

Designed for processing interlaced video content, this effect blends odd and even fields to eliminate comb-like artifacts that appear on moving objects in interlaced footage.

NightVision = 13

Simulates night vision or thermal imaging equipment appearance.

Creates a green-tinted, high-contrast effect similar to military night vision goggles, often including simulated noise and limited dynamic range for authenticity.

Sharpen = 14

Enhances image detail by amplifying high-frequency components.

Sharpening increases edge contrast to make details appear more defined. Uses convolution kernels to detect and enhance edges while preserving overall image structure.

Denoise = 15

Reduces video noise and grain while preserving important detail.

Applies spatial and/or temporal noise reduction algorithms to clean up grainy or noisy video, particularly useful for low-light footage or compressed sources.

Emboss = 16

Creates a 3D relief effect by highlighting edges with light and shadow.

Simulates the appearance of embossed or carved surfaces by applying directional edge detection and rendering the result as if lit from a specific angle.

EquiRectangular360 = 17

Converts equirectangular 360-degree video projection to standard flat view.

Transforms spherical 360° video content (typically in 2:1 aspect ratio) into a perspective-correct flat projection. This effect is automatically applied when 360° metadata is detected in the video file.

The transformation allows viewing specific portions of the 360° sphere on standard displays, with controls for pan, tilt, and field of view adjustment.

EquiAngularCubemap360 = 18

Converts equiangular cubemap 360-degree video projection to standard flat view.

Transforms cubemap-based 360° video content (six cube faces arranged in a specific layout) into a perspective-correct flat projection. This effect is automatically applied when cubemap 360° metadata is detected in the video file.

Cubemap format provides more uniform pixel distribution than equirectangular projection, resulting in better quality at the poles of the sphere.

Remarks

This enumeration represents all GPU-based video effects that can be applied to video streams. Each effect type corresponds to a specific GPU shader implementation that performs the video processing operation using hardware acceleration.

GPU effects provide superior performance compared to CPU-based effects, especially for high-resolution video processing, as they leverage parallel processing capabilities of modern graphics hardware.

Effects can be categorized into several groups:

  • Color adjustments: Brightness, Contrast, Saturation, Darkness
  • Blur effects: Blur, DirectionalBlur
  • Stylization: Greyscale, Monochrome, Invert, OldMovie, NightVision
  • Edge detection: Contour, Emboss
  • Enhancement: Sharpen, Denoise, DeinterlaceBlend
  • Special effects: Pixelate, EquiRectangular360, EquiAngularCubemap360