快速ROI - FastROI

函数简介

快速ROI（Region of Interest）函数，返回图像中不为0的最大区域图像。此函数可以自动识别图像中的有效区域并返回该区域的图像指针，适用于图像预处理和目标检测等应用场景。

接口名称

FastROI

DLL调用

long FastROI(long instance, long ptr)

参数说明

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
ptr长整数型图像指针，由图像处理函数返回

示例

// 加载图像并进行快速ROI处理
long image = LoadImage(ola, "D:\\test\\image.png");
if (image != 0) {
    long roiImage = FastROI(ola, image);
    
    if (roiImage != 0) {
        // 显示ROI结果
        ShowImage(roiImage);
        
        // 释放ROI图像内存
        FreeImagePtr(ola, roiImage);
    }
    
    // 释放原图像内存
    FreeImagePtr(ola, image);
}

// 对截图进行快速ROI处理
long screen = GetScreenDataPtr(ola, 0, 0, 1920, 1080);
if (screen != 0) {
    long roiScreen = FastROI(ola, screen);
    
    if (roiScreen != 0) {
        printf("快速ROI处理完成\n");
        // 处理ROI结果
        
        FreeImagePtr(ola, roiScreen);
    }
    
    FreeImagePtr(ola, screen);
}

返回值

长整数型:

  • 成功：返回ROI图像对象的地址
  • 失败：返回0

注意事项

  • 返回的ROI图像为原图像中不为0的最大连通区域
  • 使用完ROI图像后需要调用 FreeImagePtr 接口进行内存释放
  • 此函数适用于图像预处理，可以自动去除图像边缘的无效区域
  • ROI区域基于图像中非零像素的连通性计算得出
  • 适用于需要提取图像主要内容的场景
Last Updated: