Package org.bukkit
Class Color
- java.lang.Object
-
- org.bukkit.Color
-
- All Implemented Interfaces:
ConfigurationSerializable
public final class Color extends Object implements ConfigurationSerializable
A container for a color palette. This class is immutable; the set methods return a new color. The color names listed as fields are HTML4 standards, but subject to change.
-
-
Field Summary
Fields Modifier and Type Field Description static Color
AQUA
Aqua, or (0x00,0xFF,0xFF) in (R,G,B)static Color
BLACK
Black, or (0x00,0x00,0x00) in (R,G,B)static Color
BLUE
Blue, or (0x00,0x00,0xFF) in (R,G,B)static Color
FUCHSIA
Fuchsia, or (0xFF,0x00,0xFF) in (R,G,B)static Color
GRAY
Gray, or (0x80,0x80,0x80) in (R,G,B)static Color
GREEN
Green, or (0x00,0x80,0x00) in (R,G,B)static Color
LIME
Lime, or (0x00,0xFF,0x00) in (R,G,B)static Color
MAROON
Maroon, or (0x80,0x00,0x00) in (R,G,B)static Color
NAVY
Navy, or (0x00,0x00,0x80) in (R,G,B)static Color
OLIVE
Olive, or (0x80,0x80,0x00) in (R,G,B)static Color
ORANGE
Orange, or (0xFF,0xA5,0x00) in (R,G,B)static Color
PURPLE
Purple, or (0x80,0x00,0x80) in (R,G,B)static Color
RED
Red, or (0xFF,0x00,0x00) in (R,G,B)static Color
SILVER
Silver, or (0xC0,0xC0,0xC0) in (R,G,B)static Color
TEAL
Teal, or (0x00,0x80,0x80) in (R,G,B)static Color
WHITE
White, or (0xFF,0xFF,0xFF) in (R,G,B)static Color
YELLOW
Yellow, or (0xFF,0xFF,0x00) in (R,G,B)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description int
asBGR()
int
asRGB()
static Color
deserialize(Map<String,Object> map)
boolean
equals(Object o)
static Color
fromBGR(int bgr)
Creates a new color object from an integer that contains the blue, green, and red bytes in the lowest order 24 bits.static Color
fromBGR(int blue, int green, int red)
Creates a new Color object from a blue, green, and redstatic Color
fromRGB(int rgb)
Creates a new color object from an integer that contains the red, green, and blue bytes in the lowest order 24 bits.static Color
fromRGB(int red, int green, int blue)
Creates a new Color object from a red, green, and blueint
getBlue()
Gets the blue componentint
getGreen()
Gets the green componentint
getRed()
Gets the red componentint
hashCode()
Color
mixColors(Color... colors)
Creates a new color with its RGB components changed as if it was dyed with the colors passed in, replicating vanilla workbench dyeingColor
mixDyes(DyeColor... colors)
Creates a new color with its RGB components changed as if it was dyed with the colors passed in, replicating vanilla workbench dyeingMap<String,Object>
serialize()
Creates a Map representation of this class.Color
setBlue(int blue)
Creates a new Color object with specified componentColor
setGreen(int green)
Creates a new Color object with specified componentColor
setRed(int red)
Creates a new Color object with specified componentString
toString()
-
-
-
Field Detail
-
WHITE
public static final Color WHITE
White, or (0xFF,0xFF,0xFF) in (R,G,B)
-
SILVER
public static final Color SILVER
Silver, or (0xC0,0xC0,0xC0) in (R,G,B)
-
GRAY
public static final Color GRAY
Gray, or (0x80,0x80,0x80) in (R,G,B)
-
BLACK
public static final Color BLACK
Black, or (0x00,0x00,0x00) in (R,G,B)
-
RED
public static final Color RED
Red, or (0xFF,0x00,0x00) in (R,G,B)
-
MAROON
public static final Color MAROON
Maroon, or (0x80,0x00,0x00) in (R,G,B)
-
YELLOW
public static final Color YELLOW
Yellow, or (0xFF,0xFF,0x00) in (R,G,B)
-
OLIVE
public static final Color OLIVE
Olive, or (0x80,0x80,0x00) in (R,G,B)
-
LIME
public static final Color LIME
Lime, or (0x00,0xFF,0x00) in (R,G,B)
-
GREEN
public static final Color GREEN
Green, or (0x00,0x80,0x00) in (R,G,B)
-
AQUA
public static final Color AQUA
Aqua, or (0x00,0xFF,0xFF) in (R,G,B)
-
TEAL
public static final Color TEAL
Teal, or (0x00,0x80,0x80) in (R,G,B)
-
BLUE
public static final Color BLUE
Blue, or (0x00,0x00,0xFF) in (R,G,B)
-
NAVY
public static final Color NAVY
Navy, or (0x00,0x00,0x80) in (R,G,B)
-
FUCHSIA
public static final Color FUCHSIA
Fuchsia, or (0xFF,0x00,0xFF) in (R,G,B)
-
PURPLE
public static final Color PURPLE
Purple, or (0x80,0x00,0x80) in (R,G,B)
-
ORANGE
public static final Color ORANGE
Orange, or (0xFF,0xA5,0x00) in (R,G,B)
-
-
Method Detail
-
fromRGB
@NotNull public static Color fromRGB(int red, int green, int blue) throws IllegalArgumentException
Creates a new Color object from a red, green, and blue- Parameters:
red
- integer from 0-255green
- integer from 0-255blue
- integer from 0-255- Returns:
- a new Color object for the red, green, blue
- Throws:
IllegalArgumentException
- if any value is strictly >255 or <0
-
fromBGR
@NotNull public static Color fromBGR(int blue, int green, int red) throws IllegalArgumentException
Creates a new Color object from a blue, green, and red- Parameters:
blue
- integer from 0-255green
- integer from 0-255red
- integer from 0-255- Returns:
- a new Color object for the red, green, blue
- Throws:
IllegalArgumentException
- if any value is strictly >255 or <0
-
fromRGB
@NotNull public static Color fromRGB(int rgb) throws IllegalArgumentException
Creates a new color object from an integer that contains the red, green, and blue bytes in the lowest order 24 bits.- Parameters:
rgb
- the integer storing the red, green, and blue values- Returns:
- a new color object for specified values
- Throws:
IllegalArgumentException
- if any data is in the highest order 8 bits
-
fromBGR
@NotNull public static Color fromBGR(int bgr) throws IllegalArgumentException
Creates a new color object from an integer that contains the blue, green, and red bytes in the lowest order 24 bits.- Parameters:
bgr
- the integer storing the blue, green, and red values- Returns:
- a new color object for specified values
- Throws:
IllegalArgumentException
- if any data is in the highest order 8 bits
-
getRed
public int getRed()
Gets the red component- Returns:
- red component, from 0 to 255
-
setRed
@NotNull public Color setRed(int red)
Creates a new Color object with specified component- Parameters:
red
- the red component, from 0 to 255- Returns:
- a new color object with the red component
-
getGreen
public int getGreen()
Gets the green component- Returns:
- green component, from 0 to 255
-
setGreen
@NotNull public Color setGreen(int green)
Creates a new Color object with specified component- Parameters:
green
- the red component, from 0 to 255- Returns:
- a new color object with the red component
-
getBlue
public int getBlue()
Gets the blue component- Returns:
- blue component, from 0 to 255
-
setBlue
@NotNull public Color setBlue(int blue)
Creates a new Color object with specified component- Parameters:
blue
- the red component, from 0 to 255- Returns:
- a new color object with the red component
-
asRGB
public int asRGB()
- Returns:
- An integer representation of this color, as 0xRRGGBB
-
asBGR
public int asBGR()
- Returns:
- An integer representation of this color, as 0xBBGGRR
-
mixDyes
@NotNull public Color mixDyes(@NotNull DyeColor... colors)
Creates a new color with its RGB components changed as if it was dyed with the colors passed in, replicating vanilla workbench dyeing- Parameters:
colors
- The DyeColors to dye with- Returns:
- A new color with the changed rgb components
-
mixColors
@NotNull public Color mixColors(@NotNull Color... colors)
Creates a new color with its RGB components changed as if it was dyed with the colors passed in, replicating vanilla workbench dyeing- Parameters:
colors
- The colors to dye with- Returns:
- A new color with the changed rgb components
-
serialize
@NotNull public Map<String,Object> serialize()
Description copied from interface:ConfigurationSerializable
Creates a Map representation of this class.This class must provide a method to restore this class, as defined in the
ConfigurationSerializable
interface javadocs.- Specified by:
serialize
in interfaceConfigurationSerializable
- Returns:
- Map containing the current state of this class
-
-