拼接图片 - ConcatImage
函数简介
将两张图片拼接成一张新图片。此函数可以将两张图片按照指定的方向（水平或垂直）拼接在一起，生成一张新的图片。常用于图片合成、长图制作、图片对比等场景。支持不同尺寸图片的拼接，可以自动调整对齐方式。
接口名称
ConcatImage
DLL调用
long ConcatImage(long ola, long image_ptr1, long image_ptr2, int gap, string color, int direction)
参数定义:
ola(长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。image_ptr1(长整型数): 第一张图片的句柄。image_ptr2(长整型数): 第二张图片的句柄。gap(整型数): 两张图片之间的间隙color(字符串型) : 填充两张图片之间的间隙的颜色direction(整型数): 拼接方向：- 0: 水平拼接（左右）
- 1: 垂直拼接（上下）
示例:
// 加载两张图片
long image1 = LoadImage(ola, "D:\\test\\left.png");
long image2 = LoadImage(ola, "D:\\test\\right.png");
if (image1 != 0 && image2 != 0) {
// 水平拼接（左右）
long horizontal = ConcatImage(ola, image1, image2, 3, "#FFFFFF", 0);
if (horizontal != 0) {
SaveImageFromPtr(ola, horizontal, "D:\\test\\horizontal.png");
printf("水平拼接完成\n");
FreeImagePtr(ola, horizontal);
}
// 垂直拼接（上下）
long vertical = ConcatImage(ola, image1, image2, 3, "#FFFFFF", 1);
if (vertical != 0) {
SaveImageFromPtr(ola, vertical, "D:\\test\\vertical.png");
printf("垂直拼接完成\n");
FreeImagePtr(ola, vertical);
}
// 释放原图内存
FreeImagePtr(ola, image1);
FreeImagePtr(ola, image2);
}
// 多图片拼接示例（制作长图）
void CreateLongImage(const char** image_paths, int count, const char* output_path) {
if (count < 2) return;
// 加载第一张图片
long result = LoadImage(ola, image_paths[0]);
if (result == 0) return;
// 依次拼接其他图片
for (int i = 1; i < count; i++) {
long next = LoadImage(ola, image_paths[i]);
if (next != 0) {
long temp = ConcatImage(ola, result, next, 1); // 垂直拼接
FreeImagePtr(ola, result);
FreeImagePtr(ola, next);
result = temp;
}
}
// 保存结果
if (result != 0) {
SaveImageFromPtr(ola, result, output_path);
FreeImagePtr(ola, result);
}
}
// 制作图片对比（左右对比）
void CreateComparisonImage(const char* before_path, const char* after_path, const char* output_path) {
long before = LoadImage(ola, before_path);
long after = LoadImage(ola, after_path);
if (before != 0 && after != 0) {
// 确保两张图片高度相同
int width1, height1, width2, height2;
GetImageSize(ola, before, &width1, &height1);
GetImageSize(ola, after, &width2, &height2);
if (height1 != height2) {
// 调整高度
int target_height = height1 < height2 ? height1 : height2;
long resized_before = ReSize(ola, before, width1 * target_height / height1, target_height);
long resized_after = ReSize(ola, after, width2 * target_height / height2, target_height);
if (resized_before != 0 && resized_after != 0) {
// 水平拼接调整后的图片
long comparison = ConcatImage(ola, resized_before, resized_after, 0);
if (comparison != 0) {
SaveImageFromPtr(ola, comparison, output_path);
FreeImagePtr(ola, comparison);
}
FreeImagePtr(ola, resized_before);
FreeImagePtr(ola, resized_after);
}
} else {
// 直接水平拼接
long comparison = ConcatImage(ola, before, after, 0);
if (comparison != 0) {
SaveImageFromPtr(ola, comparison, output_path);
FreeImagePtr(ola, comparison);
}
}
FreeImagePtr(ola, before);
FreeImagePtr(ola, after);
}
}
COM调用
long ConcatImage(long image_ptr1, long image_ptr2, int gap, string color, int direction)
参数定义:
image_ptr1(长整型数): 第一张图片的句柄。image_ptr2(长整型数): 第二张图片的句柄。gap(整型数): 两张图片之间的间隙color(字符串型) : 填充两张图片之间的间隙的颜色direction(整型数): 拼接方向：- 0: 水平拼接（左右）
- 1: 垂直拼接（上下）
示例:
# 加载两张图片
image1 = ola.LoadImage("D:\\test\\left.png")
image2 = ola.LoadImage("D:\\test\\right.png")
if image1 != 0 and image2 != 0:
# 水平拼接（左右）
horizontal = ola.ConcatImage(image1, image2, 3, "#FFFFFF", 0)
if horizontal != 0:
ola.SaveImageFromPtr(horizontal, "D:\\test\\horizontal.png")
messagebox("水平拼接完成")
ola.FreeImagePtr(horizontal)
# 垂直拼接（上下）
vertical = ola.ConcatImage(image1, image2, 1)
if vertical != 0:
ola.SaveImageFromPtr(vertical, "D:\\test\\vertical.png")
messagebox("垂直拼接完成")
ola.FreeImagePtr(vertical)
# 释放原图内存
ola.FreeImagePtr(image1)
ola.FreeImagePtr(image2)
# 多图片拼接示例（制作长图）
def create_long_image(image_paths, output_path):
if len(image_paths) < 2:
return
# 加载第一张图片
result = ola.LoadImage(image_paths[0])
if result == 0:
return
# 依次拼接其他图片
for path in image_paths[1:]:
next_image = ola.LoadImage(path)
if next_image != 0:
temp = ola.ConcatImage(result, next_image, 3, "#FFFFFF", 1) # 垂直拼接
ola.FreeImagePtr(result)
ola.FreeImagePtr(next_image)
result = temp
# 保存结果
if result != 0:
ola.SaveImageFromPtr(result, output_path)
ola.FreeImagePtr(result)
# 制作图片对比（左右对比）
def create_comparison_image(before_path, after_path, output_path):
before = ola.LoadImage(before_path)
after = ola.LoadImage(after_path)
if before != 0 and after != 0:
# 确保两张图片高度相同
width1 = height1 = width2 = height2 = 0
ola.GetImageSize(before, width1, height1)
ola.GetImageSize(after, width2, height2)
if height1 != height2:
# 调整高度
target_height = min(height1, height2)
resized_before = ola.ReSize(before, width1 * target_height // height1, target_height)
resized_after = ola.ReSize(after, width2 * target_height // height2, target_height)
if resized_before != 0 and resized_after != 0:
# 水平拼接调整后的图片
comparison = ola.ConcatImage(resized_before, resized_after, 0)
if comparison != 0:
ola.SaveImageFromPtr(comparison, output_path)
ola.FreeImagePtr(comparison)
ola.FreeImagePtr(resized_before)
ola.FreeImagePtr(resized_after)
else:
# 直接水平拼接
comparison = ola.ConcatImage(before, after, 0)
if comparison != 0:
ola.SaveImageFromPtr(comparison, output_path)
ola.FreeImagePtr(comparison)
ola.FreeImagePtr(before)
ola.FreeImagePtr(after)
返回值
长整型数:
- 0: 拼接失败
- 非0: 拼接成功，返回新图片的句柄
注意事项
- 水平拼接时，两张图片的高度最好相同，否则会以较小的高度为准
- 垂直拼接时，两张图片的宽度最好相同，否则会以较小的宽度为准
- 拼接后会返回新的图片句柄，原图片不会被修改
- 新图片句柄使用完后需要调用 FreeImagePtr 释放内存
- 如果需要在拼接前调整图片大小，可以配合使用 ReSize 或 ScalePixels 函数