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, IVideoEffectInheritance
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
namestring-
The unique name identifier for this effect instance. Used to retrieve the effect interface for runtime control. Defaults to "red".
startTimeTimeSpan-
The timecode when this effect should begin being applied. Use Zero to apply the effect from the start.
stopTimeTimeSpan-
The timecode when this effect should stop being applied. Use Zero to apply the effect until the end.
enabledbool-
If set to
true, the effect is enabled and will be applied during playback/processing. Iffalse, 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.