Class Color

库使用的两种颜色形式：十六进制文本（如 #ff5733），以及通道值从 0 到 255 或从 0 到 1 的对象 { r, g, b } 或 { r, g, b, a }。这里的方法以每种形式构建颜色，按显式的通道范围在它们之间转换，读取单个通道，以及反转颜色。

Index

Constructors

convert

hexToRgb rgbToHex rgbObjToHex hexToRgbMapped

create

hexColor rgb255Color rgb1Color rgba255Color rgba1Color rgbAtomic255Color rgbAtomic1Color

hex to

getRedParam getGreenParam getBlueParam invert

rgb to

rgbToRed rgbToGreen rgbToBlue

Constructors

constructor

new Color(math: MathBitByBit): Bit.Color
Parameters
- math: MathBitByBit
Returns Bit.Color
- Defined in bitbybit-docs.d.ts:52825

convert

hexToRgb

hexToRgb(inputs: HexDto): ColorRGB
将十六进制颜色读入通道从 0 到 255 的 { r, g, b } 对象。

文本可以带或不带 # 开头；六位十六进制数字以外的任何内容都会抛出错误。示例：'#FF5733' -> { r: 255, g: 87, b: 51 }
Parameters
- inputs: HexDto
  十六进制颜色
Returns ColorRGB
通道值为 0 到 255 的颜色对象
Example
```
const rgb = bitbybit.color.hexToRgb({ color: "#ff5733" });
```
- Defined in bitbybit-docs.d.ts:52930

rgbToHex

rgbToHex(inputs: RGBMinMaxDto): string
将三个通道值写为十六进制颜色。

min 和 max 指定这些值使用的范围；0 到 255 以外的范围会先被重新映射，因此 0 到 1 的通道也可以。示例：r 255，g 87，b 51 在 [0,255] 中 -> '#ff5733'；r 1，g 0.5，b 0.2 在 [0,1] 中 -> '#ff8033'
Parameters
- inputs: RGBMinMaxDto
  红、绿和蓝值及其范围
Returns string
十六进制颜色
Example
```
const hex = bitbybit.color.rgbToHex({ r: 1, g: 0.5, b: 0.2, min: 0, max: 1 });
```
- Defined in bitbybit-docs.d.ts:52947

rgbObjToHex

rgbObjToHex(inputs: RGBObjectMaxDto): string
将 { r, g, b } 颜色写为十六进制颜色。

min 和 max 指定通道使用的范围；0 到 255 以外的范围会先被重新映射。示例：{ r: 1, g: 0.5, b: 0.2 } 在 [0,1] 中 -> '#ff8033'
Parameters
- inputs: RGBObjectMaxDto
  颜色对象及其通道使用的范围
Returns string
十六进制颜色
Example
```
const hex = bitbybit.color.rgbObjToHex({ rgb: { r: 1, g: 0.5, b: 0.2 }, min: 0, max: 1 });
```
- Defined in bitbybit-docs.d.ts:52964

hexToRgbMapped

hexToRgbMapped(inputs: HexDtoMapped): ColorRGB
将十六进制颜色读入 { r, g, b } 对象，通道重新映射到你选择的范围。

示例：'#FF5733' 映射到 [0,1] -> { r: 1, g: 0.341, b: 0.2 }
Parameters
- inputs: HexDtoMapped
  十六进制颜色和通道要映射到的范围
Returns ColorRGB
通道值在该范围内的颜色对象
Example
```
const rgb = bitbybit.color.hexToRgbMapped({ color: "#ff5733", from: 0, to: 1 });
```
- Defined in bitbybit-docs.d.ts:52980

create

hexColor

hexColor(inputs: HexDto): string
原样传递十六进制颜色，使一个颜色可以被命名并重用。

示例：'#FF5733' -> '#FF5733'
Parameters
- inputs: HexDto
  十六进制颜色
Returns string
同一个十六进制颜色
- Defined in bitbybit-docs.d.ts:52836

rgb255Color

rgb255Color(inputs: Rgb255Dto): ColorRGB
原样传递通道从 0 到 255 的 { r, g, b } 颜色，使它可以被命名并重用。

示例：{ r: 255, g: 87, b: 51 } -> 同一个对象
Parameters
- inputs: Rgb255Dto
  颜色对象
Returns ColorRGB
同一个颜色对象
- Defined in bitbybit-docs.d.ts:52848

rgb1Color

rgb1Color(inputs: Rgb1Dto): ColorRGB
原样传递通道从 0 到 1 的 { r, g, b } 颜色，使它可以被命名并重用。

示例：{ r: 1, g: 0.34, b: 0.2 } -> 同一个对象
Parameters
- inputs: Rgb1Dto
  颜色对象
Returns ColorRGB
同一个颜色对象
- Defined in bitbybit-docs.d.ts:52860

rgba255Color

rgba255Color(inputs: Rgba255Dto): ColorRGBA
原样传递颜色通道从 0 到 255、不透明度从 0 到 1 的 { r, g, b, a } 颜色，使它可以被命名并重用。

示例：{ r: 255, g: 87, b: 51, a: 1 } -> 同一个对象
Parameters
- inputs: Rgba255Dto
  颜色对象
