將 RGB 轉換為 HSV 的標準演算法會將每個 8 位元 RGB 色道正規化為 255,求出最大值、最小值與範圍,然後推導色相、飽和度與明度,並明確處理無彩色。
RGB 透過加色式的紅、綠、藍色道數量來描述顏色。HSV 則以色輪上的位置、飽和度與明度來表示相同的 sRGB 樣式顏色。本指南著重於一般 RGB 值從 0 到 255 所使用的 8 位元演算法。

在執行任何 HSV 分支前先正規化 RGB 色道
先驗證輸入。每個紅、綠、藍色道都必須是 0 到 255 之間的有限整數。嚴格驗證可避免輸入錯誤在未經察覺的情況下遭到四捨五入或限制在看似有效的範圍內。
- 正規化色道:計算 r = R / 255、g = G / 255 與 b = B / 255。
- 求出共用值:計算 max = max(r,g,b)、min = min(r,g,b) 與 delta = max - min。
- 計算明度:設定 V = max。因此,HSV 明度會反映最強的正規化色道,而非感知亮度。
- 計算飽和度:當 max 非零時,設定 S = delta / max;否則設定 S = 0。如此可明確將黑色的飽和度設為零,而不必嘗試進行未定義的除法。
飽和度表示相對於明度而言,顏色距離灰階軸的遠程度。它並非一般意義上的亮度度量,而 HSV 明度也不等同於 HSL 亮度。
從主要色道選擇色相
當 delta 非零時,色相依據哪個正規化色道具有最大值,以及另外兩個色道的相對位置而定。請使用下列分支:
- 紅色最大:計算 H = 60 × (((g - b) / delta) mod 6)。
- 綠色最大:計算 H = 60 × (((b - r) / delta) + 2)。
- 藍色最大:計算 H = 60 × (((r - g) / delta) + 4)。
在紅色分支中,mod 6 表示取 0 到不含 6 範圍內的餘數。將最終色相以 360 取模,讓它保持非負且小於 360。所得角度會遵循熟悉的色輪位置:紅色從 0 度開始,接著依序為黃色、綠色、青色、藍色與洋紅色,每隔 60 度。
評估這些分支前,請先檢查 delta 是否等於零。零 delta 表示三個色道全都相等,因此色相沒有視覺意義。這裡使用的標準實作會傳回慣用的預設色相 0 度。若兩個最大值色道並列,對應的標準分支會產生相同的色相角度。
執行一次完整的轉換範例
- 對於 RGB 三元組 (255, 128, 0),將色道正規化為 r = 1、g = 128 / 255 與 b = 0。
- 最大值為 1,最小值為 0,而 delta 為 1 - 0 = 1。
- 明度為 V = 1,飽和度則為 S = 1 / 1 = 1。
- 由於紅色最大,色相為 H = 60 × (((128 / 255) - 0) / 1) = 30.117647… 度。
- 為顯示而四捨五入後,結果為 H = 30.12 度、S = 100.00% 與 V = 100.00%。
在整個計算過程中,請保持內部值未經四捨五入。只有最終顯示值進行四捨五入,才能避免細微的中間誤差影響色相分支或色道之間的比較。
在瀏覽器中轉換 8 位元 RGB 三元組
- 開啟 RGB to HSV 轉換器。
- 在對應欄位中輸入 0 到 255 之間的整數紅、綠、藍值。
- 選擇 轉換為 HSV。
- 讀取以度表示的色相,以及以百分比表示的飽和度與明度。結果也包含正規化的 HSV 表示法、來源 HEX 色碼及視覺色塊。
- 傳輸數值前,請確認目的地採用的是角度與百分比、0 到 1 的比例,或精簡整數範圍。
輸入色道會保持可見,因此您可以變更其中一個值,並比較三個 HSV 元件如何回應。整個轉換作業完全在瀏覽器中執行,且不會儲存色彩記錄。
正確處理無彩色與無效輸入
無彩色需要明確分支,因為其飽和度已明確定義為零,但色相未定義。
- 黑色:所有色道皆為零,因此最大值、最小值、delta、明度與飽和度皆為零。色相同樣以慣用的預設值 0 度回報。
- 相等的非零色道:該顏色為灰色,delta 為零,飽和度也為零。明度等於共同的正規化色道,但色相沒有視覺意義,因此以 0 度回報。
- 無效輸入:小數值、空欄位、負數、超過 255 的值及非有限值會產生明確錯誤,而不會遭到四捨五入或限制在有效範圍內。
- Alpha:透明度不在轉換器的處理範圍內,因為它不會改變底部三個色道的 RGB 到 HSV 計算。
轉換器也不會讀取內嵌影像描述檔,或在廣色域色彩空間之間進行轉換。它會轉換提供的 sRGB 樣式三元組;不會試圖還原原始影像的色彩描述檔,也不會正規化任意色彩空間。
符合目的地的 HSV 比例
在數學上等效的顏色,可能在不同應用程式中使用不同的數值編碼。從角度與百分比介面複製數值前,請先確認接收格式。
| 目的地格式 | 預期表示法 | 傳輸動作 |
|---|---|---|
| 角度與百分比 | 色相以度表示,飽和度與明度以百分比表示 | 若目的地文件 specifies 此格式,請直接使用顯示的值。 |
| 0 到 1 的比例 | 飽和度與明度介於 0 到 1;除非目的地另有 specifies,否則色相仍為角度 | 確認 API 規範後,將顯示的飽和度與明度百分比除以 100。 |
| 精簡整數範圍 | 某些軟體會將色相儲存為 0 到 179,或 0 到 255 | 請將色相轉換為程式文件所列的比例,不要原樣貼上角度值。 |
| HSL 座標 | HSL 使用不同的亮度量 | 請使用 HSL 轉換器,不要將 HSV 明度重新標示為亮度。 |
除非該程式明確接受百分比,否則不要以整數百分比取代 API 的小數值。其他應用程式也可能採用不同的四捨五入方式,因此其文件優先於根據顯示小數值所作的假設。
驗證實作並負責任地使用結果
可靠的實作應保留數學運算順序與邊界案例行為:
- 在正規化色道前驗證整數邊界。
- 嘗試除法前,先處理最大值為零與 delta 為零的情況。
- 保持完整的浮點精確度,直到最終格式化步驟。
- 將六個主要與次要色輪位置、黑色及中間灰色視為回歸測試案例進行測試。
- 區分 HSV 明度、HSL 亮度與測得的亮度。
Android Color.colorToHSV 文件將色相定義為從零到不含 360,飽和度與明度則以 0 到 1 表示。轉換器遵循此範圍慣例,並依據 R grDevices rgb2hsv 慣例,獨立驗證其對一般 0 到 255 sRGB 輸入的實作。
您可以將結果用於 CSS 探索、圖形指令碼、教學、色盤座標比較,或將 8 位元樣本移至以 HSV 為基礎的控制項。若要交付與 CSS 相關的成果,請參閱 CSS 程式碼的 RGB 到 HSV 值,了解目的地格式的相關考量。色彩轉換成功並不代表文字具備可讀性;請使用專用的對比度檢查工具,測試實際的前景與背景配對。