ColorAPI

ColorAPI

轻量级色彩代数、色彩空间与动画库,适用于Minecraft Fabric。功能包括RGB/HSV转换、缓动曲线、颜色过渡和纹理提取。

🎨 ColorAPI

Fabric Minecraft Java License

ColorAPI 是一个超轻量、高性能的数学与色彩动画库,专为现代 Minecraft Fabric(1.21.11+)设计。它将纯色彩代数与时间曲线从复杂的渲染引擎中解耦,为彩色光照、GUI 控件、粒子系统和外观着色提供简洁、可复用的基础。


⚡ 核心特性

  • 🌈 全面的色彩空间:
    • 不可变的 ColorRGB 记录,支持 sRGB、线性空间、伽马校正、Alpha 通道,以及打包的 ARGB/RGB 转换。
    • ColorHSV 记录,具备稳健的 RGB (\leftrightarrow) HSV 双向映射。
  • 🧮 纯色彩代数(ColorMath):
    • 加权多源颜色混合(blendColors)。
    • 钳制线性插值(lerp)。
    • 光度衰减调制(modulate)。
    • 加性光累积(additiveAccumulate)。
  • 📈 丰富的缓动与动画引擎(EasingMath):
    • 缓动曲线:线性、缓入/缓出、缓入缓出、二次、三次、正弦、指数、弹跳、弹性以及阶跃。
    • 时间过渡控制器(ColorTransition),用于平滑的逐刻或逐帧颜色渐变。
  • 📦 解耦的数据结构:
    • 标准化的 Keyframe、Sequence 和 Profile 记录,用于编排复杂的多阶段颜色动画。
  • 🖼️ 纹理与资源颜色提取:
    • 原生工具,用于从方块精灵图和纹理中计算主色/平均色。

💻 开发者快速开始

将 ColorAPI 添加到你的 build.gradle:

repositories {
    mavenCentral()
    // 如果从源码构建,请使用 mavenLocal()
}

dependencies {
    modImplementation "mb.bartra:colorapi:1.0"
}

基础颜色插值与混合:

import mb.bartra.colorapi.ColorAPI;
import mb.bartra.colorapi.core.ColorRGB;
import mb.bartra.colorapi.core.ColorMath;

// 1. 在两个十六进制颜色之间进行简单的线性插值
int startColor = 0xFF0000; // 红色
int endColor   = 0x0000FF; // 蓝色
int blended    = ColorAPI.lerp(startColor, endColor, 0.5f); // 紫色

// 2. 线性颜色调制
ColorRGB light = ColorRGB.fromRgb(0xFFAA00);
ColorRGB shaded = light.toLinear().multiply(0.75f).toSrgb();

📄 许可证

ColorAPI 在开源 MIT 许可证 下分发。可免费用于个人用途、整合包以及第三方模组集成。