GStreamer DMAI plug-in element properties

From RidgeRun Developer Connection
Jump to: navigation, search

DDOMPE branch

Video encoders

Common

Parameter name Description
name The name of the object

flags: readable, writable
String. Default: null

outputBufferSize Size of the output buffer

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0

copyOutput Boolean that set if the output buffers should be copied into standard gst buffers

flags: readable, writable
Boolean. Default: false

H.264

Parameter name Description
ratecontrol Rate Control Algorithm to use:

1 - Constant Bit Rate (CBR), for video conferencing:
2 - Variable Bit Rate (VBR), for storage:
3 - Two pass rate control for non real time applications:
4 - No Rate Control is used:
5 - User defined on extended parameters:
flags: readable, writable:
Integer. Range: 1 - 5 Default: 1

encodingpreset Encoding Preset Algorithm to use:

0 - Default (check codec documentation):
1 - High Quality:
2 - High Speed:
3 - User defined on extended parameters:
flags: readable, writable:
Integer. Range: 0 - 3 Default: 2

maxbitrate Maximum bit-rate to be supported in bits per second

flags: readable, writable:
Integer. Range: 1000 - 20000000 Default: 6000000

targetbitrate Target bit-rate in bits per second, should be <= than the maxbitrate

flags: readable, writable:
Integer. Range: 1000 - 20000000 Default: 6000000

intraframeinterval Interval between two consecutive intra frames:

0 - Only first I frame followed by all P frames
1 - No inter frames (all intra frames)
2 - Consecutive IP sequence (if no B frames)
N - (n-1) P sequences between I frames
flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 30

forceintra Force next frame to be an intracodec frame

flags: readable, writable
Boolean. Default: false

profile H264 Profile to use:

66 - Base Line
77 - Main Line
100 - High Line (Default) flags: readable, writable
Integer. Range: 0 - 100 Default: 100

level H264 Level to use:

9 - For 1.b
10 - For 1.0
.. Any valid level between
51 - For 5.1
flags: readable, writable
Integer. Range: 9 - 51 Default: 40

entropy Entropy mode:

0 - CAVLC
1 - CABAC
flags: readable, writable
Integer. Range: 0 - 1 Default: 1

t8x8intra Enable 8x8 Transform for I Frame (only for High Profile)

flags: readable, writable
Boolean. Default: true

t8x8inter Enable 8x8 Transform for P Frame (only for High Profile)

flags: readable, writable
Boolean. Default: false

encquality Encoder quality:

0 - Version 1.1 backward compatible
1 - High Quality (same as encodingpreset=1)
2 - High Speed (same as encodingpreset=2)
flags: readable, writable
Integer. Range: 0 - 2 Default: 2

enabletcm When encquality is 0, this flag controls if TCM memory should be used (otherwise is ignored and default to yes)

flags: readable, writable
Boolean. Default: false

ddrbuf Use DDR buffers instead of IMCOP buffers

flags: readable, writable
Boolean. Default: false

ntemplayers Number of temporal Layers for SVC:

0 - one layer
1 - two layers (F, F/2)
2 - three layers (F, F/2, F/4)
3 - four layers (F, F/2, F/4, F/8)
255 - all P refer to previous I or IDR frame
flags: readable, writable
Integer. Range: 0 - 255 Default: 0

svcsyntaxen Control for SVC syntax and DPB management:

0 - SVC disabled sliding window enabled
1 - SVC enabled sliding window enabled
2 - SVC disabled MMCO enabled
3 - SVC enabled MM flags: readable, writable
Integer. Range: 0 - 3 Default: 0

seqscaling Sequence scaling matrix present:

0 = Disable
1 = Auto (Default)
2 = Low
3 = Moderate
4 = Reserved
flags: readable, writable
Integer. Range: 0 - 4 Default: 1

qpintra Quantization Parameter (QP) for I frame (only valid when rate control is disabled or is fixed QP)

flags: readable, writable
Integer. Range: 1 - 31 Default: 28

qpinter Quantization Parameter (QP) for P frame (only valid when rate control is disabled or is fixed QP)

flags: readable, writable
Integer. Range: 1 - 31 Default: 28

