释放指定图片内存 - FreeImagePtr

函数简介

释放指定图片句柄占用的内存。当不再需要使用某个图片时，必须调用此函数释放其占用的内存，否则会造成内存泄漏。此函数通常与 LoadImage 等图片加载函数配对使用。

接口名称

FreeImagePtr

DLL调用

int FreeImagePtr(long ola, long image_ptr)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • image_ptr (长整型数): 要释放的图片句柄，由图片加载函数返回。

示例:

// 加载并使用图片，然后释放内存
long image = LoadImage(ola, "D:\\test\\sample.png");
if (image != 0) {
    // 使用图片进行操作
    int width, height;
    GetImageSize(ola, image, &width, &height);
    printf("图片大小：%d x %d\n", width, height);
    
    // 操作完成后释放内存
    int ret = FreeImagePtr(ola, image);
    if (ret == 1) {
        printf("图片内存释放成功\n");
    } else {
        printf("图片内存释放失败\n");
    }
}

// 批量处理图片示例
long images[10];
int count = 0;

// 加载多张图片
for (int i = 0; i < 10; i++) {
    char path[100];
    sprintf(path, "D:\\test\\pic%d.png", i);
    images[count] = LoadImage(ola, path);
    if (images[count] != 0) {
        count++;
    }
}

// 使用图片进行处理
// ...

// 释放所有加载的图片
for (int i = 0; i < count; i++) {
    FreeImagePtr(ola, images[i]);
}

COM调用

int FreeImagePtr(long image_ptr)

参数定义:

  • image_ptr (长整型数): 要释放的图片句柄，由图片加载函数返回。

示例:

# 加载并使用图片，然后释放内存
image = ola.LoadImage("D:\\test\\sample.png")
if image != 0:
    # 使用图片进行操作
    width = height = 0
    ola.GetImageSize(image, width, height)
    messagebox(f"图片大小：{width} x {height}")
    
    # 操作完成后释放内存
    ret = ola.FreeImagePtr(image)
    if ret == 1:
        messagebox("图片内存释放成功")
    else:
        messagebox("图片内存释放失败")

# 批量处理图片示例
images = []

# 加载多张图片
for i in range(10):
    image = ola.LoadImage(f"D:\\test\\pic{i}.png")
    if image != 0:
        images.append(image)

# 使用图片进行处理
# ...

# 释放所有加载的图片
for image in images:
    ola.FreeImagePtr(image)

返回值

整型数:

  • 0: 释放失败
  • 1: 释放成功

注意事项

  1. 必须对每个成功加载的图片调用此函数进行释放，否则会造成内存泄漏
  2. 不要重复释放同一个图片句柄，这可能导致程序崩溃
  3. 释放后的图片句柄不能再使用，需要重新加载
  4. 如果需要释放所有已加载的图片，可以使用 FreeImageAll 函数
  5. 对于通过 LoadImagePath 加载的图片，应使用 FreeImagePath 函数释放
Last Updated: