Pigmentum API

🎨 Pigmentum - Minecraft Canvas API

将每个方块表面变成你的个人画布。在 Minecraft 中逐像素绘制在任何表面上。

---

Pigmentum 是面向 NeoForge 模组开发者的底层画布 API。 开箱即用的绘画功能（画笔、GUI、混合模式）将在 Fresco 中单独开发。 Pigmentum 专注于提供核心画布基础设施和扩展 API。

---

✨ 特性

🖌️ 画布系统

• 任意方块作画布：用画笔右键点击任意方块表面，即可将其转化为与方块无缝融合的画布。
• 像素级绘制：按住右键并拖动，即可绘制平滑连续的线条——即使高速移动也不会出现断点。
• 多面画布：可独立绘制方块的每个面——顶面、底面及四个侧面。
• 不规则方块支持：楼梯、台阶、栅栏及其他异形方块均可实现像素级精准绘制。
• 画笔配置菜单：在空中右键点击画笔，可调整画笔大小、羽化效果、混合模式及绘制间隔。

🎯 画笔系统

• 颜色拾取器：按下 R 键可采样准星所指像素的颜色。
• 多种混合模式：支持覆盖、叠加、相乘、擦除模式。

📦 画布提取与展示

• 画布纸片物品：潜行时右键点击已涂绘的方块，可将其一个面的图案复制到画布纸片上，且不影响原方块。
• 物品框展示：将画布纸片放入物品框，即可像地图一样展示你的艺术作品。

🧩 扩展 API

• 自定义图像提供器（CanvasImageProvider）——注册基于像素数据的自定义纹理生成方式
• 自定义渲染器（CanvasPixelRenderer）——控制画布表面的渲染方式
• 逐像素效果层——为每个像素附加任意字节数据（例如发光强度、粗糙度）
• 自定义混合函数（BlendFunction）——完全控制像素颜色与效果合成
• 自定义画笔（IPaintProvider）——将任意物品注册为具有自定义行为的画笔

---

🎮 快速开始

1. 从创造模式物品栏中获取画笔。
2. 右键点击任意方块表面创建画布。
3. 按住右键并拖动绘制像素。
4. 按下 R 键从世界中拾取颜色。
5. 在空中右键调整画笔设置。
6. 使用画布纸片提取你的作品，并在物品框中展示。

---

Pigmentum - 每个面都是一幅画布。