文档HOT
中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
提交
在线提单
论坛求助

Copy

该类接口将源图像缓冲区的像素值复制到目标图像缓冲区中。

函数接口声明如下：

  • 复制所有颜色通道的所有像素：

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

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

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

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

    HmppResult HMPPI_Copy_32f_C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C3R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_AC4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C3AC4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_AC4C3R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

  • 复制被蒙版标记的各通道的像素：

    HmppResult HMPPI_Copy_8u_C1MR(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

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

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

    HmppResult HMPPI_Copy_32s_C1MR(const int32_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_32f_C1MR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_8u_C3MR(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

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

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

    HmppResult HMPPI_Copy_32s_C3MR(const int32_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_32f_C3MR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_8u_C4MR(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

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

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

    HmppResult HMPPI_Copy_32s_C4MR(const int32_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_32f_C4MR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_8u_AC4MR(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

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

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

    HmppResult HMPPI_Copy_32s_AC4MR(const int32_t *src, int32_t srcStep, int32_t *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

    HmppResult HMPPI_Copy_32f_AC4MR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, const uint8_t *mask, int32_t maskStep);

  • 复制多通道图像中的选定通道的像素：

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

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

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

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

    HmppResult HMPPI_Copy_32f_C3CR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C4CR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

  • 复制所选通道的像素到单通道图像：

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

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

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

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

    HmppResult HMPPI_Copy_32f_C3C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C4C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

  • 复制单通道图像的像素到多通道图像：

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

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

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

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

    HmppResult HMPPI_Copy_32f_C1C3R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

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

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

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

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

    HmppResult HMPPI_Copy_32f_C1C4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize);

  • 分割多通道图像为多个单独的图像：

    HmppResult HMPPI_Copy_8u_C3P3R(const uint8_t *src, int32_t srcStep, uint8_t * const dst[3], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16u_C3P3R(const uint16_t *src, int32_t srcStep, uint16_t * const dst[3], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16s_C3P3R(const int16_t *src, int32_t srcStep, int16_t * const dst[3], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32s_C3P3R(const int32_t *src, int32_t srcStep, int32_t * const dst[3], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32f_C3P3R(const float *src, int32_t srcStep, float * const dst[3], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_8u_C4P4R(const uint8_t *src, int32_t srcStep, uint8_t * const dst[4], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16u_C4P4R(const uint16_t *src, int32_t srcStep, uint16_t * const dst[4], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16s_C4P4R(const int16_t *src, int32_t srcStep, int16_t * const dst[4], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32s_C4P4R(const int32_t *src, int32_t srcStep, int32_t * const dst[4], int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32f_C4P4R(const float *src, int32_t srcStep, float * const dst[4], int32_t dstStep, HmppiSize roiSize);

  • 合成多个单独的图像为多通道图像：

    HmppResult HMPPI_Copy_8u_P3C3R(const uint8_t * const src[3], int32_t srcStep, uint8_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16u_P3C3R(const uint16_t * const src[3], int32_t srcStep, uint16_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16s_P3C3R(const int16_t * const src[3], int32_t srcStep, int16_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32s_P3C3R(const int32_t * const src[3], int32_t srcStep, int32_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32f_P3C3R(const float * const src[3], int32_t srcStep, float * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_8u_P4C4R(const uint8_t * const src[4], int32_t srcStep, uint8_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16u_P4C4R(const uint16_t * const src[4], int32_t srcStep, uint16_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_16s_P4C4R(const int16_t * const src[4], int32_t srcStep, int16_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32s_P4C4R(const int32_t * const src[4], int32_t srcStep, int32_t * const dst, int32_t dstStep, HmppiSize roiSize);

    HmppResult HMPPI_Copy_32f_P4C4R(const float * const src[4], int32_t srcStep, float * const dst, int32_t dstStep, HmppiSize roiSize);

参数

参数名

描述

取值范围

输入/输出

src

指向源图像感兴趣区域的指针。

非空

输入

srcStep

源图像中连续行的起点之间的距离（以字节为单位）。

非负整数

输入

dst

指向目的图像感兴趣区域的指针。

非空

输出

dstStep

目标图像中连续行的起点之间的距离（以字节为单位）。

非负整数

输入

roiSize

源和目标图像感兴趣区域的大小（以像素为单位）。

roiSize.width∈(0, INT_MAX]，roiSize.height∈(0, INT_MAX]

输入、输出

mask

指向蒙版图像缓冲区的指针。

非空

输入

maskStep

蒙版图像缓冲区中连续起点之间的距离（以字节为单位）。

非负整数

输入

返回值

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

错误码

错误码

描述

HMPP_STS_NULL_PTR_ERR

src、dst这两个入参中存在空指针。

HMPP_STS_SIZE_ERR

roiSize的字段为零或负值。

HMPP_STS_STEP_ERR

srcStep、dstStep中存在零或负值。

HMPP_STS_NOT_EVEN_STEP_ERR

srcStep、dstStep不能被src、dst所属数据类型的字节长度整除的错误条件。

HMPP_STS_ROI_ERR

roiSize.width大于步长。

示例

#define SRC_BUFFER_SIZE_T 90
#define DST_BUFFER_SIZE_T 90

int CopyExample()
{
    HmppiSize roi = { 4, 5 };
    const uint8_t src[SRC_BUFFER_SIZE_T] = {
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33, 
        11, 22, 33, 44, 55, 66, 77, 88, 22, 88, 77, 66, 55, 44, 33
    };
    uint8_t dst[DST_BUFFER_SIZE_T] = {0};
    int32_t srcStep = 15 * sizeof(uint8_t);
    int32_t dstStep = 18 * sizeof(uint8_t);
    HmppResult result = HMPPI_Copy_8u_C3AC4R(src, srcStep, dst, dstStep, roi);

    printf("result = %d \ndst = ", result);
    if (result != HMPP_STS_NO_ERR) {
        printf("result error: %d\n", result);
    }
    int32_t dstWidth = dstStep / sizeof(uint8_t);
    for (int32_t i = 0; i < DST_BUFFER_SIZE_T; i++) {
        if( i % dstWidth == 0 ){
            printf("\n");
        }
        printf("%3d ",dst[i]);       
    }
    printf("\n");
    return 0;
}

运行结果：

result = 0
dst = 
 11  22  33   0  44  55  66   0  77  88  22   0  88  77  66   0   0   0 
 11  22  33   0  44  55  66   0  77  88  22   0  88  77  66   0   0   0 
 11  22  33   0  44  55  66   0  77  88  22   0  88  77  66   0   0   0 
 11  22  33   0  44  55  66   0  77  88  22   0  88  77  66   0   0   0 
 11  22  33   0  44  55  66   0  77  88  22   0  88  77  66   0   0   0 
  0   0   0   0   0   0   0   0   0   0
父主题： 基础运算