Elecard MPEG-2 Video Encoder

Elecard MPEG-2 Video Encoder is a GStreamer plugin for encoding into MPEG-2 video- (ISO/IEC 13818-2) and MPEG-1 video-compatible (ISO/IEC 11172-2) streams.

Features

Elecard MPEG-2 Video Encoder has the following features:

  • Supports various aspect ratios.

  • Supports various Rate Control modes.

  • Provides precise GOP size and structure adjustment.

Parameter Description

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

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

adaptive-quant-mode

Specifies whether adaptive quantization for intra frames should be used. Available options:

  • off — quantization is disabled;

  • on — quantization is enabled;

  • slice_mb — quantization in the SliceMb mode 1.

Enum
0 — off
1 — on
2 — slice_mb

0

readable, writable

affinity-mask

Sets the affinity mask, i.e., a bit mask indicating which processor(s) a thread or process should be run on by the scheduler of the operating system.

Unsigned Integer64

[0 – 2147483647]

0

readable, writable

aspect-ratio-code

Specifies the code of the display aspect ratio in the bitstream. If set to 0, the aspect ratio is detected automatically.

Enum
0 — Auto
1 — 1:1
2 — 4:3
3 — 16:9
4 — 2.21:1

0

readable, writable

bitrate-avg

Specifies the average bit rate in bit/s.

Unsigned Integer64

[1024 – 576000000]

6000000

readable, writable

bitrate-max

Specifies the maximum bit rate in bit/s in the VBR mode.

Unsigned Integer64

[1024 – 576000000]

9000000

readable, writable

bitrate-min

Specifies the minimum bitrate in bit/s in the VBR mode.

Unsigned Integer64

[1024 – 576000000]

3000000

readable, writable

bitrate-mode

Specifies the Rate Control operation mode. Available modes:

  • CQ — a mode with fixed quantization parameters for all frames;

  • VBR — a variable bit rate mode with both maximum and minimum bit rates factored in;

  • CBR — a constant bit rate mode with VBV model limitations factored in. These limitations protect against the encoder’s buffer overflow and ensure that the specified bit rate is maintained.

Enum
0 — CQ
1 — VBR
2 — CBR

1

readable, writable

closedgop

Enables or disables the closed GOP structure. In an open GOP, frames can reference the frames of the preceding GOP, which increases compression efficiency but makes processing and random access more complicated.

Boolean

True, False

False

readable, writable

color-primaries

Specifies the chromaticity coordinates of the source primaries. It is defined in Table 6-7 of the MPEG-2 video standard (ISO/IEC 13818-2). If the Blu-ray preset is selected, the value is set to 1; otherwise, 5.

Unsigned Integer

[0 – 255]

1

readable, writable

dc-prec

Specifies the effective precision of the DC coefficient in intra-coded macroblocks. Usually, the 10-bit mode is enough for good saturation quality. The 11-bit value is valid for High Profile only.

Enum
0 — 8 bit
1 — 9 bit
2 — 10 bit
3 — 11 bit

2

readable, writable

encode-speed

Enables or disables the real-time encoding mode.

Boolean

True, False

False

readable, writable

encoded-frames

Indicates the number of encoded frames.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

field-order

Specifies the picture encoding mode:

  • Bottom Field First (BFF) — encoding mode where lower field lines are processed first;

  • Top Field First (TFF) — encoding mode where upper field lines are processed first;

  • Auto — mode where the processing order is selected automatically based on the information from the input video.

Enum
0 — BFF
1 — TFF
2 — Auto

2

readable, writable

gop-adaptive

Enables or disables the adaptive placement of B-frames. When enabled, the encoder automatically sets the number of B-frames depending on the complexity of the scene in the picture, increasing the video quality and compressing the data more efficiently.

Boolean

True, False

False

readable, writable

gop-max-bcount

Specifies the maximum number of consecutive B-frames in a group of pictures (GOP). This influences the GOP structure and the balance between video quality and compression efficiency.

Unsigned Integer

[0 – 3]

2

readable, writable

gop-max-length

Specifies the maximum GOP length, which impacts the video stream structure and the balance between compression quality and decoding complexity.

Unsigned Integer

[0 – 132]

25

readable, writable

intra-vlc

Specifies which of the two variable length encoding tables is used for intra-coded blocks.

Enum
0 — IntraVLC Table0
1 — IntraVLC Table1

0

readable, writable

level

Specifies the MPEG-2 codec level by setting limitations on the maximum values of bit rate, resolution, and other stream parameters.

Enum
2 — Unlimited
4 — High
6 — High1440
8 — Main
10 — Low

8

readable, writable

license-state

Indicates the component license state.

String

evaluation expired

readable

matrix-coefficients

Describes the matrix coefficients used in deriving luminance and chrominance signals from the green, blue, and red primaries. It is defined in Table 6-9 of the MPEG-2 video standard (ISO/IEC 13818-2). If the Blu-ray preset is selected, the value is set to 1; otherwise, 5.

Unsigned Integer

[0 – 255]

1

readable, writable

me-quality

