Added in API level 1

LinearGradient


public class LinearGradient
extends Shader

java.lang.Object
   ↳ android.graphics.Shader
     ↳ android.graphics.LinearGradient


Summary

Public constructors

LinearGradient(float x0, float y0, float x1, float y1, int color0, int color1, Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

LinearGradient(float x0, float y0, float x1, float y1, int[] colors, float[] positions, Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

LinearGradient(float x0, float y0, float x1, float y1, long color0, long color1, Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

LinearGradient(float x0, float y0, float x1, float y1, long[] colors, float[] positions, Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

Inherited methods

Public constructors

LinearGradient

Added in API level 1
public LinearGradient (float x0, 
                float y0, 
                float x1, 
                float y1, 
                int color0, 
                int color1, 
                Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

Parameters
x0 float: The x-coordinate for the start of the gradient line

y0 float: The y-coordinate for the start of the gradient line

x1 float: The x-coordinate for the end of the gradient line

y1 float: The y-coordinate for the end of the gradient line

color0 int: The sRGB color at the start of the gradient line.

color1 int: The sRGB color at the end of the gradient line.

tile Shader.TileMode: The Shader tiling mode This value cannot be null.

LinearGradient

Added in API level 1
public LinearGradient (float x0, 
                float y0, 
                float x1, 
                float y1, 
                int[] colors, 
                float[] positions, 
                Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

Parameters
x0 float: The x-coordinate for the start of the gradient line

y0 float: The y-coordinate for the start of the gradient line

x1 float: The x-coordinate for the end of the gradient line

y1 float: The y-coordinate for the end of the gradient line

colors int: The sRGB colors to be distributed along the gradient line This value cannot be null.

positions float: May be null. The relative positions [0..1] of each corresponding color in the colors array. If this is null, the colors are distributed evenly along the gradient line.

tile Shader.TileMode: The Shader tiling mode This value cannot be null.

LinearGradient

Added in API level 29
public LinearGradient (float x0, 
                float y0, 
                float x1, 
                float y1, 
                long color0, 
                long color1, 
                Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

Parameters
x0 float: The x-coordinate for the start of the gradient line

y0 float: The y-coordinate for the start of the gradient line

x1 float: The x-coordinate for the end of the gradient line

y1 float: The y-coordinate for the end of the gradient line

color0 long: The color at the start of the gradient line.

color1 long: The color at the end of the gradient line.

tile Shader.TileMode: The Shader tiling mode This value cannot be null.

Throws
IllegalArgumentException if the colors do not share the same ColorSpace or do not use a valid one.

LinearGradient

Added in API level 29
public LinearGradient (float x0, 
                float y0, 
                float x1, 
                float y1, 
                long[] colors, 
                float[] positions, 
                Shader.TileMode tile)

Create a shader that draws a linear gradient along a line.

Parameters
x0 float: The x-coordinate for the start of the gradient line

y0 float: The y-coordinate for the start of the gradient line

x1 float: The x-coordinate for the end of the gradient line

y1 float: The y-coordinate for the end of the gradient line

colors long: The colors to be distributed along the gradient line This value cannot be null.

positions float: May be null. The relative positions [0..1] of each corresponding color in the colors array. If this is null, the colors are distributed evenly along the gradient line.

tile Shader.TileMode: The Shader tiling mode This value cannot be null.

Throws
IllegalArgumentException if there are less than two colors, the colors do not share the same ColorSpace or do not use a valid one, or positions is not null and has a different length from colors.