GStreamer DMAI plug-in element properties

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 In gst_tidmaienc_configure_codec() in $DEVDIR/proprietary/dvsdk-4_02_00_06/gst-dmai-plugins/src/src/gsttidmaienc.c the outputBufferSize is set to 3 * the codec minOutBufSize, as defined on page 78 in h264_encoder_dm365_userguide.pdf
copyOutput	Boolean that set if the output buffers should be copied into standard gst buffers flags: readable, writable Boolean. Default: false

H.264

• TI Application Note Parameter Settings for TMS320DM365 H.264 Encoder (pdf) (old, but then only one available)

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