🌈Gradients

Gradients are sequences of Colours from a range of 0 to 1. They can be sampled at any given point between that range (with it looping in the case of being outside that range).

Blending Modes

JFL: Colour has 3 modes for interpolating between two colours in gradients:

• RGB: Regular linear interpolation for all components

• HSV_SHORT: Linear intepolation in the HSV space, taking the shortest path. This has the effect of keeping the colours bright instead of greying in the middle.

• HSV_LONG: Linear interpolation in the HSV space, taking the longest path.

Creating a gradient

Using Gradient.of()

For simple gradients, using Gradient.of() is likely the easiest method. This generates a gradient with equal intervals between colours and RGB blending.

Gradient SOLAR = Gradient.of(
    Colour.fromRGB(40, 23, 0),
    Colours.YELLOW,
    Colours.ORANGE,
    Colours.WHITE
);

Using Gradient.linear()

Using Gradient.linear() creates a gradient between two points, using either RGB or HSV blending modes. For examples of these, see above.

Using Gradient.builder()

For more control, you can use the given GradientBuilder class in order to create one point by point.

Gradient complex = Gradient.builder()
    // adding regular colours
    .add(0f, Colours.RED) 
    .add(0.25f, Colours.PINK)
    
    // adding adding another gradient as part of this one
    .addBlock(0.3f, 0.45f, Gradient.linear(Colours.HOT_PINK, Colours.LIME, Gradient.LinearMode.HSV_LONG))
    
    // adding a sharp cut between two colours
    .addCut(0.5f, Colours.GREEN, Colours.BLUE)
    
    // we use Math.nextDown here to get the point 'just before' the NONBINARY gradient starts. This allows us to
    // make a sharp cut manually
    .add(Math.nextDown(0.75f), Colours.AQUAMARINE)
    
    // GradientBuilder.END is the last value before 1f, where it loops. Use it to add an endpoint to your gradient.
    .addBlock(0.75f, GradientBuilder.END, Gradients.NONBINARY)
    .build()

Modifying a gradient

It may be useful to modify a gradient after it's been created - you can use it in GradientBuilder.addBlock, or some post-processing methods:

squish()

If your gradient has sharp edges, you can squish it in order to make transitions smoother. It does this by shrinking it slightly towards the center, then adding points at 0f and GradientBuilder.END with a lerped colour value.

repeat()

Returns a copy of this gradient shrunken and repeated a certain number of times back to back.

reversed()

Reverses this gradient.

slice()

Returns a subsection of this gradient between the two points. These points can be backwards, and can cross the edges of the gradient boundary. Note that it will not automatically repeat the gradient but will wrap instead.

Drawing gradients

JFL: Colour contains methods to efficiently draw gradients in a GUI context, horizontally and vertically. These methods are client-only, and can be found under GradientUtils. This can draw gradients repeated or backwards depending on what you pass for gradientStart and gradientEnd.