Elecard MPEG-2 Video Decoder

Elecard MPEG-2 Video Decoder is a GStreamer plugin for decoding MPEG-2 video (ISO/IEC 13818-2) and MPEG-1 video (ISO/IEC 11172-2) streams.

Features

Elecard MPEG-2 Video Decoder has the following features:

  • Supports multiple chroma format conversion settings;

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

  • Supports two deinterlacing methods: the fast Bob algorithm and the Advanced space-time algorithm;

  • Ensures EPSNR calculation.

Parameter Description

Below is the table describing Elecard MPEG-2 Video Decoder parameters and their values.

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

analyzer-enable

Enables or disables input stream analysis prior to decoding.

Boolean

True, False

False

readable, writable

crop-h

Specifies 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.

Integer

[-16384 – 16384]

0

readable, writable

crop-w

Specifies 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.

Integer

[-16384 – 16384]

0

readable, writable

crop-x

Specifies picture cropping parameters. Sets the top left corner coordinates (CropTop: x) relative to the source picture.

Integer

[0 – 16384]

0

readable, writable

crop-y

Specifies picture cropping parameters. Sets the top left corner coordinates (CropLeft: y) relative to the source picture.

Integer

[0 – 16384]

0

readable, writable

csc

Specifies chroma format conversion and bit depth setting.

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

decode-mode

Specifies video decoding 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. Available methods:

  • Weave — combines two adjacent fields (even and odd lines) into a single frame, essentially “weaving” them together;

  • BOB — the fast Bob algorithm that vertically scales the original frame field to a complete frame;

  • Advanced — a high-quality space-time algorithm that uses adaptive algorithms to process each frame area.

Enum

0 — Weave
1 — BOB
2 — Advanced

1

readable, writable

double-rate

Enables or disables frame rate doubling mode during deinterlacing by transforming each field into a complete frame.

Boolean

True, False

False

readable, writable

epsnr-enable

Enables or disables calculation of EPSNR.

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 all frames, including the corrupted ones;

  • skip — don’t show corrupted frames;

  • restore — restore corrupted frames.

Enum

0 — off
1 — skip
2 — restore

0

readable, writable

fps

Indicates the current FPS.

Double

[0 – 1.797693e+308]

-nan(ind)

readable

framerate

Specifies the frame rate of the output.

Double

[0 – 500]

0

readable, writable

frames-decoded

Indicates the number of decoded frames.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

license-state

Indicates the license state.

String

evaluation

readable

name

Specifies the name of the object.

String

em2vdec0

readable, writable

num-threads

Specifies the number of threads the decoder will create to parallelize the decoding process. The upper range boundary depends on the number of logical CPU cores on a given machine. If the value is set to 0, the decoder will determine the number of threads automatically.

Unsigned Integer

[0 – 32]

0

readable, writable

oem-name

Indicates the OEM name.

String

“”

readable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

reordering

Lets the user change frame delivery order from DisplayOrder to StreamOrder, which can be important for subsequent video processing.

Unsigned Integer

[0 – 1]

1

readable, writable

resize-h

Specifies output picture height. If changing picture height is not required, set the parameter to 0.

Integer

[0 – 16384]

0

readable, writable

resize-w

Specifies output picture width. If changing picture width is not required, set the parameter to 0.

Integer

[0 – 16384]

0

readable, writable

thumbnails-period

The minimum time between two consecutively decoded thumbnails (in seconds).

Integer

[0 – 2147483647]

0

readable, writable