Table of Contents

Class AV1EncoderBlock

Namespace
VisioForge.Core.MediaBlocks.VideoEncoders
Assembly
VisioForge.Core.dll

AV1 encoder block for next-generation video compression with superior efficiency and quality. This block provides advanced AV1 (AOMedia Video 1) encoding capabilities offering up to 50% better compression efficiency compared to H.264 while maintaining equivalent visual quality. Features hardware acceleration support, adaptive bitrate control, and advanced psychovisual optimization. Essential for streaming services, video delivery platforms, and applications requiring optimal bandwidth utilization with future-proof codec technology. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class AV1EncoderBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

Implements

Inherited Members

Extension Methods

Constructors

AV1EncoderBlock(IAV1EncoderSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.VideoEncoders.AV1EncoderBlock class with specified AV1 encoder settings.

public AV1EncoderBlock(IAV1EncoderSettings settings)

Parameters

settings IAV1EncoderSettings

The AV1 encoder configuration settings.

Properties

Input

Gets the input.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets the inputs.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the output.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets the outputs.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Settings

Gets or sets the AV1 encoder settings. Contains comprehensive configuration parameters for AV1 encoding including bitrate control, quality settings, and hardware acceleration options.

public IAV1EncoderSettings Settings { get; set; }

Property Value

IAV1EncoderSettings

Type

Gets the type.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Constructs and initializes the AV1 encoder and its associated GStreamer elements. This method creates the encoder with the specified settings, establishes input and output pads, and prepares the block for high-efficiency video compression using the AV1 codec.

public override bool Build()

Returns

bool

true if the encoder was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this AV1 encoder 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

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 GStreamer AV1 encoder element.

public BaseElement GetCore()

Returns

BaseElement

The BaseElement wrapper instance that encapsulates the GStreamer AV1 encoder.

GetElement()

Gets the underlying GStreamer element that performs the AV1 video encoding.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the AV1 encoder.

IsAvailable(IAV1EncoderSettings)

Determines whether AV1 encoding is available with the specified settings. Checks for required codec libraries and hardware acceleration support.

public static bool IsAvailable(IAV1EncoderSettings settings)

Parameters

settings IAV1EncoderSettings

The AV1 encoder settings to validate.

Returns

bool

true if AV1 encoding is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this AV1 encoder 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