Scale

此类接口功能是缩放图像的像素值并将它们转换为另一种位深度。

函数接口声明如下：

单通道数据的缩放操作：
HmppResult HMPPI_Scale_8u16u_C1R(const uint8_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u16s_C1R(const uint8_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32s_C1R(const uint8_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32f_C1R(const uint8_t *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);

HmppResult HMPPI_Scale_16u8u_C1R(const uint16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_16s8u_C1R(const int16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32s8u_C1R(const int32_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32f8u_C1R(const float *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);
多通道数据的缩放操作：
HmppResult HMPPI_Scale_8u16u_C3R(const uint8_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u16s_C3R(const uint8_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32s_C3R(const uint8_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32f_C3R(const uint8_t *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);

HmppResult HMPPI_Scale_16u8u_C3R(const uint16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_16s8u_C3R(const int16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32s8u_C3R(const int32_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32f8u_C3R(const float *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);
HmppResult HMPPI_Scale_8u16u_C4R(const uint8_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u16s_C4R(const uint8_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32s_C4R(const uint8_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32f_C4R(const uint8_t *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);

HmppResult HMPPI_Scale_16u8u_C4R(const uint16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_16s8u_C4R(const int16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32s8u_C4R(const int32_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32f8u_C4R(const float *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, float vMin, float vMax);

HmppResult HMPPI_Scale_8u16u_AC4R(const uint8_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u16s_AC4R(const uint8_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_8u32s_AC4R(const uint8_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize);

HmppResult HMPPI_Scale_16u8u_AC4R(const uint16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_16s8u_AC4R(const int16_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

HmppResult HMPPI_Scale_32s8u_AC4R(const int32_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppHintAlgorithm hint);

参数

参数名	描述	取值范围	输入/输出
src	指向源图像感兴趣区域的指针。	非空	输入
srcStep	源图像中连续行起点之间的距离（以字节为单位）。	非负整数	输入
dst	指向目标图像感兴趣区域的指针。	非空	输入、输出
dstStep	目标图像中连续行的起点之间的距离（以字节为单位）。	非负整数	输入
vMin	输入数据的最小值。	可通过HMPPI_Min_*类接口获取	输入
vMax	输入数据的最大值。	可通过HMPPI_Min_*类接口获取	输入
hint	函数的算法实现方式。	HmppHintAlgorithm的枚举值之一	输入
roiSize	源和目标图像感兴趣区域的大小（以像素为单位）。	roiSize.width∈(0, INT_MAX]，roiSize.height∈(0, INT_MAX]	输入
cmpOp	指定用于比较像素值和阈值的操作。可以使用“大于”或“小于”的比较。	HMPP_CMP_LT，HMPP_CMP_GT	输入

返回值

成功：返回HMPP_STS_NO_ERR。
失败：返回错误码。

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src中存在空指针。
HMPP_STS_SIZE_ERR	roiSize的字段为零或负值。
HMPP_STS_STEP_ERR	srcStep中存在零或负值。
HMPP_STS_ROI_ERR	roiSize的width与通道数乘积大于步长srcStep。
HMPP_STS_NOT_EVEN_STEP_ERR	srcStep不能被src所属数据类型的字节长度整除的错误条件。
HMPP_STS_SCALE_RANGE_ERR	当vMin > vMax时返回错误。
HMPP_STS_NOT_SUPPORTED_MODE_ERR	不支持的比较模式。
HMPP_STS_NO_ERR	返回值正确，任何其他值表示错误或警告。

示例

void ScaleExample()
{
    HmppiSize roi = {5,4};
    uint8_t src[60] = {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,
                       1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,
                        1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,
                        1,2,3,4,5,6,7,8,9,10,11,12,13,14,15
                               };
    int16_t dst[72] = {0};
    int32_t srcStep=15*sizeof(uint8_t);
    int32_t dstStep=18*sizeof(int16_t);
    HMPPI_Scale_8u16s_C3R(src, srcStep, dst, dstStep, roi);
 
    for(int i=0; i< 4; ++i){
        for(int j=0;j<18;++j){
          printf( "%d ", dst[i*18 + j]);
        }
        printf(“\n”);
    }
}

int main(){
    ScaleExample();
    return 0;
}

运行结果：

-32511 -32254 -31997 -31740 -31483 -31226 -30969 -30712 -30455 -30198 -29941 -29684 -29427 -29170 -28913 0 0 0 
-32511 -32254 -31997 -31740 -31483 -31226 -30969 -30712 -30455 -30198 -29941 -29684 -29427 -29170 -28913 0 0 0

父主题： 基础运算