Class SimpleVideoMarkDetectBlock
- Assembly
- VisioForge.Core.dll
MediaBlock that detects and extracts invisible digital watermarks from video streams for identification and verification. This block uses GStreamer's simplevideomarkdetect element to identify unique patterns embedded by SimpleVideoMarkBlock. The detection provides real-time notification when watermarks are found, enabling applications to track content, verify authenticity, and implement copyright protection systems. Essential for broadcast monitoring, content distribution tracking, digital rights management, and media forensics applications. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class SimpleVideoMarkDetectBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
SimpleVideoMarkDetectBlock(uint)
Initializes a new instance of the VisioForge.Core.MediaBlocks.VideoProcessing.SimpleVideoMarkDetectBlock class. Creates a video watermark detection block ready to identify digital marks in video streams.
public SimpleVideoMarkDetectBlock(uint pattern = 0)Parameters
patternuint-
The pattern value to detect (0 = detect any pattern, specific value = detect only that pattern).
Properties
Input
Gets the input.
public override MediaBlockPad Input { get; }Property Value
Inputs
Gets the inputs.
public override MediaBlockPad[] Inputs { get; }Property Value
Output
Gets the output.
public override MediaBlockPad Output { get; }Property Value
Outputs
Gets the outputs.
public override MediaBlockPad[] Outputs { get; }Property Value
Pattern
Gets or sets the pattern value to search for in the video stream. When set to 0 (default), detects any pattern. When set to a specific value, only detects that pattern.
public uint Pattern { get; set; }Property Value
Type
Gets the type.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Constructs and initializes the simple video mark detect filter and its associated GStreamer elements. This method creates the filter, establishes input and output pads, sets up event handlers, and prepares the block for detecting watermarks in video streams.
public override bool Build()Returns
- bool
-
trueif the filter was successfully built and configured;falseif initialization failed.
CleanUp()
Releases all resources and performs cleanup operations for this simple video mark detect block. This method disposes of the GStreamer elements and resets the build state.
public void CleanUp()Dispose(bool)
Releases unmanaged and - optionally - managed resources.
protected override void Dispose(bool disposing)Parameters
disposingbool-
trueto release both managed and unmanaged resources;falseto release only unmanaged resources.
GetCore()
Gets the core BaseElement wrapper that provides additional functionality around the GStreamer simple video mark detect filter element.
public BaseElement GetCore()Returns
- BaseElement
-
The BaseElement wrapper instance that encapsulates the GStreamer simple video mark detect filter.
GetElement()
Gets the underlying GStreamer element that performs the video watermark detection.
public Element GetElement()Returns
- Element
-
The GStreamer Element instance representing the simple video mark detect filter.
IsAvailable()
Determines whether the simple video mark detect filter is available on the current system. This checks if the required GStreamer videosignal plugins are installed and accessible. The correct NuGet SDK redistribution package should be included in your project.
public static bool IsAvailable()Returns
- bool
-
trueif the simple video mark detect filter is available and can be used; otherwise,false.
IMediaBlockInternals.SetContext(MediaBlocksPipeline)
Associates this simple video mark detect block with a pipeline and initializes its internal context. This method is called internally when the block is added to a pipeline.
void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)Parameters
pipelineMediaBlocksPipeline-
The MediaBlocksPipeline instance that will manage this block.
VideoMarkDetected
Event that fires when a video watermark is detected in the stream. Provides the detected pattern value and timestamp information.
public event EventHandler<VideoMarkDetectedEventArgs> VideoMarkDetectedEvent Type
- EventHandler<VideoMarkDetectedEventArgs>