Table of Contents

Class VideoEffectRed

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

Represents a color isolation effect that displays only the red channel while zeroing out green and blue channels.

public class VideoEffectRed : VideoEffect, IVideoEffectRed, IVideoEffect

Inheritance

Implements

Inherited Members

Remarks

SDK Availability: Video Capture SDK .NET, Video Edit SDK .NET, Media Player SDK .NET

Platforms: Windows only (DirectShow-based)

Rendering Backend: DirectShow filter

This effect isolates the red color channel by setting the red component to its original value while forcing both green and blue components to zero. The result is a monochromatic red-tinted image that shows only the red information present in the original video, with brightness variations representing different red intensity levels.

The red channel isolation effect is commonly used for:

  • Color Analysis: Visualizing red channel data for debugging or scientific analysis
  • Artistic Monochrome: Creating dramatic red-only stylistic effects
  • Horror/Thriller Visuals: Red-tinted scenes for dramatic or sinister atmosphere
  • Alert/Warning Visuals: Red-only display for emergency or warning scenarios
  • Image Processing: Isolating red channel for computer vision or color keying workflows
  • Technical Testing: Verifying red channel levels in broadcast or encoding workflows

This is a CPU-based color transformation effect implemented as a DirectShow filter. The effect performs simple per-pixel channel manipulation by preserving red values (R) and setting green (G) and blue (B) to 0.

Performance: Lightweight CPU-based operation suitable for real-time processing. Minimal performance impact due to simple channel zeroing logic. Efficient for SD and HD resolutions.

Technical Details: For each pixel, the transformation is: RGB(R,G,B) → RGB(R,0,0). The red channel retains its full 8-bit range (0-255), while green and blue are always zero, resulting in shades from black (0,0,0) to pure red (255,0,0).

Related Effects: See also VisioForge.Core.Types.VideoEffects.VideoEffectGreen for green channel isolation, and the filter variants VisioForge.Core.Types.VideoEffects.VideoEffectFilterRed, VisioForge.Core.Types.VideoEffects.VideoEffectFilterGreen, VisioForge.Core.Types.VideoEffects.VideoEffectFilterBlue for threshold-based color filtering.

Constructors

VideoEffectRed(string, TimeSpan, TimeSpan, bool)

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

public VideoEffectRed(string name = "red", TimeSpan startTime = default, TimeSpan stopTime = default, bool enabled = true)

Parameters

name string

The unique name identifier for this effect instance. Used to retrieve the effect interface for runtime control. Defaults to "red".

startTime TimeSpan

The timecode when this effect should begin being applied. Use Zero to apply the effect from the start.

stopTime TimeSpan

The timecode when this effect should stop being applied. Use Zero to apply the effect until the end.

enabled bool

If set to true, the effect is enabled and will be applied during playback/processing. If false, the effect is bypassed.

Remarks

The red channel isolation effect has no configurable parameters beyond timing and enable state. The effect always sets green and blue to zero while preserving the red channel values.

Methods

GetEffectType()

Gets type.

public VideoEffectType GetEffectType()

Returns

VideoEffectType

The VisioForge.Core.Types.VideoEffects.VideoEffectType.