Class GLColorBalanceBlock

Namespace

VisioForge.Core.MediaBlocks.OpenGL

Assembly

VisioForge.Core.dll

OpenGL color balance block for professional color correction and grading. This block provides GPU-accelerated color adjustment capabilities including hue, saturation, brightness, contrast, gamma correction, and white balance adjustments. Uses OpenGL shaders for real-time color manipulation with professional-grade precision. Essential for broadcast video production, color grading workflows, and correcting color cast issues. Supports RGB channel-specific adjustments and maintains color accuracy throughout the processing pipeline. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class GLColorBalanceBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

object

MediaBlock

GLColorBalanceBlock

Implements

IMediaBlock

IDisposable

IMediaBlockInternals

Inherited Members

MediaBlock._isBuilt

MediaBlock._pipeline

MediaBlock._pipelineCtx

MediaBlock.GetPipelineContext()

MediaBlock.SetPipelineContext(BlockPipelineContext)

MediaBlock.SetPipeline(MediaBlocksPipeline)

MediaBlock.Context

MediaBlock.Name

MediaBlock.IsBuilt

MediaBlock.Owner

MediaBlock.Type

MediaBlock.ID

MediaBlock.Input

MediaBlock.Inputs

MediaBlock.Output

MediaBlock.Outputs

MediaBlock.HasInputs

MediaBlock.HasOutputs

MediaBlock.Build()

MediaBlock.CreateElements()

MediaBlock.AddElementsToPipeline()

MediaBlock.RemoveElementsFromPipeline()

MediaBlock.DeepCopy(string)

MediaBlock.Reset()

MediaBlock.ToYAMLBlock()

MediaBlock.ClearPads()

MediaBlock.Dispose(bool)

MediaBlock.Dispose()

object.Equals(object?)

object.Equals(object?, object?)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object?, object?)

object.ToString()

Extension Methods

MediaBlockExtensions.GetInputPadByType(IMediaBlock, MediaBlockPadMediaType)

MediaBlockExtensions.GetOutputPadByType(IMediaBlock, MediaBlockPadMediaType)

MediaBlockHelper.SendEndOfStream(MediaBlock)

MediaBlockHelper.SendEvent(MediaBlock, Event)

MediaBlockHelper.SetState(MediaBlock, State)

Constructors

GLColorBalanceBlock(GLColorBalanceVideoEffect)

Initializes a new instance of the VisioForge.Core.MediaBlocks.OpenGL.GLColorBalanceBlock class with the specified color correction settings.

public GLColorBalanceBlock(GLColorBalanceVideoEffect settings)

Parameters

settings GLColorBalanceVideoEffect

The color balance video effect settings containing color grading parameters.

Properties

Input

Gets the input pad for connecting video sources to be processed.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets all input pads for this color balance block.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the output pad for connecting to downstream processing blocks.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads for this color balance block.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Settings

Gets or sets the color balance configuration settings. Defines color correction parameters including hue, saturation, brightness, and contrast adjustments.

public GLColorBalanceVideoEffect Settings { get; set; }

Property Value

GLColorBalanceVideoEffect

Type

Gets the media block type identifier.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Constructs and initializes the OpenGL color balance element within the pipeline. This method creates the color balance filter with the specified correction settings, establishes input and output pads, and prepares the block for GPU-accelerated processing.

public override bool Build()

Returns

bool

true if the color balance element was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this OpenGL color balance block. This method disposes of the color balance filter and resets the build state.

public void CleanUp()

Dispose(bool)

Releases unmanaged and - optionally - managed 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 BaseElement wrapper that provides additional functionality around the OpenGL color balance filter.

public BaseElement GetCore()

Returns

BaseElement

The BaseElement wrapper instance that encapsulates the color balance functionality.

GetElement()

Gets the underlying GStreamer element that performs the color balance operation.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the OpenGL color balance filter.

IsAvailable()

Determines whether this media block is available. Correct NuGet SDK redist should be included into your project. Checks for OpenGL support and GPU shader capabilities.

public static bool IsAvailable()

Returns

bool

true if OpenGL color balance functionality is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this OpenGL color balance 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

pipeline MediaBlocksPipeline

The MediaBlocksPipeline instance that will manage this block.

See Also

MediaBlock

IMediaBlockInternals

IDisposable