Complete Video Effects Reference¶

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introduction¶

This document provides a comprehensive reference for all video effects available in VisioForge .NET SDKs. Effects are available in two distinct implementations:

Effect Types by SDK Engine¶

Classic Effects (Windows Only)¶

• Available in: VideoCaptureCore, MediaPlayerCore, VideoEditCore
• Platform: Windows only (.NET Framework 4.7.2+ and .NET 6-10)
• Types:
• VideoEffect* - CPU-based processing
• GPUVideoEffect* - GPU-accelerated (DirectX)
• Maxine* - NVIDIA AI-powered effects (RTX GPUs)
• Location: VisioForge.Core.Types.VideoEffects namespace

Cross-Platform Effects¶

• Available in: VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX, Media Blocks SDK
• Platform: Windows, Linux, macOS, Android, iOS
• Types:
• *VideoEffect classes in VisioForge.Core.Types.X.VideoEffects
• Cross-platform processing for universal compatibility
• Location: VisioForge.Core.Types.X.VideoEffects namespace

Important: When choosing effects, select based on your target SDK and platform requirements. Cross-platform effects provide broader compatibility, while Classic effects offer Windows-specific optimizations and DirectX GPU acceleration.

Effect Categories¶

The following sections list all available effects. Each effect includes SDK availability markers: - 🪟 Classic = VideoCaptureCore/MediaPlayerCore/VideoEditCore (Windows only) - 🌍 Cross-platform = VideoCaptureCoreX/MediaPlayerCoreX/VideoEditCoreX/Media Blocks (Cross-platform)

Color Adjustment Effects¶

Brightness and Darkness¶

Contrast and Color¶

Color Filters and Conversions¶

Grayscale and Monochrome¶

Color Inversion¶

Color Channel Filters¶

Color Grading¶

Image Enhancement¶

Sharpening and Blur¶

Noise Reduction¶

Geometric Transformations¶

Rotation and Flipping¶

Scaling and Transformation¶

Artistic and Stylistic Effects¶

Classic Film Effects¶

Edge and Texture Effects¶

Special Distortion Effects (Cross-platform only)¶

The following artistic effects are available exclusively in the cross-platform implementation:

Special Effects¶

Deinterlacing¶

Transition Effects¶

Overlays and Graphics¶

Text Overlays¶

See: Text Overlay Guide

Image Overlays¶

See: Image Overlay Guide

Advanced Overlay Features (Cross-platform only)¶

Chroma Key (Cross-platform)¶

360° Video and VR (Classic only)¶

AI-Powered Effects (NVIDIA Maxine - Classic only)¶

Requires NVIDIA RTX GPU with Maxine SDK support.

Video Enhancement¶

Content Effects¶

Special Effects¶

• VideoEffectColorNoise - Adds random color noise for grain or interference effects.
• VideoEffectMonoNoise - Adds monochrome (grayscale) noise.
• VideoEffectSpray - Spray paint or pointillist effect.
• VideoEffectShakeDown - Vertical shake effect for impact or earthquake simulation.

Deinterlacing¶

• VideoEffectDeinterlaceBlend / GPUVideoEffectDeinterlaceBlend - Blends interlaced fields for progressive output.
• VideoEffectDeinterlaceCAVT - Content Adaptive Vertical Temporal deinterlacing.
• VideoEffectDeinterlaceTriangle - Triangle interpolation deinterlacing method.

Transition Effects¶

Fade Effects¶

• VideoEffectFadeIn - Gradual fade from black to video content.
• VideoEffectFadeOut - Gradual fade from video content to black.

Overlays and Graphics¶

Text Overlays¶

• VideoEffectTextLogo - Flexible text overlay with extensive customization including fonts, colors, rotation, effects, and animated text.
• VideoEffectScrollingTextLogo - Scrolling text banner with direction and speed control.

See: Text Overlay Guide

Image Overlays¶

• VideoEffectImageLogo - Image overlay supporting PNG, JPG, BMP, animated GIF, with transparency and positioning control.

See: Image Overlay Guide

360° Video and VR¶

• GPUVideoEffectEquirectangular360 - Processes equirectangular 360° video format.
• GPUVideoEffectEquiangularCubemap360 - Converts between equiangular and cubemap projections for 360° video.
• GPUVideoEffectVR360Base - Base class for VR 360° video effects.

AI-Powered Effects (NVIDIA Maxine)¶

Requires NVIDIA RTX GPU with Maxine SDK support.

Video Enhancement¶

• MaxineDenoiseVideoEffect - AI-powered noise reduction that intelligently preserves details.
• MaxineArtifactReductionVideoEffect - Reduces compression artifacts and video degradation using AI.
• MaxineSuperResSettings - Settings POCO for AI super-resolution upscaling.

Content Effects¶

• MaxineAIGSVideoEffect - AI-powered green screen/background removal without requiring actual green screen.
• MaxineUpscaleSettings - Settings POCO for AI upscaling.

Effect Parameters¶

Common Parameters¶

All video effects support these standard parameters:

• Enabled - Whether the effect is active (can be toggled on/off)
• Name - Identifier for retrieving specific effect instances
• StartTime - When effect begins (TimeSpan.Zero = from start)
• StopTime - When effect ends (TimeSpan.Zero = until end)

Classic Effects Value Ranges¶

Most Classic adjustment effects use 0-255 value ranges where: - 128 typically represents neutral/no change - 0 represents minimum (often darkest/weakest) - 255 represents maximum (often brightest/strongest)

