
ColorAPI
轻量级色彩代数、色彩空间与动画库,适用于Minecraft Fabric。功能包括RGB/HSV转换、缓动曲线、颜色过渡和纹理提取。
🎨 ColorAPI
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 许可证 下分发。可免费用于个人用途、整合包以及第三方模组集成。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。