Elecard AVC Video Decoder

Elecard AVC Video Decoder is a GStreamer plugin for decoding H.264/AVC (MPEG-4 Part 10, ISO/IEC 14496-10) streams.

Features

Elecard AVC Video Decoder has the following features:

  • Supports multiple color space formats;

  • Enables three frame decoding modes: all frames, only reference frames, only key frames;

  • Supports two deinterlacing methods, these being the fast Bob and the Advanced space-time algorithms;

  • Provides EPSNR calculation.

Parameter Description

Below is the table describing Elecard AVC Video Decoder parameters and their values:

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

analyzer-enable

Enables or disables input stream analysis before decoding.

Boolean

true, false

false

readable, writable

crop

Specifies a value for frame cropping in the LEFT, TOP, WIDTH, and HEIGHT formats. For example, the 0,0,1920,1080 value means the image is cropped with the top left corner at point 0,0 and with its size being 1920x1080 pixels. This parameter can’t be used with crop-h, crop-w, crop-x, crop-y parameters.

String

0,0,0,0

readable, writable

crop-h

Specifies the picture cropping height. The positive value sets the cropping height, while the negative value sets the vertical offset relative to the right bottom corner of the source picture. If the value is 0, cropping is not applied.

Integer

[-16384 – 16384]

0

readable, writable

crop-w

Specifies the picture cropping width. The positive value sets the cropping width, while the negative value sets the horizontal offset relative to the right bottom corner of the source picture. If the value is 0, cropping is not applied.

Integer

[-16384 – 16384]

0

readable, writable

crop-x

Specifies the X coordinate, which is the starting point for cropping.

Integer

[0 – 16384]

0

readable, writable

crop-y

Specifies the Y coordinate, which is the starting point for cropping.

Integer

[0 – 16384]

0

readable, writable

csc

Specifies the color space format for outputting decoded frames. In the Auto mode, the output format is determined by the media type of the output pad. For convenience, the parameter value can be specified in the alphabetical order instead of numerical.

Enum
• 0 — Auto
• -1073731448 — YUV420, 8 bit, planar
• -1073600376 — YV12, 4:2:0, 8 bit, planar
• -1073723256 — YUV422, 8 bit, planar
• -1073715064 — YUV444, 8 bit, planar
• -1073198968 — YUY2, 4:2:2, 8 bit, Y-U-Y-V
• -1072936824 — UYVY, 4:2:2, 8 bit, U-Y-V-Y
• -1073067896 — YVYU, 4:2:2, 8 bit, Y-V-Y-U
• -1073469304 — NV12, 4:2:0, 8 bit, semi-planar
• -1073338232 — NV21, 4:2:2, 8 bit, semi-planar
• -1073739640 — YUV400, 8 bit, monochrome
• -1073731318 — YUV420, 10 bit, planar
• -1073723126 — YUV422, 10 bit, planar
• -1073714934 — YUV444, 10 bit, planar
• -939251446 — P010, 4:2:0, 10 bit, semi-planar
• -1072674806 — V210, 4:2:2, 10 bit, V-Y-U-Y
• -1071978360 — BGR, 8 bit, B-G-R
• -1071716216 — BGR0, 8 bit, B-G-R-0
• -1071650680 — BGRA, 8 bit, B-G-R-A

0

readable, writable

dec-frames-buffering

Enables or disables the buffering of decoded frames. If set to 1, the decoder saves frames to the DPB buffer. If set to 0, i.e., disabled, the decoder outputs frames right after decoding. Disabling the buffering process may be required for low-latency decoding.

Unsigned Integer

[0 – 1]

1

readable, writable

decode-mode

Specifies the video decode mode. Available modes:

  • all — all frames (I/P/B) in the stream are decoded.

  • ref — only reference frames (I/P) are decoded, B-frames are skipped.

  • key — only key frames (I) are decoded.

Enum
0 — all
2 — ref
3 — key

0

readable, writable

deinterlace

Specifies the deinterlacing operation mode. In the On mode, the deinterlacing is always enabled, in the Off mode — always disabled. In the Auto mode, the deinterlacing is applied only to interlaced frames.

Enum
0 — Off
1 — On
2 — Auto

0

readable, writable

deinterlace-method

Specifies the deinterlacing method.

Enum
0 — Weave
1 — Bob
2 — Advanced

1

readable, writable

double-rate

Enables or disables the doubling of frame frequency; a progressive frame is created from an interlaced field.

Boolean

true, false

false

readable, writable

epsnr-enable

Enables or disables the EPSNR metric request from decoder feature.

Boolean

true, false

false

readable, writable

epsnr-value

Indicates the EPSNR value.

Double

[0 – 999]

0

readable

error-concealment

Specifies the mode of handling corrupted frames. Available modes:

  • off — show corrupted frames.

  • skip — don’t show corrupted frames.

  • restore — restore corrupted frames.

Enum
0 — off
1 — skip
2 — restore

0

readable, writable

fps

Indicates the current frame rate.

Double

[0 – 1,797693e+308]

-nan(ind)

readable

framerate

Specifies the output frame rate when transformation is required. If the value is set to 0, the rate doesn’t change.

Double

[0 – 500]

0

readable, writable

frames-decoded

Indicates the number of decoded frames.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

full-thread-load

Enables or disables the full load of decoding threads. Disabling this parameter can be required for low-latency operation.

Unsigned Integer

[0 – 1]

1

readable, writable

license-state

Indicates the license state.

String

evaluation expired

readable

name

Specifies the name of the object.

String

eavcdec0

readable, writable

num-threads

Specifies the number of threads for decoding. If the value is set to 0, the number is selected automatically. If multiple CPU cores are in use, it is recommended to use an explicit non-zero value such as 4.

Unsigned Integer

[0 – CPU_COUNT] 1

0

readable, writable

oem-name

Indicates the OEM name.

String

readable

parent

Specifies the parent of the object.

String

Object of type GstObject

readable, writable

resize

Specifies the WxH frame size, e.g., 1920x1080. This parameter can’t be used with resize-h and resize-w parameters.

String

0x0

readable, writable

resize-h

Specifies the change of the frame height. If set to 0, the height doesn’t change.

Integer

[0 – 16384]

0

readable, writable

resize-w

Specifies the change of the frame width. If set to 0, the width doesn’t change.

Integer

[0 – 16384]

0

readable, writable

thumbnails-period

Specifies the minimum time frame between two sequentially decoded frames for thumbnails (in seconds).

Integer

[0 – 2147483647]

0

readable, writable
1

Note that CPU_COUNT should be no larger than 32.