Animated Transitions (Classic Effects)¶

Many Classic effects support ValueStop parameter for smooth animation: - Set Value for starting value - Set ValueStop for ending value - Define StartTime and StopTime for animation duration

Cross-platform Effects Parameters¶

Cross-platform effects use multimedia element properties with varying ranges. Refer to individual effect documentation for specific parameter details.

SDK Comparison¶

Classic Effects (VideoCaptureCore/MediaPlayerCore)¶

• Platform: Windows only (.NET Framework 4.7.2+ and .NET 6-10)
• Processing Types:
• CPU-based: VideoEffect* classes
• GPU-accelerated: GPUVideoEffect* classes (DirectX)
• AI-powered: Maxine* classes (NVIDIA RTX required)
• Performance: Optimized for Windows, DirectX GPU acceleration
• Compatibility: Desktop Windows only
• Namespace: VisioForge.Core.Types.VideoEffects

Cross-platform Effects (VideoCaptureCoreX/Media Blocks)¶

• Platform: Cross-platform (Windows, Linux, macOS, Android, iOS)
• Processing: Cross-platform, hardware acceleration through multimedia plugins
• Performance: Good performance on all platforms, GPU acceleration varies by platform
• Compatibility: Universal - desktop and mobile
• Namespace: VisioForge.Core.Types.X.VideoEffects
• Additional Features:
• More artistic effects (distortions, warps)
• Advanced overlay system (OverlayManager)
• Chroma key / motion detection
• Better suited for mobile platforms

Usage Examples¶

Classic Effect Application¶

// CPU-based effect
var effect = new VideoEffectGrayscale(
    enabled: true,
    name: "BWEffect"
);
capture.Video_Effects_Add(effect);

// GPU-accelerated effect
var gpuEffect = new GPUVideoEffectBrightness(
    enabled: true,
    value: 180,
    name: "Brighten"
);
capture.Video_Effects_Add(gpuEffect);

Cross-platform Effect Application¶

// Cross-platform grayscale
var grayscale = new GrayscaleVideoEffect("bw_effect");
await videoCapture.Video_Effects_AddOrUpdateAsync(grayscale);

// Cross-platform text overlay
var textOverlay = new TextOverlayVideoEffect
{
    Text = "Hello World",
    Font = new FontSettings("Arial", "Bold", 24),
    Color = SKColors.Yellow,
    HorizontalAlignment = TextOverlayHAlign.Left,
    VerticalAlignment = TextOverlayVAlign.Top
};
await videoCapture.Video_Effects_AddOrUpdateAsync(textOverlay);

Animated Effect (Classic)¶

// Fade to black over 3 seconds
var fade = new VideoEffectDarkness(
    enabled: true,
    value: 128,        // Start normal
    valueStop: 255,    // End at maximum darkness
    name: "FadeOut",
    startTime: TimeSpan.FromSeconds(57),
    stopTime: TimeSpan.FromSeconds(60)
);
capture.Video_Effects_Add(fade);

Time-Limited Effect (Both)¶

// Classic: Apply effect only during specific time range
var flashback = new VideoEffectGrayscale(
    enabled: true,
    name: "Flashback",
    startTime: TimeSpan.FromMinutes(2),
    stopTime: TimeSpan.FromMinutes(2.5)
);
player.Video_Effects_Add(flashback);

// Cross-platform: Time-limited effect
// Ctor: GaussianBlurVideoEffect(double sigma, string name = "gaussian_blur")
var blur = new GaussianBlurVideoEffect(5.0, "blur")
{
    StartTime = TimeSpan.FromSeconds(10),
    StopTime = TimeSpan.FromSeconds(15)
};
await player.Video_Effects_AddOrUpdateAsync(blur);

Performance Considerations¶

Classic Effects¶

1. GPU Effects: Best performance for high-resolution video on Windows
2. Effect Stacking: Minimize simultaneous effects for better performance
3. Animated Effects: Smooth animations add minimal overhead
4. AI Effects: Most resource-intensive, use on RTX GPUs
5. Resolution Impact: Higher resolutions significantly increase processing requirements

Cross-platform Effects¶

1. Hardware Acceleration: Varies by platform and multimedia framework build
2. Cross-Platform: Generally good performance on all supported platforms
3. Mobile Optimization: Better suited for mobile than Classic effects
4. Overlay System: Efficient multi-overlay rendering
5. Plugin Availability: Some effects require specific multimedia plugins

Platform Availability¶

Classic Effects¶

Cross-platform Effects¶

Choosing the Right Effect Type¶

Use Classic Effects When:¶

• ✅ Targeting Windows desktop only
• ✅ Need maximum performance on Windows
• ✅ Using DirectX GPU acceleration
• ✅ Need NVIDIA Maxine AI features
• ✅ Working with VideoCaptureCore/MediaPlayerCore engines

Use Cross-platform Effects When:¶

• ✅ Need cross-platform support
• ✅ Targeting mobile platforms (Android/iOS)
• ✅ Targeting Linux or macOS
• ✅ Using VideoCaptureCoreX/Media Blocks
• ✅ Need advanced overlay features
• ✅ Need chroma key or motion detection

Additional Resources¶

• Text Overlay Guide
• Image Overlay Guide
• Video Sample Grabber
• How to Add Effects

Visit our GitHub repository for complete code samples and implementation examples.