API GetItemQualityColor

Returns RGB color codes for an item quality.

r, g, b, hex = GetItemQualityColor(quality)

Arguments[ | ]

quality

Number - The numeric ID of the quality from 0 (Poor) to 7 (Heirloom).

Returns[ | ]

r

Number - The Red component of the color (0 to 1, inclusive).

g

Number - The Green component of the color (0 to 1, inclusive).

b

Number - The Blue component of the color (0 to 1, inclusive).

hex

String - The UI escape sequence for this color, without the leading "|c".

Example[ | ]

for i = 0, 7 do
  local r, g, b, hex = GetItemQualityColor(i)
  print(i, '|c'..hex, _G["ITEM_QUALITY" .. i .. "_DESC"], string.sub(hex,3))
end

Result[ | ]

Will print all qualities, in their individual colors. If you are doing this via /script in-game, you will need to type "\124" instead of a "|".

Details[ | ]

GetItemQualityColor() was added in 1.9.1

If an invalid quality index is specified, GetItemQualityColor() returns white (same as index 1):

r = 1

g = 1

b = 1

hex = |cffffffff

Quality #7 was added in version 3.0 for heirloom items.

ITEM_QUALITY7_DESC is now defined as of 3.1.1.

The hex string included the leading "|c" until 4.2 when it was removed. If you use the global ITEM_QUALITY_COLORS array instead of this API, the ".hex" field will include the leading escape sequence.

See also[ | ]

• API ITEM_QUALITY_COLORS
• API TYPE Quality