Elecard QS Video Decoder

Elecard QS Video Decoder is a GStreamer plugin for decoding MPEG-2 (ISO/IEC 13818-2), H.264/AVC (MPEG-4 Part 10, ISO/IEC 14496-10), and H.265/HEVC (ISO/IEC 23008-2 MPEG-H Part 2/ITU-T H.265) streams based on Intel QuickSync technology.

Features

Elecard QS Video Decoder has the following features:

  • Supports various color space standards.

  • Supports multiple chroma format conversion settings.

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

  • Supports the Lowpower image resizing algorithm optimized for low-power consumption.

  • Ensures precise picture size and luminance adjustment.

Parameter Description

Below is the table describing Elecard QS Video Decoder parameters and their values.

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

analyzer-enable

Enables or disables the input stream analysis prior to decoding.

Boolean

True, False

False

readable, writable

colour-primaries

Specifies the standard of the color space in the video stream, which is required for correct display of colors on output devices.

Enum
0 — Unspecified
1 — BT.709
4 — FCC
5 — BT.601 PAL
6 — BT.601 NTSC
7 — SMPTE 240M
8 — Generic film
9 — BT.2020
10 — SMPTE 428
11 — SMPTE 431
12 — SMPTE 432
22 — EBU 3213

0

readable

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.

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.

Integer

[-16384 – 16384]

0

readable, writable

crop-x

Specifies the 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 the picture cropping parameters. Sets the top left corner coordinates (CropLeft: y) relative to the source picture.

Integer

[0 – 16384]

0

readable, writable

csc

Specifies the chroma format conversion and bit depth setting.

Enum
0 — Auto
-1073739640 — YUV, 4:0:0, 8 bit
-1073731448 — YUV, 4:2:0, 8 bit
-1073723256 — YUV, 4:2:2, 8 bit
-1073715064 — YUV, 4:4:4, 8 bit
-1073731318 — YUV, 4:2:0, 10 bit
-1073723126 — YUV, 4:2:2, 10 bit
-1073714934 — YUV, 4:4:4, 10 bit
-1073600376 — YV12, 4:2:0, 8 bit
-1073469304 — NV12, 4:2:0, 8 bit
-1073338232 — NV21, 4:2:2, 8 bit
-939251446 — P010, 4:2:0, 10 bit
-1073198968 — YUY2, 4:2:2, 8 bit
-1073067896 — YVYU, 4:2:2, 8 bit
-1072936824 — UYVY, 4:2:2, 8 bit
-938981366 — Y210, 4:2:2, 10 bit
-1072674806 — V210, 4:2:2, 10 bit
-1071978360 — BGR, 8 bit
-1071716216 — BGR0, 8 bit
-1071650680 — BGRA, 8 bit
-1071519734 — A2R10G10B10, 10 bit

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:

  • 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
1 — BOB
2 — Advanced

2

readable, writable

device-id (Windows-only) / device-path (Linux-only)

The device-id parameter specifies the ordinal number of the QS graphics card. The numeration starts from 0. The upper range boundary depends on the number of GPUs on a given machine. The parameter is used to control the component operation in systems with multiple graphics cards. The device-path parameter indicates a path to the video device. Since the device is selected automatically, the string is empty by default.

Integer (device-id) / String (device-path)

[0 – INTEL_GPU_COUNT]

0

readable, writable

display-primaries-x0

Specifies the horizontal coordinate (x) for the red color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

display-primaries-x1

Specifies the horizontal coordinate (x) for the green color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

display-primaries-x2

Specifies the horizontal coordinate (x) for the blue color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

display-primaries-y0

Specifies the vertical coordinate (y) for the red color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

display-primaries-y1

Specifies the vertical coordinate (y) for the green color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

display-primaries-y2

Specifies the vertical coordinate (y) for the blue color component in the color primaries system. The value is used to describe the video color space according to the CIE 1931 system.

Integer

[0 – 65535]

0

readable

double-rate

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

Boolean

True, False

False

readable, writable

fps

Indicates the current FPS.

Double

[0 – 1.797693e+308]

0

readable

frames-decoded

Indicates the number of decoded frames.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

frc

Specifies the frame rate of the output bitstream.

Fraction

[0/2147483647 – 2147483647/1]

