Color()

概述

Color 是 cadquery 中用于设置颜色的类。可以使用预定义的颜色名称、RGB、HSV 或者 HEX 码来创建颜色。

基本用法

要使用 Color，首先需要引入该类：

from cqparts.utils import Color

然后，可以使用以下方式来创建颜色：

• 根据预定义的颜色名称创建：

  c = Color('red')
  

  预定义的颜色名称包括：

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • magenta
  • cyan

• 根据 RGB 值创建：

  c = Color(255, 0, 0)
  

  其中，RGB 值的范围为 0 到 255。

• 根据 HSV 值创建：

  c = Color.from_hsv(0, 1, 1)
  

  其中，HSV 值各自的范围为：

  • H：0 到 360
  • S：0 到 1
  • V：0 到 1

• 根据 HEX 码创建：

  c = Color('#FF0000')
  

  HEX 码的格式是 #RRGGBB，其中 RR、GG 和 BB 分别代表红、绿、蓝三种颜色的值，范围为 00 到 FF。

以上四种方式任选一种即可。

属性

Color 的属性如下：

• rgb：获取 RGB 值

  print(c.rgb)  # (255, 0, 0)
  

• hsv：获取 HSV 值

  print(c.hsv)  # (0, 1, 1)
  

• html：获取 HEX 码

  print(c.html)  # #FF0000
  

方法

Color 的方法如下：

• to_rgb()：将颜色表示为 RGB 值

  print(c.to_rgb())  # (255, 0, 0)
  

• to_hsv()：将颜色表示为 HSV 值

  print(c.to_hsv())  # (0, 1, 1)
  

• to_html()：将颜色表示为 HEX 码

  print(c.to_html())  # #FF0000
  

• is_web_color()：判断是否为预定义的颜色名称

  print(c.is_web_color())  # False
  

  如果颜色是预定义的颜色名称，则返回 True，否则返回 False。

示例

from cqparts.utils import Color

# 创建颜色
c1 = Color('red')
c2 = Color.from_hsv(60, 1, 1)

# 获取属性
print(c1.rgb)   # (255, 0, 0)
print(c2.hsv)   # (60, 1, 1)
print(c1.html)  # #FF0000

# 转换格式
print(c2.to_rgb())    # (255, 255, 0)
print(c1.to_hsv())    # (0, 1, 1)
print(c2.to_html())   # #FFFF00

# 判断是否为预定义颜色
print(c1.is_web_color())  # True
print(c2.is_web_color())  # False