Returns ColorRGBA
同一个颜色对象
- Defined in bitbybit-docs.d.ts:52872

rgba1Color

rgba1Color(inputs: Rgba1Dto): ColorRGBA
原样传递每个通道从 0 到 1 的 { r, g, b, a } 颜色，使它可以被命名并重用。

示例：{ r: 1, g: 0.34, b: 0.2, a: 1 } -> 同一个对象
Parameters
- inputs: Rgba1Dto
  颜色对象
Returns ColorRGBA
同一个颜色对象
- Defined in bitbybit-docs.d.ts:52884

rgbAtomic255Color

rgbAtomic255Color(inputs: RgbAttomic255Dto): ColorRGB
由三个单独的 0 到 255 通道值构建 { r, g, b } 颜色。

示例：r 255，g 87，b 51 -> { r: 255, g: 87, b: 51 }
Parameters
- inputs: RgbAttomic255Dto
  红、绿和蓝值
Returns ColorRGB
颜色对象
Example
```
const orange = bitbybit.color.rgbAtomic255Color({ r: 255, g: 87, b: 51 });
```
- Defined in bitbybit-docs.d.ts:52899

rgbAtomic1Color

rgbAtomic1Color(inputs: RgbAttomic1Dto): ColorRGB
由三个单独的 0 到 1 通道值构建 { r, g, b } 颜色。

示例：r 1，g 0.34，b 0.2 -> { r: 1, g: 0.34, b: 0.2 }
Parameters
- inputs: RgbAttomic1Dto
  红、绿和蓝值
Returns ColorRGB
颜色对象
Example
```
const orange = bitbybit.color.rgbAtomic1Color({ r: 1, g: 0.34, b: 0.2 });
```
- Defined in bitbybit-docs.d.ts:52914

hex to

getRedParam

getRedParam(inputs: HexDtoMapped): number
读取十六进制颜色的红色通道，重新映射到你选择的范围。

示例：'#FF5733' 在 [0,1] 中 -> 1
Parameters
- inputs: HexDtoMapped
  十六进制颜色和通道要映射到的范围
Returns number
该范围内的红色通道
Example
```
const red = bitbybit.color.getRedParam({ color: "#ff5733", from: 0, to: 1 });
```
- Defined in bitbybit-docs.d.ts:52995

getGreenParam

getGreenParam(inputs: HexDtoMapped): number
读取十六进制颜色的绿色通道，重新映射到你选择的范围。

示例：'#FF5733' 在 [0,1] 中 -> 0.341
Parameters
- inputs: HexDtoMapped
  十六进制颜色和通道要映射到的范围
Returns number
该范围内的绿色通道
Example
```
const green = bitbybit.color.getGreenParam({ color: "#ff5733", from: 0, to: 1 });
```
- Defined in bitbybit-docs.d.ts:53010

getBlueParam

getBlueParam(inputs: HexDtoMapped): number
读取十六进制颜色的蓝色通道，重新映射到你选择的范围。

示例：'#FF5733' 在 [0,1] 中 -> 0.2
Parameters
- inputs: HexDtoMapped
  十六进制颜色和通道要映射到的范围
Returns number
该范围内的蓝色通道
Example
```
const blue = bitbybit.color.getBlueParam({ color: "#ff5733", from: 0, to: 1 });
```
- Defined in bitbybit-docs.d.ts:53025

invert

invert(inputs: InvertHexDto): string
反转十六进制颜色，将每个通道变为其相反值：255 减去该值。

打开 blackAndWhite 时，结果对浅色为纯黑，对深色为纯白，适合彩色背景上的文本。示例：'#FF5733' -> '#00a8cc'；带 blackAndWhite -> '#ffffff'
Parameters
- inputs: InvertHexDto
  十六进制颜色以及是否将结果简化为黑色或白色
Returns string
反转后的十六进制颜色
Example
```
const textColor = bitbybit.color.invert({ color: "#ff5733", blackAndWhite: true });
```
- Defined in bitbybit-docs.d.ts:53075

rgb to

rgbToRed

rgbToRed(inputs: RGBObjectDto): number
读取 { r, g, b } 颜色的红色通道。

示例：{ r: 255, g: 87, b: 51 } -> 255
Parameters
- inputs: RGBObjectDto
  颜色对象
Returns number
红色通道，采用对象所使用的范围
- Defined in bitbybit-docs.d.ts:53036

rgbToGreen

rgbToGreen(inputs: RGBObjectDto): number
读取 { r, g, b } 颜色的绿色通道。

示例：{ r: 255, g: 87, b: 51 } -> 87
Parameters
- inputs: RGBObjectDto
  颜色对象
Returns number
绿色通道，采用对象所使用的范围
- Defined in bitbybit-docs.d.ts:53047

rgbToBlue

rgbToBlue(inputs: RGBObjectDto): number
读取 { r, g, b } 颜色的蓝色通道。

示例：{ r: 255, g: 87, b: 51 } -> 51
Parameters
- inputs: RGBObjectDto
  颜色对象
Returns number
蓝色通道，采用对象所使用的范围
- Defined in bitbybit-docs.d.ts:53058