promotional bannermobile promotional banner
premium banner

Krowi's Progress Bar

A progress bar library for displaying multi-segment bars with up to 4 stacked values and customizable colors, including GameTooltip integration

Description

A reusable progress bar library for World of Warcraft addon development that can display up to 4 different values and colors in a single progress bar.

Features

Progress Bar Library (Krowi_ProgressBar)

  • Multi-Value Display: Show up to 4 different values with individual colors in a single progress bar
  • Flexible Styling: Customizable colors for each value segment
  • Easy Integration: Simple API for quick implementation
  • LibStub Support: Standard LibStub library structure for dependency management

Game Tooltip Integration (Krowi_GameTooltipWithProgressBar)

  • Tooltip Progress Bars: Easily add progress bars to game tooltips
  • Automatic Management: Automatically handles tooltip show/hide events
  • Flexible Positioning: Automatically positions within tooltips

Usage Examples

Basic Progress Bar

local ProgressBarLib = LibStub("Krowi_ProgressBar")
local progressBar = ProgressBarLib:GetNew(parentFrame)

progressBar:SetMinMaxValues(0, 100)
progressBar:SetValues(50, 25, 15, 10)  -- Four segments
progressBar:SetColors(
    {R = 0, G = 1, B = 0},  -- Green
    {R = 1, G = 1, B = 0},  -- Yellow
    {R = 1, G = 0.5, B = 0}, -- Orange
    {R = 1, G = 0, B = 0}   -- Red
)
progressBar:UpdateTextures()
progressBar:Show()

Tooltip Integration

local TooltipProgressBar = LibStub("Krowi_GameTooltipWithProgressBar-2.0")

-- Add progress bar to tooltip
TooltipProgressBar:Show(
    GameTooltip,
    0, 100,           -- min, max
    50, 25, 15, 10,   -- value1, value2, value3, value4
    {R = 0, G = 1, B = 0},  -- color1 (green)
    {R = 1, G = 1, B = 0},  -- color2 (yellow)
    {R = 1, G = 0.5, B = 0}, -- color3 (orange)
    {R = 1, G = 0, B = 0},  -- color4 (red)
    "Progress: 100/100"      -- text label
)

API Reference

Krowi_ProgressBar

Creating a Progress Bar

local ProgressBarLib = LibStub("Krowi_ProgressBar")
local progressBar = ProgressBarLib:GetNew(parentFrame)

Progress Bar Functions

Function Parameters Description
GetNew(parent) parent (frame, optional) Creates a new progress bar frame. Parent defaults to UIParent
SetMinMaxValues(min, max) min (number), max (number) Sets the minimum and maximum values for the progress bar scale
SetValues(v1, v2, v3, v4) v1, v2, v3, v4 (numbers) Sets up to 4 values to display as stacked segments
SetColors(c1, c2, c3, c4) c1, c2, c3, c4 (color tables) Sets colors for each segment. Color format: {R=r, G=g, B=b} (0-1 range)
UpdateTextures() - Recalculates and redraws the progress bar. Call after changing values or colors
Reset() - Resets all values to 0 and colors to black
AdjustOffsets(x, y) x, y (numbers) Adjusts internal rendering offsets. Default is 4, 5
Show() - Shows the progress bar frame
Hide() - Hides the progress bar frame

Color Format

Colors must be tables with R, G, B keys (values 0-1):

{R = 0, G = 1, B = 0}     -- Green
{R = 1, G = 0, B = 0}     -- Red
{R = 1, G = 1, B = 0}     -- Yellow
{R = 1, G = 0.5, B = 0}   -- Orange

Krowi_GameTooltipWithProgressBar

Tooltip Integration

local TooltipProgressBar = LibStub("Krowi_GameTooltipWithProgressBar")

Tooltip Functions

Function Parameters Description
Show(tooltip, min, max, v1, v2, v3, v4, c1, c2, c3, c4, text) See below Adds and shows a progress bar on the specified tooltip

Show() Parameters:

Parameter Type Description
tooltip frame The tooltip frame (usually GameTooltip)
min number Minimum value for the progress bar scale
max number Maximum value for the progress bar scale
v1, v2, v3, v4 numbers Up to 4 values to display as stacked segments
c1, c2, c3, c4 color tables Colors for each segment (format: {R=r, G=g, B=b})
text string Optional text label to display with the progress bar

Note: The tooltip progress bar automatically hides when the tooltip hides.

Use Cases

  • Achievement progress tracking
  • Quest completion status
  • Multi-currency displays
  • Reputation gains
  • Item quality breakdowns
  • Any scenario requiring visual representation of multiple values

Requirements

  • Krowi_LibMan