0/1

readable, writable

full-range

Specifies whether the full range of levels is used for video display. The full range (0-255) can be found in PC screens and devices supporting the extended range; the limited range (16-235 for luma and 16-240 for chroma components) is used in the majority of television and broadcasting standards.

Boolean

True, False

False

readable

license-state

Indicates the license state.

String

evaluation expired

readable

matrix-coeffs

Specifies the transform matrix for encoding/decoding video color components (YUV ↔ RGB). The matrix determines how luminance (Y) and color differences (U, V) are transformed into color components (R, G, B) and back.

Enum
0 — Unspecified
1 — BT.709
2 — Identity
4 — FCC
5 — BT.601 PAL
6 — BT.601 NTSC
7 — SMPTE 240
8 — YCgCo
9 — BT.2020 NC
10 — BT.2020 C
11 — SMPTE 2085
12 — Chromaticity NC
13 — Chromaticity C
14 — BT.2100

0

readable

max-content-light-level

Specifies the maximum luminance level (in nits) for the brightest pixel in the entire video content.

Integer

[0 – 65535]

0

readable

max-display-mastering-luminance

Specifies the maximum luminance (in nits) used to calibrate the display for content mastering.

Integer

[0 – 2147483647]

0

readable

max-pic-average-light-level

Specifies the maximum average luminance (in nits) in the picture in any frame of the content.

Integer

[0 – 2147483647]

0

readable

min-display-mastering-luminance

Specifies the minimum luminance (in nits) used to calibrate the display for content mastering.

Integer

[0 – 65535]

0

readable

name

Specifies the name of the object.

String

eqsdec0

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 determines the number of threads automatically.

Unsigned Integer

[0 – CPU_COUNT]

0

readable, writable

oem-name

Indicates the OEM name.

String

readable

override-framerate

Specifies the frame rate for the input video, ignoring the information from its metadata. This method is used to fix errors in the source data and ensure the stream is processed correctly.

Fraction

[0/2147483647 – 2147483647/1]

0/1

readable, writable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

pic-struct-mode

Specifies the mode of handling frames with different structure types. Available modes:

  • IGNORE_SEI — ignore data in SEI and treat non-MBAFF interlaced frames as progressive;

  • PROGRESSIVE — treat input stream as progressive.

Enum
0 — Unspecified
1 — IGNORE_SEI
2 — PROGRESSIVE

0

readable, writable

pulldown-mode

Specifies the pulldown stream processing mode. In the Unspecified mode, the decoder will determine the processing mode on its own. In the Progressive mode, the pulldown stream will be treated as progressive.

Enum
0 — Unspecified
1 — Progressive

0

readable, writable

resize-h

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

Integer

[0 – 16384]

0

readable, writable

resize-w

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

Integer

[0 – 16384]

0

readable, writable

resize-mode

Specifies the image resizing algorithm. Available modes:

  • Lowpower — a quick mode optimized for low energy consumption;

  • Quality — a maximum quality mode.

Enum
0 — Unspecified
1 — Lowpower
2 — Quality

0

readable, writable

transfer-characteristics

Specifies the transfer function that determines how luminance (Luma) is transformed into signal levels. The method is used for correct display of the luminance levels according to the chosen standard.

Enum
0 — Unspecified
1 — BT.709
4 — FCC
5 — BT.601 PAL
6 — BT.601 NTSC
7 — SMPTE 240
8 — Linear
9 — Logarithmic 100:1
10 — Logarithmic 100*Sqrt(10):1
11 — IEC 61966-2-4
12 — BT.1361
13 — IEC 61966-2-1
14 — BT.2020 (10 bit)
15 — BT.2020 (12 bit)
16 — SMPTE 2084 (PQ)
17 — SMPTE 428
18 — BT.2100 (HLG)

0

readable

video-format

Specifies the stream video format.

Enum
0 — Unspecified
1 — PAL
2 — NTSC
3 — SECAM
4 — MAC
5 — Component

0

readable

white-point-x

Specifies the horizontal coordinate (x) of the white point in the CIE 1931 color space.

Integer

[0 – 65535]

0

readable

white-point-y

Sets the vertical coordinate (y) of the white point in the CIE 1931 color space.

Integer

[0 – 65535]

0

readable