Class ColorStringParser


  • public class ColorStringParser
    extends StringParser
    A StringParser for parsing java.awt.Color objects. Color information can be specified in a variety of formats:
    • RGB, as integers in the range 0-255, separated by commas (e.g., "123,45,6")
    • RGB, as floats in the range 0.0-1.0, separated by commas (e.g., "0.123,0.45,0.6")
    • RGB, as hexadecimal strings following the '#' character (e.g., "#1234ef")
    • By name, as matching the names of the color fields of java.awt.Color (case-insensitive). (e.g., "black")
    • RGBAlpha, as integers in the range 0-255, separated by commas (e.g., "123,45,6,128")
    • RGBAlpha, as floats in the range 0.0-1.0, separated by commas (e.g., "0.123,0.45,0.6,.5")
    • RGBAlpha, as hexadecimal strings following the '#' character (e.g., "#1234efab")
    If the specified argument does not match any of these formats, a ParseException is thrown.
    Author:
    Marty Lamb
    See Also:
    StringParser, Color
    • Constructor Detail

      • ColorStringParser

        public ColorStringParser()
        Deprecated.
        Use getParser() or, even better, JSAP.COLOR_PARSER.
        Creates a new ColorStringParser.
    • Method Detail

      • parse

        public Object parse​(String arg)
                     throws ParseException
        Parses java.awt.Color objects from Strings. Color information can be specified in a variety of formats:
        • RGB, as integers in the range 0-255, separated by commas (e.g., "123,45,6")
        • RGB, as floats in the range 0.0-1.0, separated by commas (e.g., "0.123,0.45,0.6")
        • RGB, as hexadecimal strings following the '#' character (e.g., "#1234ef")
        • By name, as matching the names of the color fields of java.awt.Color (case-insensitive). (e.g., "black")
        • RGBAlpha, as integers in the range 0-255, separated by commas (e.g., "123,45,6,128")
        • RGBAlpha, as floats in the range 0.0-1.0, separated by commas (e.g., "0.123,0.45,0.6,.5")
        • RGBAlpha, as hexadecimal strings following the '#' character (e.g., "#1234efab")
        If the specified argument does not match any of these formats, a ParseException is thrown.
        Specified by:
        parse in class StringParser
        Parameters:
        arg - the String to convert to a Color object.
        Returns:
        the Color specified by arg.
        Throws:
        ParseException - if arg cannot be interpreted as a Color as described above.