Leptonica (Hypercube定制版) 镜像文档

镜像概述和主要用途

本镜像为Hypercube环境定制构建Leptonica库，基于开源图像处理库Leptonica进行针对性编译优化，旨在为Hypercube镜像提供稳定、适配的底层图像处理能力。Leptonica作为轻量级图像处理工具集，主要用于图像扫描、二值化、缩放、旋转等基础操作，是Hypercube相关应用的核心依赖组件之一。

核心功能和特性

• 定制化构建：针对Hypercube运行环境编译参数优化，确保与Hypercube其他组件的兼容性
• 基础图像处理：支持图像格式转换、二值化、降噪、几何变换（缩放、旋转、裁剪）等核心操作
• 轻量级设计：剔除非必要模块，减小镜像体积，适合容器化部署
• 稳定兼容：基于Leptonica稳定版本构建，经过兼容性测试验证

使用场景和适用范围

• Hypercube应用开发：作为底层依赖集成至Hypercube应用镜像，提供图像处理基础能力
• 文档处理工具：支持扫描文档图像预处理、OCR前置处理等场景
• 图像分析应用：适用于需要基础图像操作的轻量化分析工具开发

使用方法和配置说明

作为基础镜像引用

在Dockerfile中直接引用本镜像作为构建基础：

dockerfile
FROM hypercube-leptonica:latest
# 后续应用构建步骤...

作为依赖组件集成

在Hypercube应用镜像中通过COPY --from指令引入：

dockerfile
FROM hypercube-base:latest
COPY --from=hypercube-leptonica:latest /usr/local/lib/lib lept* /usr/local/lib/
COPY --from=hypercube-leptonica:latest /usr/local/include/leptonica /usr/local/include/leptonica
# 配置动态链接库路径
ENV LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

环境变量配置

目前无特殊环境变量需配置，默认编译配置已针对Hypercube环境优化，包含以下关键特性：

• 启用PNG/JPEG格式支持
• 关闭Tiff扩展（Hypercube环境专用优化）
• 启用线程安全模式

验证安装

容器内可通过以下命令验证Leptonica版本：

bash
leptonica-version