Table of Contents

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, IMediaBlockInternals

Inheritance

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

settings GLTransformationVideoEffect

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

MediaBlockPad

Inputs

Gets all input pads available on this block (single input for video processing).

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the primary output pad for providing geometrically transformed video frames.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads available on this block (single output for processed video).

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Settings

Gets or sets the transformation settings that control rotation, scaling, translation, and matrix-based geometric operations.

public GLTransformationVideoEffect Settings { get; set; }

Property Value

GLTransformationVideoEffect

Type

Gets the media block type identifier for OpenGL transformation operations.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

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

true if 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

disposing bool

true to release both managed and unmanaged resources; false to 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

true if 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

pipeline MediaBlocksPipeline

The parent MediaBlocks pipeline containing this transformation block.

See Also