本文详解如何使用 Java 的 BufferedImage 和 HSB 颜色模型，将灰度图像按指定色调（hue）进行单色着色，保留原始透明度与明暗层次，适用于图像处理、UI 图标动态染色等场景。
本文详解如何使用 java 的 `bufferedimage` 和 hsb 颜色模型，将灰度图像按指定色调（hue）进行单色着色，保留原始透明度与明暗层次，适用于图像处理、ui 图标动态染色等场景。
在图像处理中，“灰度图像着色”（Colorize）并非简单地叠加一层纯色，而是将灰度值映射为色彩空间中的亮度分量，同时统一赋予指定色相与饱和度，从而生成视觉自然、层次分明的彩色图像。Java 标准库未提供现成的 colorize 方法，但借助 Color.HSBtoRGB() 可高效实现该效果：将每个像素的灰度值（0–255）归一化为 HSB 模型中的 brightness（0.0–1.0），固定 hue（如 0.33 表示青绿色）和 saturation（建议 1.0 获得饱满色彩），再转换回 RGB 值并合成原始 alpha 通道。
以下是一个健壮、可复用的 colorize 工具方法：
import java.awt.*;
import java.awt.image.BufferedImage;
import java.util.Objects;
public class ImageColorizer {
/**
* 对灰度 BufferedImage 进行单色调着色（保留 Alpha 通道）
* @param image 待处理图像（必须为 TYPE_BYTE_GRAY 或含灰度数据的 ARGB）
* @param hue 色相值，范围 [0.0, 1.0]（0=红，0.33=青绿，0.66=蓝紫）
*/
public static void colorize(BufferedImage image, float hue) {
Objects.requireNonNull(image, "Image cannot be null.");
if (hue < 0 || hue > 1 || Float.isNaN(hue)) {
throw new IllegalArgumentException("Hue must be between 0 and 1 inclusive.");
}
int width = image.getWidth();
int height = image.getHeight();
for (int y = 0; y < height; y++) {
for (int x = 0; x < width; x++) {
int argb = image.getRGB(x, y);
// 提取 Alpha 通道（高 8 位）
int alpha = argb & 0xff000000;
// 提取灰度值：对灰度图，R=G=B；此处统一取绿色通道（>>8 & 0xFF）兼容常见灰度编码
int grayLevel = (argb >> 8) & 0xff;
// 将灰度（0–255）映射为 HSB 的 brightness（0.0–1.0）
float brightness = grayLevel / 255f;
// 固定 hue + 全饱和度（1.0），生成对应 RGB
int rgb = Color.HSBtoRGB(hue, 1.0f, brightness);
// 合成新像素：保留原始 alpha，替换 RGB 部分
argb = (rgb & 0x00ffffff) | alpha;
image.setRGB(x, y, argb);
}
}
}
}✅ 关键说明与最佳实践：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 输入图像要求：方法默认假设输入是已正确加载的灰度图像（如 TYPE_BYTE_GRAY）或 ARGB 格式中 R/G/B 分量一致的图像。若图像为其他类型（如 TYPE_INT_RGB 无 Alpha），建议预先转换为 BufferedImage.TYPE_INT_ARGB 以确保 alpha 安全。
- 色相选择指南：hue ∈ [0,1) 对应标准色轮——0.0（红色）、0.167（黄色）、0.333（青绿色）、0.5（蓝色）、0.833（洋红色）。可配合 UI 主题动态传入。
- 饱和度调节：当前设为 1.0 保证色彩强度；如需柔和效果，可降为 0.7f–0.9f，避免高亮区域过曝。
- 性能提示：逐像素操作适合中小尺寸图像（≤2000×2000）。如需处理大图或实时渲染，建议改用 Raster + LookupOp 或迁移到 Graphics2D 着色器方案。
- 扩展性建议：可进一步封装为支持多色调渐变（如 hue map）、亮度/对比度预校正，或导出为 BufferedImage 新实例而非原地修改，提升线程安全性。
通过此方法，您能将任意灰度图标、线稿或医学影像精准映射为符合品牌色系的彩色输出，兼顾语义清晰性与视觉表现力。
立即学习“Java免费学习笔记（深入）”；
