Warp Initializer IP Descriptor Structure - 1.1 English

The Warp Initializer IP descriptor should be placed in external memory in the following format. The address of this descriptor is provided to the IP through the Descriptor Address register and the IP reads the descriptor from this address. The descriptor is a tightly packed structure of size 144 bytes in memory.

typedef struct {
	u16 width;
	u16 height;
	u16 bytes_per_pixel;
	u8 reserved_0[2];
	u64 filter_table_addr_0;
	u64 filter_table_addr_1;
	u32 width_Q4;
	u32 height_Q4;
	s16 k_pre;
	s16 k_post;
	u16 k0_pre;
	u16 k1_pre;
	u16 k0_post;
	u16 k1_post;
	u32 Q_fact_pre;
	u32 Q_fact_post;
	s8 k0_pre_Q_bits;
	s8 k0_post_Q_bits;
	s8 k1_pre_Q_bits;
	s8 k1_post_Q_bits;
	s16 h[6];
	s32 h_trans[3];
	u8 h_Qbits[6];
	u8 reserved_1[2];
	u32 normfactor;
	u16 cenX;
	u16 cenY;
	u32 num_ctrl_pts;
	u64 src_ctrl_x_pts;
	u64 src_ctrl_y_pts;
	u64 src_tangents_x;
	u64 src_tangents_y;
	u64 interm_x;
	u64 interm_y;
	u8 warp_type;
	u8 reserved_2[3];
	u32 valid_segs;
	u32 lblk_count;
	u32 line_num_seg;
} XVWarpInitVector_Hw;
S8 : Signed 8 bit
S16: Signed 16 bit
U8 : Unsigned 8 bit
U16: Unsigned 16 bit
U32: Unsigned 32 bit
U64: Unsigned 64 bit

The fields in the descriptor are explained in the following table:

This descriptor is filled in the driver based on the user input configuration. Provide the following input configuration structure to the driver.

typedef struct {
	            int frame_width;
	            int frame_height;
	            int warp_type;
	            float pre_fisheye;
	            float post_fisheye;
	            int left_top_x;
	            int left_top_y;
	            int right_top_x;
	            int right_top_y;
	            int left_bottom_x;
	            int left_bottom_y;
	            int right_bottom_x;
	            int right_bottom_y;
	            float scale_x;
	            float scale_y;
	            float rotation;
	            float trans_x;
	            float trans_y;
	            float zoom;
	            int num_ctrl_pts;
	            XVWarpInit_ArbParam_MeshInfo *ctrl_pts;
} WARP_CFG;

The following figures show the effect of these values on a 3840x2160 image.

Figure 1. post_fisheye = -2.0, scale_x = 0.75, scale_y = 0.75