ImageColor 模組

ImageColor 模組包含色彩表和從 CSS3 樣式色彩指定符到 RGB 元組的轉換器。此模組由 PIL.Image.new() 和 ImageDraw 模組等使用。

色彩名稱

ImageColor 模組支援下列字串格式

• 十六進位色彩指定符，以 #rgb、#rgba、#rrggbb 或 #rrggbbaa 給定，其中 r 是紅色、g 是綠色、b 是藍色，而 a 是 alpha（也稱為「不透明度」）。例如，#ff0000 指定純紅色，而 #ff0000cc 指定具有 80% 不透明度的紅色 (cc 以十進位形式為 204，而 204 / 255 = 0.8)。

• RGB 函式，以 rgb(red, green, blue) 給定，其中色彩值是 0 到 255 範圍內的整數。或者，色彩值可以給定為三個百分比 (0% 到 100%)。例如，rgb(255,0,0) 和 rgb(100%,0%,0%) 都指定純紅色。

• 色相飽和度亮度 (HSL) 函式，以 hsl(hue, saturation%, lightness%) 給定，其中色相是以 0 到 360 之間的角度給定的色彩 (紅色 = 0、綠色 = 120、藍色 = 240)，飽和度是 0% 到 100% 之間的值 (灰色 = 0%、全彩 = 100%)，而亮度是 0% 到 100% 之間的值 (黑色 = 0%、正常 = 50%、白色 = 100%)。例如，hsl(0,100%,50%) 是純紅色。

• 色相飽和度值 (HSV) 函式，以 hsv(hue, saturation%, value%) 給定，其中色相和飽和度與 HSL 相同，而值是介於 0% 到 100% 之間 (黑色 = 0%，正常 = 100%)。例如，hsv(0,100%,100%) 是純紅色。此格式也稱為色相飽和度亮度 (HSB)，可以以 hsb(hue, saturation%, brightness%) 給定，其中每個值都以其在 HSV 中的方式使用。

• 常用的 HTML 色彩名稱。ImageColor 模組提供約 140 種標準色彩名稱，基於 X Window 系統和大多數網頁瀏覽器支援的色彩。色彩名稱不區分大小寫。例如，red 和 Red 都指定純紅色。

函式

PIL.ImageColor.getrgb(color)

將色彩字串轉換為 RGB 元組。如果無法剖析字串，則此函式會引發 ValueError 例外狀況。

在 1.1.4 版本中新增。

PIL.ImageColor.getcolor(color, mode)

與 getrgb() 相同，但如果模式不是色彩或調色盤影像，則將 RGB 值轉換為灰階值。如果無法剖析字串，則此函式會引發 ValueError 例外狀況。

在 1.1.4 版本中新增。