intstatic final int[]protected floatintstatic final int[]protected floatstatic final int[]static final float[][]static final float[][]final int[]final int[]final byte[]final byte[]paletteArray (when treated as unsigned; mask with 255) corresponding to
RGB555 colors (you can get an RGB555 int from an RGBA8888 int using shrink(int)).protected floatprotected floatcom.badlogic.gdx.utils.IntIntMapstatic final byte[]com.badlogic.gdx.utils.IntIntMapstatic final byte[]static final byte[]static final byte[]static final float[]static final byte[]static final float[]TRI_BLUE_NOISE.PaletteReducer(int[] rgbaPalette) com.badlogic.gdx.graphics.PixmapreduceBlueNoise(com.badlogic.gdx.graphics.Pixmap pixmap) TRI_BLUE_NOISE, but shouldn't usually be modified) as well as a 8x8 threshold matrix (the kind
+ used by reduceKnoll(Pixmap), but larger).com.badlogic.gdx.graphics.PixmapreduceBlueNoiseSeparated(com.badlogic.gdx.graphics.Pixmap pixmap) TRI_BLUE_NOISE, TRI_BLUE_NOISE_B, TRI_BLUE_NOISE_C, and
TRI_BLUE_NOISE_D, but shouldn't usually be modified).com.badlogic.gdx.graphics.PixmapreduceChaoticNoise(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceChaoticNoise(com.badlogic.gdx.graphics.Pixmap pixmap) floatreduceFloat(float packedColor) floatreduceFloat(float packedColor) color as if it was part of an image being color-reduced and finds the closest color to it in the
palette this holds.com.badlogic.gdx.graphics.PixmapreduceFloydSteinberg(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceFloydSteinberg(com.badlogic.gdx.graphics.Pixmap pixmap) bytereduceIndex(int color) bytereduceIndex(int color) color as if it was part of an image being color-reduced and finds the closest color to it in the
palette this holds.com.badlogic.gdx.graphics.ColorreduceInPlace(com.badlogic.gdx.graphics.Color color) com.badlogic.gdx.graphics.ColorreduceInPlace(com.badlogic.gdx.graphics.Color color) color so its RGB values will match the closest color in this PaletteReducer's palette.com.badlogic.gdx.graphics.PixmapreduceJimenez(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceJimenez(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceKnoll(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceKnoll(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceKnollRoberts(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceKnollRoberts(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceNeue(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceNeue(com.badlogic.gdx.graphics.Pixmap pixmap) reduceFloydSteinberg(Pixmap), but adding in triangular-mapped blue
noise before diffusing, like reduceBlueNoise(Pixmap).com.badlogic.gdx.graphics.PixmapreduceScatter(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceScatter(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceSierraLite(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceSierraLite(com.badlogic.gdx.graphics.Pixmap pixmap) reduce(Pixmap) uses.intreduceSingle(int color) intreduceSingle(int color) color as if it was part of an image being color-reduced and finds the closest color to it in the
palette this holds.com.badlogic.gdx.graphics.PixmapreduceSolid(com.badlogic.gdx.graphics.Pixmap pixmap) com.badlogic.gdx.graphics.PixmapreduceSolid(com.badlogic.gdx.graphics.Pixmap pixmap) static floatreverseLight(float L) static floatreverseLight(float L) voidvoidsetDitherStrength(float ditherStrength) voidsetDitherStrength(float ditherStrength) reduce(Pixmap) calls.static intshrink(int color) static intshrink(int color) OKLAB to look up colors.static voidsort(int[] items,
+static void
+sort(int[] items,
int from,
int to,
com.github.tommyettinger.anim8.PaletteReducer.IntComparator c)
-
+
Sorts the specified range of elements according to the order induced by the specified
comparator using mergesort.
-static void
-sort(int[] items,
+static void
+sort(int[] items,
com.github.tommyettinger.anim8.PaletteReducer.IntComparator c)
-
+
Sorts all of items by simply calling sort(int[], int, int, IntComparator),
setting from and to so the whole array is sorted.
-static int
-stretch(int color)
-
+static int
+stretch(int color)
+
Converts an RGB555 int color to an approximation of the closest RGBA8888 color.
-void
-writePreloadFile(com.badlogic.gdx.files.FileHandle file)
-
+void
+writePreloadFile(com.badlogic.gdx.files.FileHandle file)
+
If this PaletteReducer has already calculated a palette, you can use this to save the slightly-slow-to-compute
palette mapping in a preload file for later runs.
@@ -728,6 +740,26 @@ Methods inherited from cl
Field Details
-
+
+AURORA
+public static final int[] AURORA
+DawnBringer's 256-color Aurora palette, modified slightly to fit one transparent color by removing one gray.
+ Aurora is available in this set of tools
+ for a pixel art editor, but it is usable for lots of high-color purposes.
+
+ These colors all have names, which can be seen previewed here. The
+ linked image preview also shows a nearby lighter color and two darker colors on the same sphere as the main
+ color; the second-lightest color is what has the listed name. The names here are used by a few other libraries,
+ such as colorful-gdx, but otherwise don't matter.
+
+ This replaced another palette, Haltonic, that wasn't hand-chosen and was much more "randomized."
+
+ While you can modify the individual items in this array, this is discouraged, because various constructors and
+ methods in this class use AURORA with a pre-made distance mapping of its colors. This mapping would become
+ incorrect if any colors in this array changed.
+
+
+-
HALTONIC
public static final int[] HALTONIC
@@ -737,11 +769,7 @@ HALTONIC
sequence provides one of the stronger guarantees that removing any sequential items (after the first 9, which are
preset grayscale colors) will produce a similarly-distributed palette. Typically, 64 items from this are enough
to make pixel art look good enough with dithering, and it continues to improve with more colors. It has exactly 8
- colors that are purely grayscale, all right at the start after transparent.
-
- While you can modify the individual items in this array, this is discouraged, because various constructors and
- methods in this class use HALTONIC with a pre-made distance mapping of its colors. This mapping would become
- incorrect if any colors in this array changed.
+ colors that are purely grayscale, all right at the start after transparent.
-
@@ -890,9 +918,9 @@
Constructor Details
PaletteReducer
public PaletteReducer()
-Constructs a default PaletteReducer that uses the "Haltonic" 255-color-plus-transparent palette.
+Constructs a default PaletteReducer that uses the "Aurora" 255-color-plus-transparent palette.
Note that this uses a more-detailed and higher-quality metric than you would get by just specifying
- new PaletteReducer(PaletteReducer.HALTONIC); this metric would be too slow to calculate at
+ new PaletteReducer(PaletteReducer.AURORA); this metric would be too slow to calculate at
runtime, but as pre-calculated data it works very well.
@@ -997,7 +1025,7 @@ PaletteReducer
- Parameters:
pixmap - a Pixmap to analyze in detail to produce a palettethreshold - the minimum difference between colors required to put them in the palette (default 150)threshold - the minimum difference between colors required to put them in the palette (default 100)
@@ -1323,10 +1351,10 @@ differenceHW
setDefaultPalette
public void setDefaultPalette()
-Resets the palette to the 256-color (including transparent) "Haltonic" palette. PaletteReducer already
+Resets the palette to the 256-color (including transparent) "Aurora" palette. PaletteReducer already
stores most of the calculated data needed to use this one palette. Note that this uses a more-detailed
and higher-quality metric than you would get by just specifying
- new PaletteReducer(PaletteReducer.HALTONIC); this metric would be too slow to calculate at
+ new PaletteReducer(PaletteReducer.AURORA); this metric would be too slow to calculate at
runtime, but as pre-calculated data it works very well.
@@ -1337,7 +1365,7 @@ exact
Builds the palette information this PNG8 stores from the RGBA8888 ints in rgbaPalette, up to 256 colors.
Alpha is not preserved except for the first item in rgbaPalette, and only if it is 0 (fully transparent
black); otherwise all items are treated as opaque. If rgbaPalette is null, empty, or only has one color, then
- this defaults to the "Haltonic" palette with 256 well-distributed colors (including transparent).
+ this defaults to the "Aurora" palette with 256 well-distributed colors (including transparent).
- Parameters:
rgbaPalette - an array of RGBA8888 ints; all will be used up to 256 items or the length of the arrayexact
or limit, whichever is less.
Alpha is not preserved except for the first item in rgbaPalette, and only if it is 0 (fully transparent
black); otherwise all items are treated as opaque. If rgbaPalette is null, empty, or only has one color, or if
- limit is less than 2, then this defaults to the "Haltonic" palette with 256 well-distributed colors (including
+ limit is less than 2, then this defaults to the "Aurora" palette with 256 well-distributed colors (including
transparent).
- Parameters:
@@ -1388,7 +1416,7 @@ exact
256 colors.
Alpha is not preserved except for the first item in colorPalette, and only if its r, g, b, and a values are all
0f (fully transparent black); otherwise all items are treated as opaque. If rgbaPalette is null, empty, or only
- has one color, then this defaults to the "Haltonic" palette with 256 well-distributed colors (including
+ has one color, then this defaults to the "Aurora" palette with 256 well-distributed colors (including
transparent).
- Parameters:
@@ -1405,7 +1433,7 @@ exact
256 colors or limit, whichever is less.
Alpha is not preserved except for the first item in colorPalette, and only if its r, g, b, and a values are all
0f (fully transparent black); otherwise all items are treated as opaque. If rgbaPalette is null, empty, only has
- one color, or limit is less than 2, then this defaults to the "Haltonic" palette with 256 well-distributed
+ one color, or limit is less than 2, then this defaults to the "Aurora" palette with 256 well-distributed
colors (including transparent).
- Parameters:
@@ -1426,7 +1454,7 @@ analyze
aren't exact, and dithering works better when the palette can choose colors that are sufficiently different, this
uses a threshold value to determine whether it should permit a less-common color into the palette, and if the
second color is different enough (as measured by differenceAnalyzing(int, int)) by a value of at least
- 150, it is
+ 100, it is
allowed in the palette, otherwise it is kept out for being too similar to existing colors. This doesn't return a
value but instead stores the palette info in this object; a PaletteReducer can be assigned to the
PNG8.palette field or can be used directly to reduce(Pixmap) a Pixmap.
@@ -1628,7 +1656,7 @@ analyze
sufficiently different, this takes a threshold value to determine whether it should permit a less-common color
into the palette, and if the second color is different enough (as measured by
differenceAnalyzing(int, int, int, int)) by a
- value of at least 150, it is allowed in the palette, otherwise it is kept out for being too similar to existing
+ value of at least 100, it is allowed in the palette, otherwise it is kept out for being too similar to existing
colors. This doesn't return a value but instead stores the palette info in this object; a PaletteReducer can be
assigned to the PNG8.palette or AnimatedGif.palette fields, or can be used directly to
reduce(Pixmap) a Pixmap. 
differenceHW(int, int, int, int)) by a
- value of at least 150, it is allowed in the palette, otherwise it is kept out for being too similar to existing
+ value of at least 100, it is allowed in the palette, otherwise it is kept out for being too similar to existing
colors. This doesn't return a value but instead stores the palette info in this object; a PaletteReducer can be
assigned to the PNG8.palette or AnimatedGif.palette fields, or can be used directly to
reduce(Pixmap) a Pixmap.TRI_BLUE_NOISE, but shouldn't usually be modified) as well as a 8x8 threshold matrix (the kind
+ used by reduceKnoll(Pixmap), but larger). This has a tendency to look closer to a color
+ reduction with no dither (as with reduceSolid(Pixmap) than to one with too much dither. Because it is an
+ ordered dither, it avoids "swimming" patterns in animations with large flat sections of one color; these swimming
+ effects can appear in all the error-diffusion dithers here. If you can tolerate "spongy" artifacts appearing
+ (which look worse on small palettes), you may get very good handling of lightness by raising dither strength.pixmap - will be modified in-place and returnedTRI_BLUE_NOISE, TRI_BLUE_NOISE_B, TRI_BLUE_NOISE_C, and
TRI_BLUE_NOISE_D, but shouldn't usually be modified). This has a tendency to look closer to a color
reduction with no dither (as with reduceSolid(Pixmap) than to one with too much dither. Because it is an
ordered dither, it avoids "swimming" patterns in animations with large flat sections of one color; these swimming
- effects can appear in all the error-diffusion dithers here.pixmap - will be modified in-place and returnedPaletteReducer.TRI_BLUE_NOISE, but shouldn't usually be modified) as well as a 8x8 threshold matrix (the kind
+ used by PaletteReducer.reduceKnoll(Pixmap), but larger).PaletteReducer.TRI_BLUE_NOISE, PaletteReducer.TRI_BLUE_NOISE_B, PaletteReducer.TRI_BLUE_NOISE_C, and
PaletteReducer.TRI_BLUE_NOISE_D, but shouldn't usually be modified).