Table of Contents

Class AgingVideoEffect

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

Represents an aging video effect that simulates old, deteriorated film or video footage.

public class AgingVideoEffect : BaseVideoEffect, IBaseVideoEffect, IVideoEditXVideoEffect

Inheritance

Implements

Inherited Members

Remarks

SDK Availability: VideoCaptureCoreX, MediaPlayerCoreX, VideoEditCoreX, Media Blocks SDK

Platforms: Windows, Linux, macOS, Android, iOS

This effect simulates the visual characteristics of aged film or video, including:

  • Color Aging: Yellowing and color fading typical of old film
  • Scratch Lines: Vertical scratches that appear on film surfaces
  • Dusts: Random dust particles and spots
  • Pits: Small holes and imperfections in the film

The aging effect is ideal for creating vintage looks, retro-style videos, flashback scenes, historical recreations, or artistic projects requiring an authentic old-film aesthetic.

This is a cross-platform effect using agingtv element. For Windows-only applications, consider using GPUVideoEffectOldMovie which provides GPU-accelerated old movie effects with different stylization options.

Performance: Real-time capable on most hardware. The effect adds random artifacts each frame, which has minimal performance impact.

Constructors

AgingVideoEffect(string)

Initializes a new instance of the VisioForge.Core.Types.X.VideoEffects.AgingVideoEffect class with specified name.

public AgingVideoEffect(string name = "aging")

Parameters

name string

The unique name for this effect instance. Defaults to "aging".

Fields

DefaultName

The default name for aging effects.

public static string DefaultName

Field Value

string

Properties

ColorAging

Gets or sets a value indicating whether to enable color aging (yellowing/fading).

public bool ColorAging { get; set; }

Property Value

bool

Remarks

Color aging simulates the chemical deterioration of film stock over time, producing the characteristic yellow-brown tint and reduced color saturation seen in vintage footage.

Dusts

Gets or sets a value indicating whether to add dust particles to the video.

public bool Dusts { get; set; }

Property Value

bool

Remarks

Dust particles simulate the accumulation of dirt and debris on film surfaces, appearing as random white or dark spots that change position each frame.

Pits

Gets or sets a value indicating whether to add pits (small holes) to the video.

public bool Pits { get; set; }

Property Value

bool

Remarks

Pits simulate physical damage to the film surface, such as small holes, tears, or emulsion loss, appearing as dark spots or missing areas in the image.

ScratchLines

Gets or sets the number of vertical scratch lines to add to the video.

public uint ScratchLines { get; set; }

Property Value

uint

Remarks

Scratch lines simulate the vertical scratches that appear on film when it passes through projectors or is physically damaged. The lines move horizontally across the frame over time.

StartTime

Gets or sets the start time for the aging effect (VideoEditCoreX only).

public TimeSpan StartTime { get; set; }

Property Value

TimeSpan

Remarks

This property is only used in VideoEditCoreX for time-based effect control.

StopTime

Gets or sets the stop time for the aging effect (VideoEditCoreX only).

public TimeSpan StopTime { get; set; }

Property Value

TimeSpan

Remarks

This property is only used in VideoEditCoreX for time-based effect control.

Methods

GenerateDescription()

Generates the description.

public string GenerateDescription()

Returns

string

A string containing the GStreamer element description for the aging effect.