Skip to content

Fix #22: Add documentation for converting RGB values to color palette indices #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Ununp3ntium115 wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Fix #22: Add documentation for converting RGB values to color palette indices #37

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9ade8a4
Fix #22: Add documentation for converting RGB values to color palette…
Jan 16, 2026
dfd1455
Update AbletonPush2MIDIDisplayInterface.asc
Ununp3ntium115 Jan 16, 2026
b92afeb
Update AbletonPush2MIDIDisplayInterface.asc
Ununp3ntium115 Jan 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions doc/AbletonPush2MIDIDisplayInterface.asc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -441,6 +441,29 @@ Reply: ++[F0 00 21 1D 01 01 **04 7D 00 00 00 00 7F 01 7E 00** F7]++ = entry 125
6+|Example: ++[F0 00 21 1D 01 01 **05** F7]++ = trigger palette reapplication
|===

Converting RGB Values to Color Palette Indices
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Push 2 LEDs do not accept direct RGB values. Colors must be specified using
color palette indices (0-127). To convert an arbitrary RGB color to the closest
available palette index:

1. Retrieve the complete color palette by querying all 128 entries (0-127)
using the "Get LED Color Palette Entry" command (0x04).

2. For each palette entry, calculate the distance between your target RGB
color and the palette entry's RGB values. Common distance metrics include:
- Euclidean distance in RGB space: sqrt((R1-R2)² + (G1-G2)² + (B1-B2)²)
Comment thread
Ununp3ntium115 marked this conversation as resolved.
Outdated
- Perceptual color distance (e.g., using LAB color space) for better
visual matching

Comment thread
Ununp3ntium115 marked this conversation as resolved.
Outdated
3. Select the palette index with the minimum distance.

Alternatively, you can modify the palette to add custom colors by using the
Comment thread
Ununp3ntium115 marked this conversation as resolved.
"Set LED Color Palette Entry" command (0x03) to overwrite existing palette
entries with your desired RGB values. After modifying palette entries, send
the "Reapply Color Palette" command (0x05) to apply the changes.

White LED Color Processing
^^^^^^^^^^^^^^^^^^^^^^^^^^

Expand Down
Loading