Table of Contents

Class VideoEffectMirrorVertical

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

Represents a vertical mirror effect that creates a symmetrical reflection of the video image along the horizontal axis.

public class VideoEffectMirrorVertical : VideoEffect, IVideoEffectMirrorVertical, IVideoEffect

Inheritance

Implements

Inherited Members

Remarks

SDK Availability: VideoCaptureCore, MediaPlayerCore, VideoEditCore (Windows only)

Platform Support: Windows only

The vertical mirror effect flips the video image from top to bottom, creating a mirror-like reflection along the horizontal center axis. Objects at the top of the frame appear at the bottom and vice versa, while the left-right orientation remains unchanged.

This effect is commonly used for:

  • Creating artistic symmetrical compositions with vertical reflection
  • Producing kaleidoscope-like visual effects and abstract patterns
  • Correcting video captured from vertically inverted camera setups
  • Generating creative transitions and visual effects in video editing
  • Creating water reflection effects and other artistic symmetries

The mirror operation is performed efficiently in real-time without quality degradation, as it involves only pixel reordering without any interpolation or resampling. This ensures perfect frame quality while maintaining high processing performance suitable for both live and recorded video.

For horizontal mirroring effects, see VisioForge.Core.Types.VideoEffects.VideoEffectMirrorHorizontal. For simple vertical flipping, consider VisioForge.Core.Types.VideoEffects.VideoEffectFlipVertical. Both mirror effects can be combined to create four-way symmetrical patterns.

Constructors

VideoEffectMirrorVertical(bool, string, TimeSpan, TimeSpan)

Initializes a new instance of the VisioForge.Core.Types.VideoEffects.VideoEffectMirrorVertical class with specified parameters.

public VideoEffectMirrorVertical(bool enabled, string name = "MirrorVertical", TimeSpan startTime = default, TimeSpan stopTime = default)

Parameters

enabled bool

true to enable the effect immediately; false to create the effect in a disabled state. The effect can be enabled later by setting the VisioForge.Core.Types.VideoEffects.VideoEffect.Enabled property.

name string

An optional name identifier for this effect instance. Default is "MirrorVertical". This name can be used to retrieve and control the effect through the video processing pipeline, which is particularly useful when managing multiple effects or creating complex effect chains.

startTime TimeSpan

The time at which the effect should start being applied. Default is zero (from beginning). Use Zero to apply the effect from the start of the video. Specify a positive time value to create timed transitions or apply the effect to specific scenes.

stopTime TimeSpan

The time at which the effect should stop being applied. Default is zero (until end). Use Zero to apply the effect until the end of the video. When both startTime and stopTime are zero, the effect applies continuously throughout the entire video duration.

Remarks

The vertical mirror effect requires no additional configuration parameters beyond the base effect properties. It automatically creates a perfect top-bottom reflection of the video content when enabled.

Time-based control enables creative applications such as:

  • Dynamic mirror transitions between normal and reflected video
  • Scene-specific artistic effects in video editing
  • Synchronized mirror effects with audio or visual cues
  • Creating water reflection simulations during specific scenes

Methods

GetEffectType()

Gets the specific type of this video effect.

public VideoEffectType GetEffectType()

Returns

VideoEffectType

Returns VisioForge.Core.Types.VideoEffects.VideoEffectType.MirrorVertical to identify this as a vertical mirror effect.

Remarks

This method is used by the video processing pipeline to route the effect to the appropriate vertical mirror processor. The effect type ensures the correct transformation algorithm is applied to create the top-bottom reflection.