#image

#🏆 OSC 2026 参赛声明

#🧬 自演化工程体系（独家）

• 可执行测试生成：按模块特征自动生成测试用例并接入四目标回归
• 退化自动修复：性能/正确性退化检测 → 传播链可视化 → 修复建议 → 应用闭环
• 管道优化：算子等价性检查 + 冗余消除 + 相邻算子合并（v276）
• grill-me 拷问引擎：领域规则可执行化，对工程产出做对抗性审查（v279）
• 演化推荐引擎：根据当前状态推荐下一步演化方向（v298）
• 覆盖盲区分析：自动定位测试覆盖盲区（v297）

意义：评审看到的每个版本测试数增长（3378 → 6574）背后，有一条可复现的自动化工程流水线——这是"工程质量"维度最硬的证据，也是 stb_image.h 等 C 参照项目不具备的能力。

🌱 生态采用：已被 moonrockz/diagrams-raster 依赖

#✨ 亮点

#🟢 零 C 依赖

#🟢 四目标原生

#🟢 18 种格式

#🟢 三种像素深度

#🟢 OCR 全链路

#🟢 安全加固

#🟢 形式化验证

#🟢 MoonBit 属性系统

#🟢 71 个子包

#🖼️ 格式支持 · 18 种

#🚀 快速上手

#安装

moon add walkzzz/image

🧩 子模块按需安装（0.6.0 起，workspace 六模块独立发布）：moon add walkzzz/codec 只装 18 格式编解码；moon add walkzzz/process 只装 90+ 算法子包；core / photography / vision / domain 同理。

#30 秒示例

import "walkzzz/core/types"
import "walkzzz/codec/lib"
import "walkzzz/process/filter"
import "walkzzz/process/transform"

// 解码 — 自动检测 18 种格式
let img : Image = @lib.load_from_bytes_auto(data)

// 处理 — 滤波 / 缩放 / 旋转
let blurred = @filter.gaussian_blur(img, 3.0)
let resized = @transform.resize(img, 256, 256)

// 编码 — 输出为 PNG 字节
let out : Bytes = @lib.write_png_to_bytes(resized)

#错误处理

try {
  let img = @lib.load_from_bytes(data)
} catch {
  LoadError::FileIO(msg) => println("IO 错误: \{msg}")
  LoadError::DecodeFailed(msg) => println("解码失败: \{msg}")
  LoadError::UnsupportedFormat(msg) => println("不支持的格式: \{msg}")
}

#高级：SIFT 特征匹配

import "walkzzz/process/feature"

// 检测 SIFT 特征
let kp1 = @feature.sift_detect(img1)
let kp2 = @feature.sift_detect(img2)

// L2 距离 + Lowe 比率测试匹配
let matches = @feature.sift_match(kp1, kp2, ratio_threshold=0.75)

// RANSAC 鲁棒单应性估计
let homography = @feature.ransac_homography(matches, threshold=5.0, iterations=1000)

#流式解码

import "walkzzz/codec/lib"

// 逐行回调（当前为全量解码后逐行分发，v5.0 计划增量解码）
@lib.decode_stream(data, fn(row, y) {
  // 处理第 y 行像素 row : Array[Array[Int]]
})

#🏗️ 架构

graph TD
    CORE["<b>core</b><br/>基础类型<br/>Image · Image16 · ImageF"] --> CODEC["<b>codec</b><br/>编解码<br/>18 格式 · 色彩 · 元数据"]
    CODEC --> PROCESS["<b>process</b><br/>图像处理<br/>滤波 · 边缘 · 特征 · 分割"]
    PROCESS --> PHOTO["<b>photography</b><br/>计算摄影<br/>HDR · 融合 · 拼接 · 风格迁移"]
    PROCESS --> VISION["<b>vision</b><br/>计算机视觉<br/>OCR · 人脸 · SLAM · 场景"]
    VISION --> DOMAIN["<b>domain</b><br/>领域应用<br/>医学 · 遥感 · 取证 · 配准"]

    style CORE fill:#4CAF50,color:#fff,stroke:#388E3C
    style CODEC fill:#2196F3,color:#fff,stroke:#1565C0
    style PROCESS fill:#FF9800,color:#fff,stroke:#E65100
    style PHOTO fill:#9C27B0,color:#fff,stroke:#6A1B9A
    style VISION fill:#F44336,color:#fff,stroke:#C62828
    style DOMAIN fill:#607D8B,color:#fff,stroke:#37474F

#包结构

walkzzz/image (根模块 — 门面，不做 reexport)
├── core/                        # L0: 基础类型
│   └── types/                   #   Image, Image16, ImageF, LoadError, Pixel
├── codec/                       # L1: 编解码
│   ├── codec/                   #   18 格式编解码 (png/ jpeg/ bmp/ gif/ ...)
│   ├── lib/                     #   高层封装 (自动格式分派 + 流式解码)
│   ├── color/                   #   色彩空间转换
│   ├── meta/                    #   EXIF/XMP/IPTC/PNG text
│   ├── barcode/                 #   QR/条码
│   └── util/                    #   resize/zlib/配置
├── process/                     # L2: 图像处理
│   ├── color/                   #   色彩/CLAHE/Retinex/去雾
│   ├── filter/                  #   滤波/去噪
│   ├── edge/                    #   边缘/Canny/霍夫
│   ├── feature/                 #   Harris/ORB/SIFT/光流
│   ├── segment/                 #   分水岭/SLIC/grabCut
│   ├── transform/               #   几何/透视/Seam Carving
│   ├── frequency/               #   FFT/DCT/小波
│   ├── enhance/                 #   修复/去雾/降噪
│   ├── detection/               #   检测/跟踪
│   └── stereo3d/                #   立体视觉
├── photography/                 # L3a: 计算摄影
│   ├── photo_enhance/           #   HDR/照片增强
│   ├── superres/ fusion/ stitch/ style_transfer/ inpainting/
│   └── computational_imaging/ neural_rendering/ compression/ quality/
├── vision/                      # L3b: 计算机视觉
│   ├── ocr/                     #   OCR 全链路 (36 模块文件)
│   ├── face_recognition/ slam/ video/ scene_understanding/
│   └── spatiotemporal/ vlm_multimodal/ fieldimg/ imgir/ aoci/
└── domain/                      # L4: 领域应用
    ├── medical/ remote_sensing/ encryption/ watermark/
    ├── forensics/ registration/ retrieval/ pipeline/
    ├── texture/ mesh/ point_cloud/ agent_kit/ self_evolve/
    └── performance/ production_utils/ util/

#用户导入方式

// 直接 import 子模块包 — 清晰、按需、零耦合
import "walkzzz/core/types"          // @types.Image
import "walkzzz/codec/lib"           // @lib.load_from_bytes_auto()
import "walkzzz/process/filter"      // @filter.gaussian_blur()
import "walkzzz/process/feature"     // @feature.sift_detect()
import "walkzzz/vision/ocr"          // @ocr.recognize_text()

#🧰 功能一览

#图像处理 (process/)

#计算摄影 (photography/)

#计算机视觉 (vision/)

#OCR 全链路 (vision/ocr/)

#🎯 多目标支持

同一代码库，无条件编译，四目标共用所有源码。

#📊 vs stb_image.h

#📄 文档

#🔧 构建与测试

# 编译检查（四目标）
moon check && moon check --target wasm-gc && moon check --target js && moon check --target wasm

# 运行测试（6,486 × 4 目标）
moon test --target native
moon test --target wasm-gc
moon test --target js
moon test --target wasm

# 性能基准
moon run --target native

# API 接口生成
moon info

# 形式化验证（需安装 Why3 + z3/cvc5）
moon prove core/types

# 格式化
moon fmt

#🤝 贡献

#📄 许可证

#🙏 致谢

• stb — 原始 C 实现的参考基础
• MoonBit — 纯 MoonBit 语言与工具链
• OpenCV — 高级算法参考（ORB/Canny/Harris/光流等）