xtap-color 0.1.4

StarTAP胶片调色色彩引擎 / Film color grading engine: OKLab / ACR film emulation / ZACG / MS-SSIM, pure algorithm no GUI. 星TAP实验室出品。
Documentation

xTap Color

A film-grade color grading engine by 星TAP实验室 (StarTAP Labs): OKLab color space, ACR film simulation, ZACG grading, chroma compass, tone field, MS-SSIM quality — pure algorithms, zero GUI.

crates.io docs.rs license downloads

English version · 中文版


English version

A modular, dependency-light color engine extracted from production tools at StarTAP Labs. Everything is pure math on raw pixel buffers — no GUI, no heavy framework.

Modules

  • color_engine::color_space — OKLab / OKLCH conversions and color space math
  • color_engine::acr_film — ACR-style film simulation curves
  • color_engine::zacg — ZACG film grading (teal-orange / complementary looks)
  • color_engine::chroma_compass — chromatic compass for hue-directed grading
  • color_engine::tone_field — tone field manipulation
  • color_engine::film_curve — film response curve modeling
  • color_engine::cluster — color clustering for tonal grouping
  • color_engine::spider_warp — hue spider warp for creative grades
  • color_engine::validation — input/parameter validation helpers
  • quality::ms_ssim — MS-SSIM image quality assessment

Quick start

[dependencies]
xtap-color = "0.1"
use xtap_color::color_engine;

// raw sRGB (0.0–1.0) → OKLab
let (l, a, b) = color_engine::rgb_to_oklab(0.8, 0.2, 0.1);
// → OKLCH (perceptually-uniform lightness / chroma / hue)
let (l, c, h) = color_engine::oklab_to_oklch(l, a, b);

Design

  • Operates on raw [f32] / Vec<f32> buffers (RGB or RGBA), ready to plug into your own pipeline
  • Parallel via rayon where it helps
  • Errors via ColorEngineError (thiserror), serializable params via serde

Building the GUI tool (ColorMaster)

The repo also contains the full GUI tool (色彩大师 / ColorMaster). Build it with:

cargo build --release --features "gui,cli"

License

MIT © 2026 星TAP实验室 (StarTAP Labs)


中文版 / Chinese

星TAP实验室胶片调色色彩引擎:OKLab 色彩空间 / ACR 胶片模拟 / ZACG 调色 / 色度罗盘 / 色调场 / MS-SSIM 图像质量评估。纯算法,无 GUI 依赖。

这库是干嘛的?(人话版)

有什么用? 把 ColorMaster 软件里的专业调色算法——电影感胶片模拟、ZACG 风格化调色、色度罗盘、MS-SSIM 画质评估——抽成独立库。写图像处理工具时加一行依赖就能拿到全套专业调色能力。

给我什么好处?

  • 专业级调色算法,纯 Rust 纯算法,无 GUI 无重框架
  • 直接在像素缓冲区上运算,无缝嵌入你自己的处理管线
  • rayon 并行加速,大图不吃亏

为什么用它? 市面上调色库要么绑定 GUI/编辑器,要么依赖大框架。这个库是纯数学算法,输入输出就是原始像素,接哪儿都行。

跟我有什么关系? 写 Rust 图像处理/调色工具的人,一行依赖拿走专业调色能力。

快速开始

[dependencies]
xtap-color = "0.1"
use xtap_color::color_engine;

// 原始 sRGB(0.0–1.0)→ OKLab
let (l, a, b) = color_engine::rgb_to_oklab(0.8, 0.2, 0.1);
// → OKLCH(感知均匀的 明度 / 色度 / 色相)
let (l, c, h) = color_engine::oklab_to_oklch(l, a, b);

本仓库还包含完整 GUI 工具(色彩大师)

cargo build --release --features "gui,cli"

License

MIT © 2026 星TAP实验室