Class ColorConverter

constructor

• new ColorConverter(): ColorConverter

  Returns ColorConverter

Static ReadonlyRGB_MARKER

StaticisRgbColor

• isRgbColor(color: number): boolean

  检查colorIndex是否为RGB真彩色

  Parameters

  • color: number

    颜色索引值

  Returns boolean

  如果是RGB颜色返回true，否则返回false

  Example

  ColorConverter.isRgbColor(255);       // 返回 false (索引颜色)
  ColorConverter.isRgbColor(16777216);  // 返回 true (黑色 #000000)
  ColorConverter.isRgbColor(16777216 + 16711680); // 返回 true (红色 #FF0000)
  Copy

StaticextractRgbValue

• extractRgbValue(color: number): number

  从colorIndex中提取RGB值

  Parameters

  • color: number

    包含RGB标记的颜色索引值

  Returns number

  RGB整数值（0x000000 ~ 0xFFFFFF）

  Example

  ColorConverter.extractRgbValue(16777216 + 16711680); // 返回 16711680 (#FF0000)
  Copy

StaticcreateRgbColorIndex

• createRgbColorIndex(rgbValue: number): number

  从RGB整数值创建colorIndex

  Parameters

  • rgbValue: number

    RGB整数值（0x000000 ~ 0xFFFFFF）

  Returns number

  带RGB标记的colorIndex

  Example

  ColorConverter.createRgbColorIndex(16711680); // 返回 16777216 + 16711680 (红色)
  ColorConverter.createRgbColorIndex(0xFF0000); // 同上
  Copy

StaticcreateRgbColorIndexFromComponents

• createRgbColorIndexFromComponents(r: number, g: number, b: number): number

  从RGB分量创建colorIndex

  Parameters

  • r: number

    红色分量 (0-255)

  • g: number

    绿色分量 (0-255)

  • b: number

    蓝色分量 (0-255)

  Returns number

  带RGB标记的colorIndex

  Example

  ColorConverter.createRgbColorIndexFromComponents(255, 0, 0); // 红色
  ColorConverter.createRgbColorIndexFromComponents(0, 255, 0); // 绿色
  Copy

StaticcreateRgbColorIndexFromHexStr

• createRgbColorIndexFromHexStr(hexStr: string): number

  从十六进制颜色字符串创建colorIndex

  Parameters

  • hexStr: string

    十六进制颜色字符串（如 "#FF0000" 或 "FF0000"）

  Returns number

  带RGB标记的colorIndex，如果解析失败返回7（白色索引）

  Example

  ColorConverter.createRgbColorIndexFromHexStr("#FF0000"); // 红色
  ColorConverter.createRgbColorIndexFromHexStr("00FF00");  // 绿色
  Copy

StaticgetRgbComponents

• getRgbComponents(
      color: number,
      isDarkBackground?: boolean,
  ): { r: number; g: number; b: number }

  从colorIndex获取RGB分量

  Parameters

  • color: number

    颜色索引值（支持RGB颜色和索引颜色）

  • isDarkBackground: boolean = false

    是否为深色背景

  Returns { r: number; g: number; b: number }

  RGB分量对象 {r, g, b}

  Example

  ColorConverter.getRgbComponents(ColorConverter.createRgbColorIndexFromComponents(255, 128, 0));
  // 返回 {r: 255, g: 128, b: 0}
  Copy

StaticGetColorHexStr

• GetColorHexStr(color: number, isDarkBackground?: boolean): string

  获取颜色的十六进制字符串表示

  将颜色索引转换为6位十六进制字符串格式（不包含#前缀） 支持索引颜色和RGB真彩色

  Parameters

  • color: number

    颜色索引值（0-255为索引颜色，>=16777216为RGB颜色）

  • isDarkBackground: boolean = false

    是否为深色背景，默认为false

  Returns string

  6位十六进制颜色字符串，如"FFFFFF"

  Example

  ColorConverter.GetColorHexStr(1); // 返回 "FF0000" (红色索引)
  ColorConverter.GetColorHexStr(7, true); // 返回 "000000" (深色背景下的白色变为黑色)
  ColorConverter.GetColorHexStr(16777216 + 0xFF8000); // 返回 "FF8000" (RGB橙色)
  Copy

StaticGetColorCssStr

• GetColorCssStr(color: number, isDarkBackground?: boolean): string

  获取颜色的CSS格式字符串表示（带#前缀）

  Parameters

  • color: number

    颜色索引值

  • isDarkBackground: boolean = false

    是否为深色背景

  Returns string

  CSS颜色字符串，如"#FFFFFF"

StatichexToStr

• hexToStr(hexValue: number): string

  将十六进制数值转换为CSS颜色字符串

  将RGB十六进制数值转换为标准的CSS颜色字符串格式（包含#前缀）

  Parameters

  • hexValue: number

    RGB十六进制数值

  Returns string

  CSS颜色字符串，如"#FF0000"

  Example

  ColorConverter.hexToStr(16711680); // 返回 "#FF0000"
  ColorConverter.hexToStr(65280);    // 返回 "#00FF00"
  Copy

StaticGetColorHex

• GetColorHex(
      color: number,
      unusedParameter?: number,
      isDarkBackground?: boolean,
  ): number

  根据颜色索引获取对应的RGB十六进制数值

  这是核心的颜色映射函数，将CAD标准颜色索引转换为RGB十六进制数值。 支持AutoCAD的256色调色板，包括基本颜色、灰度色和扩展颜色。 也支持RGB真彩色（colorIndex >= RGB_MARKER）。

  Parameters

  • color: number

    颜色索引值（0-255为索引颜色，>=16777216为RGB颜色）

  • unusedParameter: number = 0

    未使用的参数，保留为0

  • isDarkBackground: boolean = false

    是否为深色背景，影响某些颜色的显示

  Returns number

  RGB十六进制数值

  特殊颜色处理：

  • 索引0和7：白色（在深色背景下可能变为黑色）
  • 索引1-6：基本颜色（红、黄、绿、青、蓝、洋红）
  • 索引8-255：扩展颜色调色板

  • =16777216：RGB真彩色

  Example

  ColorConverter.GetColorHex(1);  // 返回 16711680 (红色 #FF0000)
  ColorConverter.GetColorHex(7);  // 返回 16777215 (白色 #FFFFFF)
  ColorConverter.GetColorHex(7, 0, true); // 返回 0 (深色背景下的黑色)
  ColorConverter.GetColorHex(16777216 + 0xFF8000); // 返回 0xFF8000 (RGB橙色)
  Copy