解压缩字符串成二值化图像 - BitUnpacking

函数简介

将压缩后的字符串解压缩还原为二值化图像。此函数可以将 BitPacking 函数压缩生成的字符串解压缩，还原为原始的二值化图像。适用于从存储或网络传输中恢复图像数据。

接口名称

BitUnpacking

DLL调用

long BitUnpacking(long instance, string imageStr)

参数定义:

  • instance (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • imageStr (字符串): BitPacking压缩结果字符串。

示例:

// 从压缩字符串解压缩图像
long compressed_str = BitPacking(ola, original_image);
if (compressed_str != 0) {
    // 获取压缩字符串内容
    // ... 获取字符串内容到 imageStr 变量 ...
    
    // 解压缩图像
    long restored_image = BitUnpacking(ola, imageStr);
    if (restored_image != 0) {
        printf("图像解压缩成功，句柄：%ld\n", restored_image);
        
        // 保存解压缩后的图像
        SaveImageFromPtr(ola, restored_image, "D:\\test\\restored_image.png");
        
        // 释放图像内存
        FreeImagePtr(ola, restored_image);
    }
    
    // 释放压缩字符串内存
    FreeStringPtr(ola, compressed_str);
}

// 从文件读取压缩字符串并解压缩
void UnpackImageFromFile(const char* compressed_file) {
    // 读取压缩字符串文件
    FILE* fp = fopen(compressed_file, "rb");
    if (fp != NULL) {
        fseek(fp, 0, SEEK_END);
        long file_size = ftell(fp);
        fseek(fp, 0, SEEK_SET);
        
        char* image_str = (char*)malloc(file_size + 1);
        fread(image_str, 1, file_size, fp);
        image_str[file_size] = '\0';
        fclose(fp);
        
        // 解压缩图像
        long image = BitUnpacking(ola, image_str);
        if (image != 0) {
            SaveImageFromPtr(ola, image, "D:\\test\\unpacked.png");
            FreeImagePtr(ola, image);
        }
        
        free(image_str);
    }
}

// 压缩和解压缩的完整流程
void CompressAndUnpack(long image) {
    // 压缩图像
    long compressed = BitPacking(ola, image);
    if (compressed != 0) {
        // 获取压缩字符串
        // ... 处理压缩字符串 ...
        
        // 解压缩验证
        long unpacked = BitUnpacking(ola, imageStr);
        if (unpacked != 0) {
            printf("压缩和解压缩成功\n");
            FreeImagePtr(ola, unpacked);
        }
        
        FreeStringPtr(ola, compressed);
    }
}

返回值

长整型数:

  • 0: 解压缩失败
  • 非0: 解压缩成功，返回图像句柄

注意事项

  1. 输入的字符串必须是 BitPacking 函数压缩生成的有效字符串
  2. 解压缩后的图像是二值化图像，只包含黑白两种颜色
  3. 解压缩成功后会返回新的图像句柄，需要调用 FreeImagePtr 释放内存
  4. 如果压缩字符串损坏或格式不正确，解压缩会失败并返回0
  5. 此函数与BitPacking配合使用，可以实现图像的压缩存储和传输
Last Updated: