TI J721E Imaging User Guide
tivx_dmpac_dof_params_t Struct Reference

Detailed Description

The configuration data structure used by the TIVX_KERNEL_DMPAC_DOF kernel.

Data Fields

uint16_t vertical_search_range [2]
 
uint16_t horizontal_search_range
 
uint16_t median_filter_enable
 
uint16_t motion_smoothness_factor
 
uint16_t motion_direction
 
uint16_t base_predictor [2]
 
uint16_t inter_predictor [2]
 
uint16_t iir_filter_alpha
 
uint16_t flow_vector_internal_delay_num
 

Field Documentation

◆ vertical_search_range

uint16_t tivx_dmpac_dof_params_t::vertical_search_range[2]

Range [0, 62] Recommended = 48, 48 if horizontal_search_range is 191 then (vertical_search_range[0] (upward) + vertical_search_range[1] (downward) <= 112)

◆ horizontal_search_range

uint16_t tivx_dmpac_dof_params_t::horizontal_search_range

Range [0, 191] Recommended value = 191 if vertical_search_range[0] = vertical_search_range[1] = 62 then horizontal_search_range <= 170

◆ median_filter_enable

uint16_t tivx_dmpac_dof_params_t::median_filter_enable

0: Disabled; 1: Enable post-processing median filter [recommended]

◆ motion_smoothness_factor

uint16_t tivx_dmpac_dof_params_t::motion_smoothness_factor

Range [0, 31] recommended = 24

◆ motion_direction

uint16_t tivx_dmpac_dof_params_t::motion_direction

0 = Motion neutral, 5x5 Census Transform 1 = Forward motion 2 = Reverse motion 3 = Motion neutral, 7x Census Transform

◆ base_predictor

uint16_t tivx_dmpac_dof_params_t::base_predictor[2]

Predictor for the base image

◆ inter_predictor

uint16_t tivx_dmpac_dof_params_t::inter_predictor[2]

Predictor for the intermediate pyramid level

◆ iir_filter_alpha

uint16_t tivx_dmpac_dof_params_t::iir_filter_alpha

IIR filter alpha value recommended = 0x66

◆ flow_vector_internal_delay_num

uint16_t tivx_dmpac_dof_params_t::flow_vector_internal_delay_num

Number of internal delay slots to use for applying previous flow vector output to temporal predictor. The use of this field and the valid values it can take is as explained below:

  • Range [0 TIVX_DMPAC_DOF_MAX_FLOW_VECTOR_DELAY]
  • This field is validated and used only if temporal predictor is ON. This is a pre-condition for all the cases below. 1) When pipelining is OFF, then this field must be set to 0. The understanding is that with this configuration, external delay object shall be used for providing the input flow vector. 2) When pipelining is ON and if an external delay object is used, then this field must be set to 0. 3) When pipelining is ON and if no external delay object is used, then this field must be set to a valid non-zero value.

In case (3) above, the node stores pointers to the previous output flow vectors to be used as potential inputs later so it is important that under this configuration the higher level application does not alter the output buffer data in any way. Also, the node parameter must be configured with the buffer depth appropriately such that all the configured buffers are used and recycled during the pipelining operation.