Table of Contents

Enum MaxineAIGSEffectMode

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

Specifies the output mode for NVIDIA Maxine AI Green Screen (AIGS) effect.

public enum MaxineAIGSEffectMode

Fields

Matte = 0

Outputs the alpha matte (segmentation mask) showing the person segmentation.

In this mode, the effect outputs a grayscale alpha matte where white pixels represent the foreground person(s) and black pixels represent the background. Gray values along edges represent partial transparency for smooth compositing. This matte can be used for further custom processing or compositing in video editing workflows.

The matte represents the AI model's confidence in person segmentation, with anti-aliased edges for professional-quality keying results.

Green = 1

Replaces the background with a solid green color (#00FF00).

Creates a traditional green screen effect without requiring a physical green backdrop. The AI-segmented background is replaced with pure green, allowing the output to be used with standard chroma key tools in video editing software. This is useful for integrating AI-based segmentation into traditional green screen workflows.

The green color (#00FF00) is chosen for maximum compatibility with standard chroma key tools and to avoid conflicts with typical skin tones and clothing colors.

White = 2

Replaces the background with a solid white color (#FFFFFF).

Replaces the AI-segmented background with pure white. Useful for creating clean, professional-looking video presentations, corporate communications, or any scenario where a neutral white background is desired. This mode can also be used to create a high-key lighting effect or for further processing where a white background provides better contrast.

None = 3

Outputs the segmented video without additional background processing.

This mode performs person segmentation but does not apply any background replacement or effects. The original background is preserved. This can be useful for testing the segmentation quality or as a preprocessing step for custom background processing.

Background = 4

Replaces the background with a custom image specified by VisioForge.Core.Types.VideoEffects.MaxineAIGSVideoEffect.BackgroundImage.

The AI-segmented background is replaced with a custom image loaded from disk. The image is automatically scaled to match the video resolution and composited behind the foreground person(s). This mode enables virtual backgrounds for video conferencing, creative video production, or any scenario where a custom backdrop is needed.

The background image should be specified via the VisioForge.Core.Types.VideoEffects.MaxineAIGSVideoEffect.BackgroundImage property. Supported formats include PNG, JPEG, BMP, and other common image formats. For best results, use images with aspect ratios similar to your video or images that look good when stretched or cropped.

Blur = 5

Applies Gaussian blur to the background while keeping the foreground person(s) sharp.

Creates a depth-of-field effect by applying Gaussian blur to the AI-segmented background while preserving the sharpness of the foreground person(s). The blur strength can be controlled via the VisioForge.Core.Types.VideoEffects.MaxineAIGSVideoEffect.BlurStrength property (0.0 to 1.0).

This mode is popular for:

  • Video conferencing (reduces background distractions)
  • Privacy protection (obscures background details)
  • Professional appearance (mimics DSLR depth-of-field)
  • Focus enhancement (draws viewer attention to the subject)

The blur is applied smoothly across the background with anti-aliased edges at the person boundary to prevent visible halos or artifacts.

Remarks

These modes determine how the AI-segmented foreground and background are processed and composited to produce the final output. The AI performs real-time person segmentation without requiring a physical green screen, and these modes control what happens to the segmented background region.