dColor.java

package net.aufdemrand.denizen.objects;

import java.lang.reflect.Field;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import net.aufdemrand.denizen.objects.properties.Property;
import net.aufdemrand.denizen.objects.properties.PropertyParser;
import net.aufdemrand.denizen.utilities.Utilities;
import org.bukkit.Color;

import net.aufdemrand.denizen.tags.Attribute;
import net.aufdemrand.denizen.utilities.debugging.dB;
import org.bukkit.DyeColor;

public class dColor implements dObject {

    final static Pattern rgbPattern = Pattern.compile("(\\d+)[,:](\\d+)[,:](\\d+)");

    //////////////////
    //    OBJECT FETCHER
    ////////////////

    /**
     * Gets a Color Object from a string form.
     *
     * @param string  the string
     * @return  a Color, or null if incorrectly formatted
     *
     */
    @Fetchable("co")
    public static dColor valueOf(String string) {

        string = string.toUpperCase().replace("CO@", "");

        if (string.matches("RANDOM")) {

            // Get a color using random RGB values
            return new dColor(Utilities.getRandom().nextInt(256),
                    Utilities.getRandom().nextInt(256),
                    Utilities.getRandom().nextInt(256));
        }

        Matcher m = rgbPattern.matcher(string);

        if (m.matches())
            return new dColor(aH.getIntegerFrom(m.group(1)),
                    aH.getIntegerFrom(m.group(2)),
                    aH.getIntegerFrom(m.group(3)));

        Field colorField = null;

        try {
            colorField = Color.class.getField(string.toUpperCase());
        } catch (SecurityException e1) {
            dB.echoError("Security exception getting color field!");
        } catch (NoSuchFieldException e1) {
            dB.echoError("No such color field!");
        }

        if (colorField != null)
            return new dColor(colorField);

        // No match
        return null;
    }

    /**
     * Determines whether a string is a valid color.
     *
     * @param arg  the string
     * @return  true if matched, otherwise false
     *
     */
    public static boolean matches(String arg) {

        arg = arg.toUpperCase().replace("CO@", "");

        if (arg.toUpperCase().matches("RANDOM"))
            return true;

        Matcher m = rgbPattern.matcher(arg);

        if (m.matches())
            return true;

        for (Field field : Color.class.getFields())
            if (arg.toUpperCase().matches(field.getName())) return true;

        return false;
    }


    ///////////////
    //   Constructors
    /////////////

    public dColor(int red, int green, int blue) {
        color = Color.fromRGB(red, green, blue);
    }

    public dColor(Field field) {
        try {
            color = (Color) field.get(null);
        } catch (Exception e) {
            dB.echoError("Exception trying to fetch color!");
        }
    }

    public dColor(Color color) {
        this.color = color;
    }

    public dColor(DyeColor dyeColor) {
        this.color = dyeColor.getColor();
    }


    /////////////////////
    //   INSTANCE FIELDS/METHODS
    /////////////////

    // Associated with Bukkit Color

    private Color color;

    public Color getColor() {
        return color;
    }

    String prefix = "color";

    @Override
    public String getPrefix() {
        return prefix;
    }

    @Override
    public String debug() {
        return (prefix + "='<A>" + identify() + "<G>'  ");
    }

    @Override
    public boolean isUnique() {
        return false;
    }

    @Override
    public String getObjectType() {
        return "Color";
    }

    @Override
    public String identify() {
        for (Field field : Color.class.getFields()) {
            try {
                if (((Color) field.get(null)).asRGB() == getColor().asRGB())
                    return "co@" + field.getName();
            } catch (Exception e) {
                dB.echoError("Exception trying to fetch color!");
            }
        }
        return "co@" + getColor().getRed() + "," + getColor().getGreen() + "," + getColor().getBlue();
    }

    @Override
    public String identifySimple() {
        return identify();
    }

    @Override
    public String toString() {
        return identify();
    }

    @Override
    public dObject setPrefix(String prefix) {
        if (prefix != null)
            this.prefix = prefix;
        return this;
    }

    @Override
    public String getAttribute(Attribute attribute) {
        // <--[tag]
        // @attribute <co@color.red>
        // @returns Element(Number)
        // @description
        // returns the red value of this color.
        // -->
        if (attribute.startsWith("red"))
            return new Element(color.getRed()).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.green>
        // @returns Element(Number)
        // @description
        // returns the green value of this color.
        // -->
        if (attribute.startsWith("green"))
            return new Element(color.getGreen()).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.blue>
        // @returns Element(Number)
        // @description
        // returns the blue value of this color.
        // -->
        if (attribute.startsWith("blue"))
            return new Element(color.getBlue()).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.rgb>
        // @returns Element
        // @description
        // returns the RGB value of this color.
        // EG, 255,0,255
        // -->
        if (attribute.startsWith("rgb"))
            return new Element(color.getRed() + "," + color.getGreen() + "," + color.getBlue()).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.hue>
        // @returns Element(Number)
        // @description
        // returns the hue value of this color.
        // -->
        if (attribute.startsWith("hue"))
            return new Element(ToHSB()[0]).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.saturation>
        // @returns Element(Number)
        // @description
        // returns the saturation value of this color.
        // -->
        if (attribute.startsWith("saturation"))
            return new Element(ToHSB()[1]).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.brightness>
        // @returns Element(Number)
        // @description
        // returns the brightness value of this color.
        // -->
        if (attribute.startsWith("brightness"))
            return new Element(ToHSB()[2]).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.hsv>
        // @returns Element
        // @description
        // returns the HSV value of this color.
        // EG, 100,100,255
        // -->
        if (attribute.startsWith("hsv")) {
            int[] HSV = ToHSB();
            return new Element(HSV[1] + "," + HSV[1] + "," + HSV[2]).getAttribute(attribute.fulfill(1));
        }

        // <--[tag]
        // @attribute <co@color.name>
        // @returns Element
        // @description
        // returns the name of this color (or red,green,blue if none).
        // -->
        if (attribute.startsWith("name"))
            return new Element(identify().substring(3)).getAttribute(attribute.fulfill(1));

        // <--[tag]
        // @attribute <co@color.mix[<color>]>
        // @returns dColor
        // @description
        // returns the color that results if you mix this color with another.
        // -->
        if (attribute.startsWith("mix")
                && attribute.hasContext(1)) {
            dColor mixed_with = dColor.valueOf(attribute.getContext(1));
            if (mixed_with != null)
                return new dColor(color.mixColors(mixed_with.getColor())).getAttribute(attribute.fulfill(1));
            else
                dB.echoError("'" + attribute.getContext(1) + "' is not a valid color!");
        }

        // Iterate through this object's properties' attributes
        for (Property property : PropertyParser.getProperties(this)) {
            String returned = property.getAttribute(attribute);
            if (returned != null) return returned;
        }

        return new Element(identify()).getAttribute(attribute);
    }

    int[] ToHSB() {
        float[] base = java.awt.Color.RGBtoHSB(color.getRed(), color.getGreen(), color.getBlue(), null);
        return new int[] { (int)(base[0] * 255), (int)(base[1] * 255), (int)(base[2] * 255)};
    }
}