浅拷贝裁剪 - CroppedRef

函数简介

对图像进行浅拷贝裁剪，与 裁剪图片 - Cropped 不同：返回区域与父图共享底层像素数据（ROI 视图），不单独复制像素。

接口名称

CroppedRef

DLL调用

long CroppedRef(long ola, long image, int x1, int y1, int x2, int y2);

参数说明

参数名	类型	说明
ola	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
image	长整数型	图像句柄。
x1	整数型	裁剪区域左上角 X。
y1	整数型	裁剪区域左上角 Y。
x2	整数型	裁剪区域右下角 X。
y2	整数型	裁剪区域右下角 Y。

示例

C++

long instance = CreateCOLAPlugInterFace();
long img = GetScreenDataPtr(instance, 0, 0, 0, 0);
long roi = CroppedRef(instance, img, 10, 10, 200, 200);
if (roi != 0) {
    // 使用 ROI；修改 roi 会影响 img 对应区域
}
// 释放父图后 ROI 句柄随之失效；勿在释放父图后继续使用 roi
FreeImagePtr(instance, img);

Python

# 待补充

返回值

长整数型：裁剪后的图像句柄；失败返回 0。

注意事项

• 返回的是 ROI 视图，修改返回图像会影响原图。
• 返回句柄与父图像句柄关联；父图像释放时，该浅拷贝句柄会自动失效，请勿再继续使用。