Specifies the movement evaluation mode. Available modes:

  • full — full motion estimation algorithm;

  • disabled — no motion estimation.

Enum
0 — full
1 — disabled

0

readable, writable

mpeg1

Enables or disables video encoding in the MPEG-1 (ISO/IEC 11172-2) format.

Boolean

True, False

False

readable, writable

name

Indicates the name of the object.

String

em2venc0

readable, writable

num-threads

Specifies the number of threads the encoder will create to parallelize encoding. If set to 0, the encoder will determine the number of threads automatically.

Unsigned Integer

[0 – 16]

8

readable, writable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

picture-mode

Specifies whether the frames are interlaced or progressive.

Enum
0 — Interlaced frame
1 — Progressive frame
2 — Interlaced field

0

readable, writable

preset

Specifies the optimal encoder parameters for creating MPEG-2 stream, which is compatible with certain formats and devices.

Enum
0 — SVCD
1 — DVD-Video
2 — MicroMV
3 — HDV HD1
4 — HDV HD2
5 — XDCAM, CBR 25 mbps
6 — XDCAM, VBR 35 mbps
7 — D10 25 mbps
8 — D10 30 mbps
9 — D10 40 mbps
10 — D10 50 mbps
11 — Blu-ray
12 — Custom
13 — XDCAM, CBR 50 mbps, interlaced
14 — XDCAM, CBR 25 mbps, progressive
15 — XDCAM, VBR 35 mbps, progressive
16 — XDCAM, CBR 50 mbps, progressive
17 — Sony IMX, CBR 50 mbps
18 — Low delay

12

readable, writable

profile

Specifies the MPEG-2 profile that determines a set of functions and limitations for video stream decoding.

Enum
1 — High
4 — Main
5 — Simple
7 — 422

4

readable, writable

pulldown-mode

Specifies the NTSC pull-down generated in the video stream. It should only be used if the video frame rate is 23.976 or 24 frames per second. If enabled, the 23.976 fps (24 fps) video is encoded as 29.97 fps (30 fps) stream using the top_field_first and repeat_first_field flags in the picture encoding extension.

Enum
0 — Auto
1 — No Pull-Down
2 — 3:2 Pull-Down

1

readable, writable

qscale

Specifies the quantization scale types.

Enum
0 — Linear
1 — Non-linear
2 — Auto

2

readable, writable

quant-b

Specifies the quantizer value for B-frames in CQ (Constant Quality) video encoding mode.

Unsigned Integer

[0 – 51]

6

readable, writable

quant-i

Specifies the quantizer value for I-frames in CQ (Constant Quality) video encoding mode.

Unsigned Integer

[0 – 51]

2

readable, writable

quant-p

Specifies the quantizer value for P-frames in CQ (Constant Quality) video encoding mode.

Unsigned Integer

[0 – 51]

4

readable, writable

rc-sensibility

Sets the rate control sensibility of the input video changes (fade, fast motion, etc.). The parameter specifies time interval that is allowed for encoding with maximum or minimum bit rate. The option works for VBR rate control mode. If the Whole Video value is selected, the maximum bit rate is used without any limitation. The encoding parameters are determined only with the current scene complexity.

Enum
0 — 1 sec
1 — 15 sec
2 — 30 sec
3 — 60 sec
4 — Unlimited (Whole Video)

2

readable, writable

transfer-characteristics

Specifies the optoelectronic transfer characteristic of the source picture. It is defined in Table 6-8 of the MPEG-2 video standard (ISO/IEC 13818-2). If the Blu-ray preset is selected, the value is set to 1; otherwise, 5.

Unsigned Integer

[0 – 255]

1

readable, writable

use-intra-on-border

Enables or disables the encoding of the picture’s leftmost and rightmost macroblocks as intra-blocks.

Boolean

True, False

False

readable, writable

use-scd

Enables or disables Scene Change Detection (SCD). The mechanism enables the encoder to automatically detect the moments of sudden changes in the picture, such as transitions between various scenes, and adjust the GOP structure accordingly. Enabling SCD helps increase encoding quality.

Boolean

True, False

True

readable, writable

vbv-size

Specifies the VBV buffer size in 2 kB (2048 bytes) units. If set to 0, the appropriate value is calculated automatically. Maximum value depends on the selected Profile/Level.

Unsigned Integer

[0 – 1023]

88

readable, writable

write-pde

Specifies whether picture display extension should be contained in the video stream.

Boolean

True, False

False

readable, writable

write-sde

Specifies whether the sequence display extension should be contained in every GOP. Some players have problems playing SVCDs that are encoded with extensions. So, this option enables the user to turn the extensions off if required.

Boolean

True, False

False

readable, writable

write-sec

Specifies whether the encoder writes a sequence end code at the end of stream.

Boolean

True, False

True

readable, writable

write-sh

Specifies whether the sequence header is contained in every GOP or just once at the beginning of stream. The option should be turned on for VCD, SVCD, and DVD.

Boolean

True, False

True

readable, writable
1

When encoding in D-10 (the SMPTE 356M specification), select the SliceMb mode.