Class Utils

  • All Implemented Interfaces:

    
    public final class Utils
    
                        
    • Constructor Detail

    • Method Detail

      • HSBtoRGB

         final static Integer HSBtoRGB(Float hue, Float saturation, Float brightness)

        Converts the components of a color, as specified by the HSB model, to an equivalent set of values for the default RGB model.

        The saturation and brightness components should be floating-point values between zero and one (numbers in the range 0.0-1.0). The hue component can be any floating-point number. The floor of this number is subtracted from it to create a fraction between 0 and 1. This fractional number is then multiplied by 360 to produce the hue angle in the HSB color model.

        The integer that is returned by HSBtoRGB encodes the value of a color in bits 0-23 of an integer value that is the same format used by the method getARGB() This integer can be supplied as an argument to the toColor method that takes a single integer argument to create a Color.

        Parameters:
        hue - the hue component of the color
        saturation - the saturation of the color
        brightness - the brightness of the color
        Returns:

        the RGB value of the color with the indicated hue, saturation, and brightness.

      • RGBtoHSB

         final static FloatArray RGBtoHSB(Integer r, Integer g, Integer b, FloatArray out)

        Converts the components of a color, as specified by the default RGB model, to an equivalent set of values for hue, saturation, and brightness that are the three components of the HSB model.

        If the out argument is null, then a new array is allocated to return the result. Otherwise, the method returns the array out, with the values put into that array.

        Parameters:
        r - the red component of the color
        g - the green component of the color
        b - the blue component of the color
        out - the array used to return the three HSB values, or null
        Returns:

        an array of three elements containing the hue, saturation, and brightness (in that order), of the color with the indicated red, green, and blue components.

        Since:

        0.18.2

      • gcd

         final static Integer gcd(Integer $self, Integer b)

        Calculate the greatest common denominator of two integers.

        Since:

        0.18.4

      • cl0

         final static Float cl0(Float a, Float b)

        Returns the value closer to zero.

        If either value is NaN, then the result is NaN.

        If a == b, then the result is a.

      • cl1

         final static Float cl1(Float a, Float b)

        Returns the value closer to one.

        If either value is NaN, then the result is NaN.

        If a == b, then the result is a.

      • min

         final static Integer min(Integer a, Integer b, Integer c)

        Returns the minimum value among three given ints.

        Parameters:
        a - the first value
        b - the second value
        c - the third value
        Returns:

        the minimum value among a, b, and c

      • radii

         final static FloatArray radii(Number $self)

        convert the given float into an array of 4 floats for radii.

      • stdout

         final static <T extends Any> T stdout(T $self, Object arg)

        print the object to stdout, then return it.

      • substringSafe

         final static String substringSafe(String $self, Integer fromIndex, Integer toIndex)

        safe substring function.

        • if fromIndex is negative, it will be set to 0

        • if toIndex is greater than the length of the string, or negative, it will be set to the length of the string

        • if fromIndex is greater than toIndex, they will be swapped, then substring'd as normal

      • truncate

         final static String truncate(String $self, Renderer renderer, Font font, Float fontSize, Float width, String limitText)

        Limit the given string to a width. If the string is too long, it will be cut to the width, and limitText will be appended to the end.

        Since:

        0.22.0

      • substringToWidth

         final static Pair<String, String> substringToWidth(String $self, Renderer renderer, Font font, Float fontSize, Float width)

        take the given string and cut it to the length, returning a pair of the string cut to the length, and the remainder.

        if the string fits within the width, the first string will be the entire string, and the second will be empty.

      • closestToPoint

         final static Integer closestToPoint(String $self, Renderer renderer, Font font, Float fontSize, Float x)

        Returns the closest character index from the given string to the given point x.

        Returns:

        the index of the character closest to the given point x, or -1 if it could not be found.

        Since:

        0.18.5