Package org.miaixz.bus.core.xyz

Class ColorKit

java.lang.Object

org.miaixz.bus.core.xyz.ColorKit

public class ColorKit
extends Object

颜色工具类

Since:

Java 17+

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor	Description
ColorKit()

Method Summary

Modifier and Type	Method	Description
static Color	add(Color color1, Color color2)	叠加颜色
static int	computeColorDistance(Color color1, Color color2)	计算两个颜色之间的色差，按三维坐标距离计算
static Color	getColor(int rgb)	获取一个RGB值对应的颜色
static Color	getColor(int gray, int[] rgba)	从rgba数组或gray值中获取RGB颜色
static Color	getColor(String colorName)	将颜色值转换成具体的颜色类型 汇集了常用的颜色集，支持以下几种形式：
static String	getMainColor(BufferedImage image, int[]... rgbFilters)	获取给定图片的主色调，背景填充用
static Color	hexToColor(String hex)	16进制的颜色值转换为Color对象，例如#fcf6d6
static int	maxDistance(Color color)	计算给定点与其他点之间的最大可能距离。
static Color	randomColor()	生成随机颜色
static Color	randomColor(Color compareColor, int minDistance)	生成随机颜色，与指定颜色有一定的区分度
static Color	randomColor(Random random)	生成随机颜色
static AnsiElement	toAnsiColor(int rgb, boolean is8Bit, boolean isBackground)	AWT的Color颜色转换为ANSI颜色，由于取最接近颜色，故可能有色差
static AnsiElement	toAnsiColor(Color color, boolean is8Bit, boolean isBackground)	AWT的Color颜色转换为ANSI颜色，由于取最接近颜色，故可能有色差
static String	toCssRgb(Color color)	将颜色转换为CSS的rgba表示形式，输出结果格式为：rgba(red, green, blue)
static String	toCssRgba(Color color)	将颜色转换为CSS的rgba表示形式，输出结果格式为：rgba(red, green, blue, alpha)
static String	toHex(int r, int g, int b)	RGB颜色值转换成十六进制颜色码
static String	toHex(Color color)	Color对象转16进制表示，例如#fcf6d6

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ColorKit

public ColorKit()

Method Details

toCssRgb

public static String toCssRgb(Color color)

将颜色转换为CSS的rgba表示形式，输出结果格式为：rgba(red, green, blue)

Parameters:

color - AWT颜色

Returns:

rgb(red, green, blue)

toCssRgba

public static String toCssRgba(Color color)

将颜色转换为CSS的rgba表示形式，输出结果格式为：rgba(red, green, blue, alpha)

Parameters:

color - AWT颜色

Returns:

rgba(red, green, blue, alpha)

toHex

public static String toHex(Color color)

Color对象转16进制表示，例如#fcf6d6

Parameters:

color - Color

Returns:

16进制的颜色值，例如#fcf6d6

toHex

public static String toHex(int r,
 int g,
 int b)

RGB颜色值转换成十六进制颜色码

Parameters:

r - 红(R)

g - 绿(G)

b - 蓝(B)

Returns:

返回字符串形式的 十六进制颜色码 如

getColor

public static Color getColor(String colorName)

将颜色值转换成具体的颜色类型 汇集了常用的颜色集，支持以下几种形式：

 1. 颜色的英文名（大小写皆可）
 2. 16进制表示，例如：#fcf6d6或者$fcf6d6
 3. RGB形式，例如：13,148,252
 4. RGBA形式，例如：13,148,252,1
 

Parameters:

colorName - 颜色的英文名，16进制表示或RGB表示

Returns:

Color

getColor

public static Color getColor(int rgb)

获取一个RGB值对应的颜色

Parameters:

rgb - RGB值

Returns:

Color

getColor

public static Color getColor(int gray,
 int[] rgba)

从rgba数组或gray值中获取RGB颜色

Parameters:

gray - 在单色显示器上呈现时的单个灰色无符号值。单位在p值中指定， 从最小的0x0000(黑色)到最大的0xFFFF(白色)。

rgba - 指定RGB[A]颜色的无符号值数组(可选的)

Returns:

Color

hexToColor

public static Color hexToColor(String hex)

16进制的颜色值转换为Color对象，例如#fcf6d6

Parameters:

hex - 16进制的颜色值，例如#fcf6d6

Returns:

Color

add

public static Color add(Color color1,
 Color color2)

叠加颜色

Parameters:

color1 - 颜色1

color2 - 颜色2

Returns:

叠加后的颜色

randomColor

public static Color randomColor()

生成随机颜色

Returns:

随机颜色

randomColor

public static Color randomColor(Random random)

生成随机颜色

Parameters:

random - 随机对象 Random

Returns:

随机颜色

randomColor

public static Color randomColor(Color compareColor,
 int minDistance)

生成随机颜色，与指定颜色有一定的区分度

Parameters:

compareColor - 比较颜色，null表示无区分要求

minDistance - 最小色差，按三维坐标计算的距离值。小于等于0表示无区分要求

Returns:

随机颜色

computeColorDistance

public static int computeColorDistance(Color color1,
 Color color2)

计算两个颜色之间的色差，按三维坐标距离计算

Parameters:

color1 - 颜色1

color2 - 颜色2

Returns:

色差，按三维坐标距离值

toAnsiColor

public static AnsiElement toAnsiColor(int rgb,
 boolean is8Bit,
 boolean isBackground)

AWT的Color颜色转换为ANSI颜色，由于取最接近颜色，故可能有色差

Parameters:

rgb - RGB颜色

is8Bit - 是否8bit的ANSI颜色

isBackground - 是否背景色

Returns:

ANSI颜色

toAnsiColor

public static AnsiElement toAnsiColor(Color color,
 boolean is8Bit,
 boolean isBackground)

AWT的Color颜色转换为ANSI颜色，由于取最接近颜色，故可能有色差

Parameters:

color - Color

is8Bit - 是否8bit的ANSI颜色

isBackground - 是否背景色

Returns:

ANSI颜色

getMainColor

public static String getMainColor(BufferedImage image,
 int[]... rgbFilters)

获取给定图片的主色调，背景填充用

Parameters:

image - BufferedImage

rgbFilters - 过滤多种颜色

Returns:

String #ffffff

maxDistance

public static int maxDistance(Color color)

计算给定点与其他点之间的最大可能距离。

Parameters:

color - 指定颜色

Returns:

其余颜色与color的最大距离