Enum VideoRendererAdjustment

Namespace

VisioForge.Core.Types

Assembly

VisioForge.Core.dll

Specifies the types of visual adjustments that can be applied to a video renderer for real-time video processing.

[Flags]
public enum VideoRendererAdjustment

Fields

Brightness = 1

Adjusts the overall lightness or darkness of the video image.

Brightness controls the black level of the video, affecting all pixels equally. Increasing brightness makes the entire image lighter, while decreasing makes it darker.

Typical value ranges: - Minimum: -100 (darkest) - Default: 0 (no adjustment) - Maximum: 100 (brightest)

Excessive brightness can cause loss of detail in highlights (blown out whites), while too little brightness can crush shadow detail.

Contrast = 2

Adjusts the difference between the lightest and darkest areas of the video.

Contrast controls the range between black and white levels in the video. Higher contrast increases the difference between dark and light areas, while lower contrast reduces this difference, making the image appear flatter.

Typical value ranges: - Minimum: -100 (lowest contrast, gray appearance) - Default: 0 (no adjustment) - Maximum: 100 (highest contrast)

High contrast can create more dramatic images but may lose detail in shadows and highlights. Low contrast preserves detail but may appear washed out.

Hue = 4

Adjusts the tint or color balance of the video by rotating the color wheel.

Hue adjustment rotates all colors in the image around the color wheel. This can correct color casts or create artistic effects by shifting the entire color spectrum.

Typical value ranges: - Minimum: -180 degrees (shifts colors towards magenta/green) - Default: 0 (no adjustment) - Maximum: 180 degrees (shifts colors towards green/magenta)

Small adjustments (±15 degrees) are useful for color correction, while larger adjustments create dramatic color shifts for creative effects.

Saturation = 8

Adjusts the intensity or purity of colors in the video.

Saturation controls the vividness of colors, from grayscale (no saturation) to highly vivid colors (maximum saturation). It affects the color intensity without changing the hue or brightness.

Typical value ranges: - Minimum: -100 (complete desaturation, grayscale) - Default: 0 (no adjustment) - Maximum: 100 (maximum color intensity)

Reduced saturation can create a more muted, film-like appearance, while increased saturation creates more vibrant, eye-catching visuals. Over-saturation can cause color bleeding and loss of detail.

Remarks

This enumeration defines flags for various video adjustments that can be applied during playback or rendering. These adjustments modify the visual characteristics of video content without altering the source material, allowing users to enhance or correct video appearance in real-time.

The values are designed as bit flags, allowing multiple adjustments to be combined using bitwise OR operations. This enables applications to query or set multiple adjustment capabilities simultaneously.

Common use cases include: - Correcting poorly lit or washed-out video content - Enhancing video visibility in different viewing environments - Compensating for display characteristics - Creative color grading and stylization - Accessibility features for users with visual impairments