Package org.polyfrost.polyui.color

Class Color.Chroma

  • All Implemented Interfaces:
    kotlin.Cloneable 
    
public final class Color.Chroma
extends Color.Animated

    A color that changes over time, in an endless cycle. You can use the saturation and brightness fields to set the tone of the chroma. Some examples:

    brightness = 0.2f, saturation = 0.8f -> dark chroma

    brightness = 0.8f, saturation = 0.8f -> less offensive chroma tone

    • Constructor Detail

      • Color.Chroma

        Color.Chroma(Long speedNanos, Float brightness, Float saturation, Float alpha, Float initialHue)
        Parameters:
        initialHue - the initial hue of the color, being any float value.

      • Color.Chroma

        Color.Chroma(Long speedNanos, Float brightness, Float saturation)

      • Color.Chroma

        Color.Chroma(Long speedNanos, Float brightness)

      • Color.Chroma

        Color.Chroma(Long speedNanos)

      • Color.Chroma

        Color.Chroma()

    • Method Detail

      • getSpeedNanos

         final Long getSpeedNanos()

        the speed of this color, in nanoseconds.

        The speed refers to the amount of time it takes for this color to complete one cycle, e.g. from red, through to blue, through to green, then back to red.

      • setSpeedNanos

         final Unit setSpeedNanos(Long speedNanos)

        the speed of this color, in nanoseconds.

        The speed refers to the amount of time it takes for this color to complete one cycle, e.g. from red, through to blue, through to green, then back to red.

      • recolor

        @Deprecated(message = "Chroma colors cannot be animated.", level = DeprecationLevel.ERROR) Unit recolor(Color target, Animation.Type type, Long durationNanos)

        recolor this color to the target color, with the given animation type and duration.

        make sure to check if the color is a gradient, as this method may not have the expected result!

        Parameters:
        type - animation type.

      • freeze

         final Color.Animated freeze()

        Convert this chroma color to a mutable color, which is a snapshot of this color at the time of calling this method.

        Since:

        0.19.1

      • update

         Boolean update(Long deltaTimeNanos)

        update the color animation, if present. After, the animation is cleared, and the color becomes static again.

        Returns:

        true if the animation finished on this tick, false if otherwise