Class NVH265DecoderBlock

Namespace

VisioForge.Core.MediaBlocks.VideoDecoders

Assembly

VisioForge.Core.dll

NVIDIA hardware-accelerated H.265/HEVC decoder block using NVDEC technology. This block leverages NVIDIA GPU hardware decoding capabilities to efficiently decode H.265/HEVC video streams with minimal CPU usage. Supports Main, Main 10, Main 12, and other HEVC profiles supported by the GPU, enabling efficient playback of modern high-efficiency video content including HDR formats.

Hardware requirements: NVIDIA GPU with HEVC NVDEC support (GTX 960/10xx series or newer, Quadro, Tesla)

Supported profiles: Main, Main 10 (10-bit), Main 12 (12-bit), Main 4:4:4, Range Extensions

Performance: Can decode 8K@30fps or multiple 4K@60fps streams depending on GPU model

Use cases: 4K/8K video playback, HDR content, streaming services, professional video production

Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class NVH265DecoderBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

object

MediaBlock

NVH265DecoderBlock

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

NVH265DecoderBlock()

Initializes a new instance of the VisioForge.Core.MediaBlocks.VideoDecoders.NVH265DecoderBlock class. The decoder requires an NVIDIA GPU with HEVC NVDEC support and appropriate drivers installed. Note that some older GPUs may not support all HEVC profiles.

public NVH265DecoderBlock()

Properties

Input

Gets the primary input pad for receiving H.265/HEVC encoded video data.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets all input pads available on this hardware decoder block.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the primary output pad that provides hardware-decoded video frames.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads available on this hardware decoder block.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Type

Gets the media block type identifier for this NVIDIA H.265/HEVC hardware decoder.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Builds and initializes the NVIDIA hardware decoder within the pipeline, allocating GPU resources and configuring NVDEC for H.265/HEVC decoding.

public override bool Build()

Returns

bool

true if the hardware decoder was successfully initialized; false if GPU resources are unavailable.

CleanUp()

Performs cleanup of GPU resources, releasing NVDEC hardware decoder and freeing allocated GPU memory.

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 underlying GStreamer NVDEC element for advanced GPU configuration.

public BaseElement GetCore()

Returns

BaseElement

The core NVIDIA H.265/HEVC hardware decoder element instance.

GetElement()

Gets the native GStreamer NVDEC element for direct hardware manipulation.

public Element GetElement()

Returns

Element

The underlying GStreamer NVIDIA H.265/HEVC decoder element.

IsAvailable()

Determines whether NVIDIA hardware H.265/HEVC decoding is available on the current system. This method checks for compatible NVIDIA GPU hardware with HEVC support, NVDEC capability, and required drivers. Ensure the NVIDIA Video Codec SDK redistribution package is included in your project.

public static bool IsAvailable()

Returns

bool

true if NVIDIA H.265/HEVC hardware decoding is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Sets the pipeline context for this hardware decoder block, establishing GPU resource management and pipeline integration.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The parent MediaBlocksPipeline that manages GPU resources.

See Also

MediaBlock

IMediaBlockInternals

IDisposable