功能介绍

对输入的图像进行色域转换操作，输出到Image对象中。

接口说明请参考ConvertFormat。

接口调用流程

使用色域转换接口前，用户需准备好被转换的图片对象。

图1 图像处理（色域转换）接口调用流程

关键步骤说明如下：

调用MxInit()接口进行全局初始化。
ImageProcessor初始化。
用户构造ImageProcessor对象，之后可以调用InitVpcChannel()初始化通道，若不调用该接口，ImageProcessor会在执行色域转换前自动进行通道初始化。
使用图片解码接口对输入图片进行解码。
根据业务对图片进行解码，生成可进行色域转换的Image对象。后续可以通过图像处理接口对图片进行处理，生成最终需要进行色域转换的Image对象。
构造输出的Image对象。
通过Image构造函数构造用于存放色域转换结果的Image对象。
调用ConvertFormat()对输入图片进行色域转换。
调用MxDeInit()接口对初始化的全局资源进行去初始化。

示例代码

以下为功能特性关键步骤的代码示例，不可以直接拷贝编译运行，仅供参考。

//初始化
MxInit();
{
    //构造图像处理类
    ImageProcessor imageProcessor(deviceId);

    //图像解码生成Image
    //解码后的图像类
    Image decodedImage;

    //根据图像路径进行解码
    APP_ERROR ret = imageProcessor.Decode(imagePath, decodedImage);
    if (ret != APP_ERR_OK) {
        std::cout << "Decode failed." << std::endl;
    }

    //（可选）初始化图像处理通道
    imageProcessor.InitVpcChannel();

    //执行色域转换
    //色域转换操作后图像类
    Image convertImage;

    //执行色域转换操作
    ret = imageProcessor.ConvertFormat(decodedImage, ImageFormat::RGB_888, convertImage);
    if (ret != APP_ERR_OK) {
        std::cout << "ConvertFormat failed." << std::endl;
    }
}
//去初始化
MxDeInit();