Class GLTransformationBlock
- Namespace
- VisioForge.Core.MediaBlocks.OpenGL
- Assembly
- VisioForge.Core.dll
OpenGL-accelerated comprehensive video transformation block for advanced geometric and spatial video manipulations. Provides GPU-accelerated transformation capabilities including rotation, scaling, translation, perspective correction, and complex matrix-based transformations for professional video processing, motion graphics, and geometric corrections. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.
public class GLTransformationBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternalsInheritance
Implements
Inherited Members
Extension Methods
Constructors
GLTransformationBlock(GLTransformationVideoEffect)
Initializes a new instance of the VisioForge.Core.MediaBlocks.OpenGL.GLTransformationBlock class with the specified transformation settings. Creates the necessary input and output pads for video processing with comprehensive geometric transformations.
public GLTransformationBlock(GLTransformationVideoEffect settings)Parameters
settingsGLTransformationVideoEffect-
The transformation effect settings that define the geometric operation parameters and transformation matrices.
Properties
Input
Gets the primary input pad for receiving video frames to be geometrically transformed.
public override MediaBlockPad Input { get; }Property Value
Inputs
Gets all input pads available on this block (single input for video processing).
public override MediaBlockPad[] Inputs { get; }Property Value
Output
Gets the primary output pad for providing geometrically transformed video frames.
public override MediaBlockPad Output { get; }Property Value
Outputs
Gets all output pads available on this block (single output for processed video).
public override MediaBlockPad[] Outputs { get; }Property Value
Settings
Gets or sets the transformation settings that control rotation, scaling, translation, and matrix-based geometric operations.
public GLTransformationVideoEffect Settings { get; set; }Property Value
Type
Gets the media block type identifier for OpenGL transformation operations.
public override MediaBlockType Type { get; }Property Value
Methods
Build()
Builds and initializes the OpenGL transformation block within the pipeline context. Creates the GStreamer transformation filter, applies the geometric settings, and establishes the necessary pad connections for processing video frames with comprehensive spatial transformations.
public override bool Build()Returns
- bool
-
trueif the transformation block was successfully built and configured; otherwise,false.
CleanUp()
Cleans up all resources associated with the OpenGL transformation operations, including GStreamer elements and GPU shader programs.
public void CleanUp()Dispose(bool)
Releases unmanaged and managed resources used by the OpenGL transformation block. Properly disposes of GStreamer elements and GPU transformation matrix 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 GStreamer element wrapper for advanced configuration and monitoring.
public BaseElement GetCore()Returns
- BaseElement
-
The BaseElement wrapper providing access to the underlying GStreamer transformation filter.
GetElement()
Gets the native GStreamer element for direct GStreamer pipeline integration.
public Element GetElement()Returns
- Element
-
The native Gst.Element representing the comprehensive transformation filter.
IsAvailable()
Determines whether OpenGL transformation functionality is available on the current system. Requires OpenGL support and appropriate GStreamer OpenGL geometric transformation plugins to be installed.
public static bool IsAvailable()Returns
- bool
-
trueif transformation operations are supported; otherwise,false.
IMediaBlockInternals.SetContext(MediaBlocksPipeline)
Sets the pipeline context for this OpenGL transformation block, providing access to the parent pipeline and logging context.
void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)Parameters
pipelineMediaBlocksPipeline-
The parent MediaBlocks pipeline containing this transformation block.