Table of Contents

Class GPUVideoEffectMonoChrome

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

Represents a GPU-accelerated monochrome video effect that tints video frames with a single color while preserving luminance information.

public class GPUVideoEffectMonoChrome : GPUVideoEffect, IGPUVideoEffectMonoChrome, IGPUVideoEffect

Inheritance

Implements

Inherited Members

Remarks

The VisioForge.Core.Types.VideoEffects.GPUVideoEffectMonoChrome effect converts color video to a single-color tinted appearance, commonly referred to as monochrome or single-tone effect. Unlike grayscale which removes all color information, this effect preserves the luminance (brightness) values while applying a single color tint across the entire frame. This creates a stylized, artistic look similar to sepia-toned photographs or color-filtered cinematography.

SDK Availability

  • Video Capture SDK .Net: Yes
  • Video Edit SDK .Net: Yes
  • Media Player SDK .Net: Yes
  • Media Blocks SDK .Net: Yes

GPU Acceleration

This effect utilizes GPU shader processing for real-time performance with minimal CPU overhead. The monochrome tinting operation is performed entirely on the GPU, allowing for efficient processing of high-resolution video streams without impacting CPU resources. The effect applies a color transformation matrix that preserves luminance while replacing chrominance with the specified color value.

Technical Details

  • Converts RGB color space to luminance values
  • Applies specified color tint while maintaining brightness levels
  • Supports any RGB color value for tinting
  • Preserves contrast and detail through luminance preservation
  • Real-time processing with hardware acceleration
  • Can be combined with other GPU effects in the pipeline

Common Use Cases

  • Creating sepia-tone effects for vintage film aesthetics
  • Applying night vision green tint to security footage
  • Generating stylized color-graded content for artistic projects
  • Simulating infrared or thermal imaging effects
  • Creating cohesive color themes across video projects
  • Enhancing mood through single-color cinematography

Performance Characteristics

The monochrome effect is highly efficient due to its simple per-pixel color transformation. GPU processing enables real-time application at 4K resolution and beyond. The effect has negligible impact on frame rate and can be applied to multiple streams simultaneously. No CPU-side buffering or processing is required.

Color Selection Tips

  • Use warm browns (R:160, G:82, B:45) for sepia tone effects
  • Use green (R:0, G:255, B:0) for night vision appearance
  • Use blue (R:0, G:100, B:255) for cool cinematic looks
  • Use red (R:255, G:0, B:0) for infrared simulation effects
  • Experiment with subtle tints for color grading workflows

Related Effects

  • VisioForge.Core.Types.VideoEffects.GPUVideoEffectGrayscale: Removes all color information
  • VisioForge.Core.Types.VideoEffects.GPUVideoEffectNightVision: Specialized green-tinted effect with grain
  • VisioForge.Core.Types.VideoEffects.GPUVideoEffectOldMovie: Vintage film look with sepia undertones
  • VisioForge.Core.Types.VideoEffects.GPUVideoEffectSaturation: Controls color intensity

Constructors

GPUVideoEffectMonoChrome(bool, Color, string, TimeSpan, TimeSpan)

Initializes a new instance of the VisioForge.Core.Types.VideoEffects.GPUVideoEffectMonoChrome class with the specified tint color and timing parameters.

public GPUVideoEffectMonoChrome(bool enabled, Color value, string name = "Monochrome", TimeSpan startTime = default, TimeSpan stopTime = default)

Parameters

enabled bool

true to enable the monochrome effect immediately; false to create the effect in a disabled state. The effect can be enabled or disabled later using the VisioForge.Core.Types.VideoEffects.GPUVideoEffect.Enabled property.

value Color

The Color value to use for monochrome tinting. This color replaces the chrominance (color) information while preserving the luminance (brightness) of the original video. Common values include sepia brown (R:160, G:82, B:45), night vision green (R:0, G:255, B:0), or infrared red (R:255, G:0, B:0).

name string

A unique identifier for this effect instance. Defaults to "Monochrome". This name can be used to retrieve the effect interface from the effect collection for runtime control and modification. Use descriptive names when applying multiple instances of the same effect type (e.g., "SepiaIntro", "NightVisionOutro").

startTime TimeSpan

The time position in the video timeline when this effect should become active. Use Zero (the default) to apply the effect from the beginning of the video. This enables time-based effect control for creating dynamic visual transitions throughout the video duration.

stopTime TimeSpan

The time position in the video timeline when this effect should become inactive. Use Zero (the default) to apply the effect until the end of the video. When combined with startTime, this creates time-windowed effects that automatically activate and deactivate at specific timestamps.

Remarks

The monochrome effect converts color video to a single-color tinted appearance by preserving luminance values while replacing all chrominance with the specified color. The effect is applied using GPU shader processing for real-time performance. Time-based activation allows for creative control over when the monochrome look appears in your video, enabling seamless transitions between color and tinted footage.

Properties

Value

Gets or sets the filtering color used for monochrome tinting.

public Color Value { get; set; }

Property Value

Color

Remarks

The color transformation preserves the relative brightness of pixels while applying the tint. Darker areas in the original video remain darker, and brighter areas remain brighter, but all pixels take on the hue of the specified color. Alpha channel values are typically ignored.

Methods

GetEffectType()

Gets the specific GPU video effect type identifier for this monochrome effect.

public GPUVideoEffectType GetEffectType()

Returns

GPUVideoEffectType

Returns VisioForge.Core.Types.VideoEffects.GPUVideoEffectType.Monochrome, which uniquely identifies this effect as a monochrome tinting effect in the GPU video effects pipeline.

Remarks

This method is used internally by the video processing pipeline to identify and route effects to the appropriate GPU shader implementations. The effect type determines which shader program is executed and how effect parameters are mapped to shader uniforms.