rcalgo Rate Control Algorithm (requires ratecontrol set to 5):

0 - CBR
1 - VBR (Default)
2 - Fixed QP
3 - CVBR
4 - Custom RC1 - Fixed size frame
5 - Custom CBR1
6 - Custom VBR1
flags: readable, writable
Integer. Range: 0 - 6 Default: 1

airrate Adaptive intra refresh. This indicates the maximum number of MBs(per frame) that can be refreshed using AIR.

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0

idrinterval Interval between two consecutive IDR frames

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0

bytestream Generate h264 NAL unit stream instead of 'packetized' stream (no codec_data is generated). Packetized stream is used when transmitting over an IP network.


flags: readable, writable
Boolean. Default: false

aud Generate h264 Access Unit Delimiters format

flags: readable, writable
Boolean. Default: false

headers Include on the stream the SPS/PPS headers

flags: readable, writable
Boolean. Default: false

single-nalu Buffers contains a single NALU

flags: readable, writable
Boolean. Default: false

RidgeRun recommended settings for 1080p30 RTSP streaming:

Parameter RidgeRun
Static encodingPreset 2
rateControlPreset 2
maxHeight 1088
maxWidth 1920
maxFrameRate 30000
maxBitRate 4000000
dataEndianness 1
maxInterFrameInterval 1
inputChromaFormat 9
inputContentType 0
reconChromaFormat 9
Dynamic inputHeight 1088
inputWidth 1920
refFrameRate 30000
targetFrameRate 30000
targetBitRate 4000000
intraFrameInterval 30
generateHeader 0
captureWidth 0
forceFrame -1
interFrameInterval 0
mbDataFlag 0

MPEG4

Parameter name Description
ratecontrol Rate Control Algorithm to use:

1 - Constant Bit Rate (CBR), for video conferencing
2 - Variable Bit Rate (VBR), for storage
3 - Two pass rate control for non real time applications
4 - No Rate Control is used
5 - User defined on extended parameters
flags: readable, writable
Integer. Range: 1 - 5 Default: 1

encodingpreset Encoding Preset Algorithm to use:

0 - Default (check codec documentation)
1 - High Quality
2 - High Speed
3 - User defined on extended parameters
flags: readable, writable
Integer. Range: 0 - 3 Default: 2

maxbitrate Maximum bit-rate to be supported in bits per second

flags: readable, writable
Integer. Range: 1000 - 20000000 Default: 6000000

targetbitrate Target bit-rate in bits per second, should be <= than the maxbitrate

flags: readable, writable
Integer. Range: 1000 - 20000000 Default: 6000000

intraframeinterval Interval between two consecutive intra frames:

0 - Only first I frame followed by all P frames
1 - No inter frames (all intra frames)
2 - Consecutive IP sequence (if no B frames)
N - (n-1) P sequences between I frames
flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 30

forceintra Force next frame to be an intracodec frame

flags: readable, writable

MJPEG

Parameter name Description
qValue Q compression factor, from 1 (lowest quality) to 97 (highest quality). [default: 75]

flags: readable, writable
Integer. Range: 1 - 97 Default: 75

Other Hardware Accelerators

DMAI Resizer

The GStreamer dmairesizer element accepts video data in either UYVY or NV12 colorspace and produces UYVY data that has been optionally scaled in the horizontal and/or vertical directions.


Parameter name Description
source-x X axis pixel on the origin image

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

source-y Y axis pixel on the origin image

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

source-width Width of source frame (must be multiple of 16)

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

source-height Height of source frame

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

target-width Width of target frame (must be multiple of 16)

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

target-height Height of target frame (must be multiple of 16)

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

target-width-max Target buffer max width (must be multiple of 16)

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

target-height-max Target buffermax height (must be multiple of 16)

flags: readable, writable
Integer. Range: 0 - 2147483647 Default: 0 Current: 0

aspect-ratio Keep aspect ratio

flags: readable, writable
Boolean. Default: false Current: false

normalize-par Normalize the pixel aspect ratio to 1/1

flags: readable, writable
Boolean. Default: false Current: false

number-output-buffers Number of output buffers

flags: readable, writable
Integer. Range: 1 - 2147483647 Default: 3 Current: 3