Table of Contents

Class AMAAV1EncoderSettings

Namespace
VisioForge.Core.Types.X.VideoEncoders
Assembly
VisioForge.Core.dll

Configuration settings for the AMD AMA (Alveo MA35D) hardware AV1 encoder (ama_av1enc).

public class AMAAV1EncoderSettings : IAV1EncoderSettings, IVideoEncoder, IMediaBlockSettings

Inheritance

Implements

Inherited Members

Remarks

Available on Linux only and requires the AMD AMA Video SDK (kernel driver + GStreamer plugins). Property values are stable across AMA SDK v1.0/v1.1/v1.2 and applied best-effort — an absent property on an older SDK build is ignored, not fatal. The encoder consumes device memory, so the SDK inserts an ama_upload element in front of it automatically when the source is in system memory.

Constructors

AMAAV1EncoderSettings()

Initializes a new instance of the VisioForge.Core.Types.X.VideoEncoders.AMAAV1EncoderSettings class.

public AMAAV1EncoderSettings()

AMAAV1EncoderSettings(VideoQuality)

Initializes a new instance of the VisioForge.Core.Types.X.VideoEncoders.AMAAV1EncoderSettings class with a specified quality level.

public AMAAV1EncoderSettings(VideoQuality quality)

Parameters

quality VideoQuality

The video quality level that determines bitrate settings.

Fields

Name

Gets the display name of this encoder.

public static readonly string Name

Field Value

string

Properties

BFrames

Gets or sets the number of B-frames between P-frames (AV1 range -1..7). -1 (default) = auto.

public int BFrames { get; set; }

Property Value

int

Bitrate

Gets or sets the target bitrate in Kbps. Default 5000 (5 Mbps).

public uint Bitrate { get; set; }

Property Value

uint

Device

Gets or sets the numeric ID of the MA35D device to encode on. -1 (default) auto-selects a card. Use this to pin encoding to a specific Alveo MA35D when several AMD devices are present.

public int Device { get; set; }

Property Value

int

DeviceType

Gets or sets the AV1 device engine type.

public AMAAV1DeviceType DeviceType { get; set; }

Property Value

AMAAV1DeviceType

ForcedIDR

Gets or sets a value indicating whether all intra frames are encoded as IDR frames. Default true.

public bool ForcedIDR { get; set; }

Property Value

bool

GOPLength

Gets or sets the maximum I-frame distance (GOP length). -1 (default) = auto.

public int GOPLength { get; set; }

Property Value

int

LatencyMs

Gets or sets the encoder latency target in milliseconds (-1..60000). -1 (default) = auto.

public int LatencyMs { get; set; }

Property Value

int

LookaheadDepth

Gets or sets the number of future frames analyzed (look-ahead depth). -1 (default) = auto.

public int LookaheadDepth { get; set; }

Property Value

int

MaxBitrate

Gets or sets the maximum (peak) bitrate in Kbps for VBR/CVBR modes. -1 (default) = auto.

public int MaxBitrate { get; set; }

Property Value

int

MaxQP

Gets or sets the maximum allowed QP (AV1 range 0-255). Default 255.

public int MaxQP { get; set; }

Property Value

int

MinQP

Gets or sets the minimum allowed QP (AV1 range 0-255). Default 0.

public int MinQP { get; set; }

Property Value

int

QP

Gets or sets the fixed quantization parameter used in constant-QP mode (AV1 range 0-255). -1 (default) = disabled.

public int QP { get; set; }

Property Value

int

QPBOffset

Gets or sets the QP offset for P/B-frames (-51..51). Default 0.

public int QPBOffset { get; set; }

Property Value

int

QPIOffset

Gets or sets the QP offset for I-frames (-51..51). Default 0.

public int QPIOffset { get; set; }

Property Value

int

QPMode

Gets or sets the QP control mode.

public AMAQPMode QPMode { get; set; }

Property Value

AMAQPMode

RateControl

Gets or sets the rate-control mode.

public AMARateControl RateControl { get; set; }

Property Value

AMARateControl

Slice

Gets or sets which slice (sub-engine) of the selected MA35D device to use. -1 (default) = auto.

public int Slice { get; set; }

Property Value

int

SpatialAQ

Gets or sets a value indicating whether spatial adaptive quantization is enabled. Default true.

public bool SpatialAQ { get; set; }

Property Value

bool

SpatialAQGain

Gets or sets the spatial AQ strength (0-255). Default 255.

public int SpatialAQGain { get; set; }

Property Value

int

TemporalAQ

Gets or sets a value indicating whether temporal adaptive quantization is enabled. Default true.

public bool TemporalAQ { get; set; }

Property Value

bool

TemporalAQGain

Gets or sets the temporal AQ strength (0-255). Default 255.

public int TemporalAQGain { get; set; }

Property Value

int

Tier

Gets or sets the AV1 tier.

public AMATier Tier { get; set; }

Property Value

AMATier

TuneMetrics

Gets or sets the objective quality metric to tune for.

public AMATuneMetrics TuneMetrics { get; set; }

Property Value

AMATuneMetrics

Methods

CreateBlock()

Creates a new AV1 encoder block with these settings.

public MediaBlock CreateBlock()

Returns

MediaBlock

A configured VisioForge.Core.MediaBlocks.MediaBlock instance for AV1 encoding.

GetEncoderType()

Gets the type of the encoder.

public AV1EncoderType GetEncoderType()

Returns

AV1EncoderType

The VisioForge.Core.Types.X.VideoEncoders.AV1EncoderType value for the AMA AV1 encoder.

IsAvailable()

Determines whether this encoder is available on the current machine.

public static bool IsAvailable()

Returns

bool

true if the ama_av1enc and ama_upload elements are present; otherwise, false.

ToString()

Returns a String that represents this instance.

public override string ToString()

Returns

string

A String that represents this instance.