Class VideoEffectFadeOut
- Namespace
- VisioForge.Core.Types.VideoEffects
- Assembly
- VisioForge.Core.dll
Represents a fade-out transition effect that gradually transitions from full video visibility to black.
public class VideoEffectFadeOut : VideoEffect, IVideoEffectFadeOut, IVideoEffectInheritance
Implements
Inherited Members
Remarks
The fade-out effect creates a smooth transition where the video content gradually becomes less visible, starting from full opacity and progressing to complete black (or transparency). The transition occurs over the time period defined by VisioForge.Core.Types.VideoEffects.VideoEffect.StartTime and VisioForge.Core.Types.VideoEffects.VideoEffect.StopTime.
Common applications:
- Video ending sequences
- Scene transitions to black
- Concealing content gradually
- Professional video outros
- Soft exit from scenes or chapters
- Commercial break transitions
The fade-out effect is typically applied at the end of a video or before scene transitions. The duration of the fade is controlled by the difference between StartTime and StopTime.
For opposite effect (fading from black), use VisioForge.Core.Types.VideoEffects.VideoEffectFadeIn. For more control over darkness/brightness fading, use VisioForge.Core.Types.VideoEffects.VideoEffectDarkness with ValueStop.
Constructors
VideoEffectFadeOut(bool, string, TimeSpan, TimeSpan)
Initializes a new instance of the VisioForge.Core.Types.VideoEffects.VideoEffectFadeOut class with specified parameters.
public VideoEffectFadeOut(bool enabled, string name = "FadeOut", TimeSpan startTime = default, TimeSpan stopTime = default)Parameters
enabledbool-
trueto enable the effect immediately;falseto create the effect in a disabled state. namestring-
An optional name identifier for this effect instance. Default is "FadeOut".
startTimeTimeSpan-
The time at which the fade-out should begin (start fading to black). Default is Zero (from beginning, though typically used at end).
stopTimeTimeSpan-
The time at which the fade-out should complete (full black reached). Required to define fade duration. The fade duration is (stopTime - startTime).
Remarks
The fade-out effect requires both startTime and stopTime
to be properly set to define the fade duration. Setting both to zero will result in no visible effect.
Typical fade durations range from 1-3 seconds for subtle transitions, up to 5+ seconds for more dramatic fades. For end credits, fades of 2-3 seconds are standard.
Methods
GetEffectType()
Gets the specific type of this video effect.
public VideoEffectType GetEffectType()Returns
- VideoEffectType
-
Returns VisioForge.Core.Types.VideoEffects.VideoEffectType.FadeOut to identify this as a fade-out transition effect.
Remarks
This method is used by the video processing pipeline to route the effect to the appropriate fade transition processor.