com.github.tommyettinger.textra

Interface ColorLookup

All Known Implementing Classes:

ColorLookup.GdxColorLookup

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ColorLookup

Allows looking up an RGBA8888 int color given a String key, returning either the color or 256 if none was found. This is an extension point for games and libraries that may want their own way of looking up colors. This can be treated as a functional interface in Java 8 and higher.
You can see how this is used in SquidSquad, which uses it in its squidglyph module to look up colors by potentially complex descriptive terms.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ColorLookup.GdxColorLookup The default ColorLookup, this simply looks up key in Colors, returning 256 (fully transparent, extremely dark blue) if no Color exists by that exact name (case-sensitive), or returning the RGBA8888 value of the color otherwise.

Field Summary

Fields

Modifier and Type	Field and Description
static ColorLookup.GdxColorLookup	INSTANCE The default ColorLookup, this simply looks up key in Colors.

Method Summary

Modifier and Type	Method and Description
int	getRgba(java.lang.String key) Uses key to look up an RGBA8888 color, and returns that color as an int if one was found, or returns 256 if none was found.

Field Detail

INSTANCE

static final ColorLookup.GdxColorLookup INSTANCE

The default ColorLookup, this simply looks up key in Colors. It returns 256 (fully transparent, extremely dark blue) if no Color exists by that exact name (case-sensitive), or returning the RGBA8888 value of the color otherwise. All color names are ALL_CAPS in libGDX's Colors collection by default. This can also be accessed with ColorLookup.GdxColorLookup.INSTANCE.

Method Detail

getRgba

int getRgba(java.lang.String key)

Uses key to look up an RGBA8888 color, and returns that color as an int if one was found, or returns 256 if none was found. 256 is used because it is different from the more commonly-used 0 for fully-transparent, while still being easy to remember and very rare to ever want (it is fully transparent, very dark blue). This library will never call this method with a null key, and in most cases you can safely assume key is non-null.

Parameters:

key - the String key to use to look up or build a color; should not be null.

Returns:

an RGBA8888 color; if 256, this can be considered to not know how to look up the given key.