Mean
此函数功能是计算图像像素平均值。对于多通道图像，均值是在每个通道中分别计算，并将结果保存在对应通道数组中。
函数接口声明如下：
- 单通道均值：
HmppResult HMPPI_Mean_8u_C1R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, double *mean);
HmppResult HMPPI_Mean_16u_C1R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, double *mean);
HmppResult HMPPI_Mean_16s_C1R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, double *mean);
HmppResult HMPPI_Mean_32f_C1R(const float *src, int32_t srcStep, HmppiSize roiSize, double *mean, HmppHintAlgorithm hint);
- 带蒙版的单通道均值：
HmppResult HMPPI_Mean_8u_C1MR(const uint8_t *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, double *mean);
HmppResult HMPPI_Mean_16u_C1MR(const uint16_t *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, double *mean);
HmppResult HMPPI_Mean_32f_C1MR(const float *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, double *mean);
- 三通道均值
HmppResult HMPPI_Mean_8u_C3R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, double mean[3]);
HmppResult HMPPI_Mean_16u_C3R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, double mean[3]);
HmppResult HMPPI_Mean_16s_C3R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, double mean[3]);
HmppResult HMPPI_Mean_32f_C3R(const float *src, int32_t srcStep, HmppiSize roiSize, double mean[3], HmppHintAlgorithm hint);
- 带蒙版和COI的多通道均值：
HmppResult HMPPI_Mean_8u_C3CMR(const uint8_t *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, int32_t coi, double *mean);
HmppResult HMPPI_Mean_16u_C3CMR(const uint16_t *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, int32_t coi, double *mean);
HmppResult HMPPI_Mean_32f_C3CMR(const float *src, int32_t srcStep, const uint8_t *mask, int32_t maskStep, HmppiSize roiSize, int32_t coi, double *mean);
- 四通道均值：
HmppResult HMPPI_Mean_8u_C4R(const uint8_t *src, int32_t srcStep, HmppiSize roiSize, double mean[4]);
HmppResult HMPPI_Mean_16u_C4R(const uint16_t *src, int32_t srcStep, HmppiSize roiSize, double mean[4]);
HmppResult HMPPI_Mean_16s_C4R(const int16_t *src, int32_t srcStep, HmppiSize roiSize, double mean[4]);
HmppResult HMPPI_Mean_32f_C4R(const float *src, int32_t srcStep, HmppiSize roiSize, double mean[4], HmppHintAlgorithm hint);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
src |
指向源图像感兴趣区域的指针。 |
非空 |
输入 |
srcStep |
源图像中连续行起点之间的距离（以字节为单位）。 |
非负整数 |
输入 |
roiSize |
源和目标图像感兴趣区域的大小（以像素为单位）。 |
roiSize.width∈(0, INT_MAX]，roiSize.height∈(0, INT_MAX] |
输入 |
mean[] |
保存源图像各通道平均像素值的数组（用于多通道函数）。 |
源图像像素数据类型取值范围 |
输入/输出 |
返回值
- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
HMPP_STS_NULL_PTR_ERR |
src中存在空指针。 |
HMPP_STS_SIZE_ERR |
roiSize的width、height存在零或负值。 |
HMPP_STS_STEP_ERR |
srcStep中存在零或负值。 |
HMPP_STS_NOT_EVEN_STEP_ERR |
srcStep不能被src所属数据类型的字节长度整除的错误条件。 |
HMPP_STS_ROI_ERR |
roiSize.width > 步长。 |
HMPP_STS_COI_ERR |
coi不是1、2、3。 |
示例
void MeanExample()
{
HmppiSize roi = {3, 4};
uint8_t src[9 * 4] = {1, 1, 1, 2, 2, 2, 3, 3, 3,
4, 4, 4, 5, 5, 5, 6, 6, 6,
7, 7, 7, 8, 8, 8, 9, 9, 9,
10, 10, 10, 11, 11, 11, 12, 12, 12};
int32_t srcStep =9*sizeof(uint8_t);
double mean[3] = {0.0};
int32_t i;
HmppResult result =HMPPI_Mean_8u_C3R(src, srcStep, roi, mean);
printf("result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
for(i =0; i <3; i++) {
printf("%lf ", mean[i]);
}
printf("\n");
}
运行结果：
result = 0 6.500000 6.500000 6.500000