Add usage guide to README covering main features

Co-Authored-By: Mr_Rosh <teddrosh95@gmail.com>
This commit is contained in:
Devin AI
2026-04-11 14:03:27 +00:00
co-authored by Mr_Rosh
parent 178e7b9980
commit 2f858c5683
+73
View File
@@ -5,3 +5,76 @@ Original: http://www.curse.com/addons/wow/colorpickerplus
Adds improved features to the existing Blizzard color picker widget. Features
like copying and pasting colors, RGBA channel values, hex value and color
swatches for the old color and color in the copy buffer.
## Usage Guide
ColorPickerPlus enhances the standard Blizzard color picker by adding precise
color input, copy/paste support, and visual color swatches. Once installed, these
features appear automatically whenever the in-game color picker opens.
### Text Entry for RGB and Hex Values
Instead of relying solely on the color wheel, you can type exact color values
directly into the input fields at the bottom of the color picker:
- **R, G, B fields** — Enter individual red, green, and blue channel values
from 0 to 255 for precise numeric control over each color component.
- **Hex field (#)** — Enter a 6-character hex color code (e.g. `FF5A00`) to set
all three channels at once. This is useful when matching colors from external
design tools or web references.
- **Alpha field (A)** — When the color picker includes an opacity option, an
alpha field appears. Enter a value from 0 to 100 to set the opacity
percentage.
All fields stay in sync: changing the RGB values updates the hex field
automatically, and entering a hex code updates the individual R, G, and B
values. You can press **Tab** to cycle between the fields in order
(R → G → B → Hex → Alpha → R).
### Copy and Paste Colors
Two buttons are added to the color picker dialog:
- **Copy** — Saves the currently selected color (and alpha, if applicable) to an
internal buffer. A swatch showing the copied color appears below the Paste
button.
- **Paste** — Applies the previously copied color to the picker, instantly
setting the RGB values and alpha. This button is disabled until a color has
been copied.
This lets you reuse a color across different UI elements without having to
remember or re-enter the values each time.
> **Tip:** Hold **Shift** and click **Copy** to print the raw decimal color
> values (0.000–1.000) to the chat window — handy for addon development and
> macro scripting.
### Color Swatches
Two color swatches are displayed alongside the current color swatch:
- **Starting color swatch** — Shows the original color that was set before you
opened the picker, so you can always compare your changes against the
previous color.
- **Copied color swatch** — Shows the color currently stored in the copy buffer
after pressing Copy, giving you a visual reference of the saved color.
### Movable Color Picker
The color picker frame can be dragged around the screen by clicking and dragging
its title bar area. It is clamped to the screen edges so it cannot be moved
out of view.
### How These Features Enhance the Standard Color Picker
The default Blizzard color picker only provides a color wheel and brightness
slider, making it difficult to select an exact color or reuse one across
different settings. ColorPickerPlus solves these limitations by adding:
| Feature | Standard Picker | With ColorPickerPlus |
|----------------------|-----------------|---------------------------------|
| Color input method | Wheel only | Wheel, RGB fields, and hex code |
| Color reuse | Not supported | Copy and paste between pickers |
| Previous color ref | Not shown | Starting color swatch |
| Opacity text entry | Slider only | Slider and numeric field |
| Repositioning | Fixed position | Draggable frame |