Package org.bukkit

Class Color

java.lang.Object
org.bukkit.Color
All Implemented Interfaces:
ConfigurationSerializable
public final class Color
extends java.lang.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

    Modifier and Type Method Description
    int asBGR()  
    int asRGB()  
    static Color deserialize​(java.util.Map<java.lang.String,​java.lang.Object> map)  
    boolean equals​(java.lang.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 red
    static 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 blue
    int getBlue()
    Gets the blue component
    int getGreen()
    Gets the green component
    int getRed()
    Gets the red component
    int 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 dyeing
    Color 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 dyeing
    java.util.Map<java.lang.String,​java.lang.Object> serialize()
    Creates a Map representation of this class.
    Color setBlue​(int blue)
    Creates a new Color object with specified component
    Color setGreen​(int green)
    Creates a new Color object with specified component
    Color setRed​(int red)
    Creates a new Color object with specified component
    java.lang.String toString()  

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Field Details

    • 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 Details

    • fromRGB

      public static Color fromRGB​(int red, int green, int blue) throws java.lang.IllegalArgumentException
      Creates a new Color object from a red, green, and blue
      Parameters:
      red - integer from 0-255
      green - integer from 0-255
      blue - integer from 0-255
      Returns:
      a new Color object for the red, green, blue
      Throws:
      java.lang.IllegalArgumentException - if any value is strictly >255 or <0

    • fromBGR

      public static Color fromBGR​(int blue, int green, int red) throws java.lang.IllegalArgumentException
      Creates a new Color object from a blue, green, and red
      Parameters:
      blue - integer from 0-255
      green - integer from 0-255
      red - integer from 0-255
      Returns:
      a new Color object for the red, green, blue
      Throws:
      java.lang.IllegalArgumentException - if any value is strictly >255 or <0

    • fromRGB

      public static Color fromRGB​(int rgb) throws java.lang.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:
      java.lang.IllegalArgumentException - if any data is in the highest order 8 bits

    • fromBGR

      public static Color fromBGR​(int bgr) throws java.lang.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:
      java.lang.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

      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

      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

      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

      public Color 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 dyeing
      Parameters:
      colors - The DyeColors to dye with
      Returns:
      A new color with the changed rgb components

    • mixColors

      public 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 dyeing
      Parameters:
      colors - The colors to dye with
      Returns:
      A new color with the changed rgb components

    • equals

      public boolean equals​(java.lang.Object o)
      Overrides:
      equals in class java.lang.Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class java.lang.Object

    • serialize

      public java.util.Map<java.lang.String,​java.lang.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 interface ConfigurationSerializable
      Returns:
      Map containing the current state of this class

    • deserialize

      public static Color deserialize​(java.util.Map<java.lang.String,​java.lang.Object> map)

    • toString

      public java.lang.String toString()
      Overrides:
      toString in class java.lang.Object