矩阵缩放

CSI-DSP Version 1.0.0

CSI DSP Software Library

函数
csky_status	csky_mat_scale_f32 (const csky_matrix_instance_f32 pSrc, float32_t scale, csky_matrix_instance_f32 pDst)
	浮点矩阵缩放更多...

csky_status	csky_mat_scale_q15 (const csky_matrix_instance_q15 pSrc, q15_t scaleFract, int32_t shift, csky_matrix_instance_q15 pDst)
	Q15 矩阵缩放更多...

csky_status	csky_mat_scale_q31 (const csky_matrix_instance_q31 pSrc, q31_t scaleFract, int32_t shift, csky_matrix_instance_q31 pDst)
	Q31 矩阵缩放更多...

简要说明

矩阵与标量相乘，矩阵中的每个元素都与一个标量相乘比如:

一个 3 x 3 矩阵缩放

函数的大小检查确保输入和输出矩阵的大小相同。

Q15和Q31的定点函数, scale 表示为一个小数乘法 scaleFract 和一个移位 shift. 移位让缩放操作的增益可以超过1.0。定点数据的总的缩放因子是：

    scale = scaleFract * 2^shift.

函数说明

csky_status csky_mat_scale_f32	(	const csky_matrix_instance_f32 *	pSrc,
		float32_t	scale,
		csky_matrix_instance_f32 *	pDst
	)

参数

[in]	*pSrc	指向输入矩阵结构体
[in]	scale	缩放因子
[out]	*pDst	指向输出矩阵结构体

返回: 函数根据大小检查返回 CSKY_MATH_SIZE_MISMATCH 或者 CSKY_MATH_SUCCESS

csky_status csky_mat_scale_q15	(	const csky_matrix_instance_q15 *	pSrc,
		q15_t	scaleFract,
		int32_t	shift,
		csky_matrix_instance_q15 *	pDst
	)

参数

[in]	*pSrc	指向输入矩阵
[in]	scaleFract	缩放因子的小数部分
[in]	shift	结果的移位数量
[out]	*pDst	指向输出矩阵结构体

返回: 函数根据大小检查，返回 CSKY_MATH_SIZE_MISMATCH 或者 CSKY_MATH_SUCCESS

缩放和溢出行为:

: 输入数据 *pSrc 和 scaleFract 都是1.15格式. 它们相乘的生成 2.30 的中间结果，然后移位和饱和成1.15格式

csky_status csky_mat_scale_q31	(	const csky_matrix_instance_q31 *	pSrc,
		q31_t	scaleFract,
		int32_t	shift,
		csky_matrix_instance_q31 *	pDst
	)

参数

[in]	*pSrc	指向输入矩阵
[in]	scaleFract	缩放因子的小数部分
[in]	shift	结果的移位数量
[out]	*pDst	指向输出矩阵结构体

返回: 函数根据大小检查，返回 CSKY_MATH_SIZE_MISMATCH 或者 CSKY_MATH_SUCCESS

缩放和溢出行为:

: 输入数据 *pSrc 和 scaleFract 都是1.31格式. 它们相乘的生成 2.62 的中间结果，然后移位和饱和成1.31格式