LinearGradient

Kotlin |Java

open class LinearGradient : Shader

kotlin.Any
↳	android.graphics.Shader
	↳	android.graphics.LinearGradient

Summary

Public constructors
`LinearGradient(x0: Float, y0: Float, x1: Float, y1: Float, color0: Int, color1: Int, tile: Shader.TileMode)` Create a shader that draws a linear gradient along a line.
`LinearGradient(x0: Float, y0: Float, x1: Float, y1: Float, colors: IntArray, positions: FloatArray?, tile: Shader.TileMode)` Create a shader that draws a linear gradient along a line.
`LinearGradient(x0: Float, y0: Float, x1: Float, y1: Float, color0: Long, color1: Long, tile: Shader.TileMode)` Create a shader that draws a linear gradient along a line.
`LinearGradient(x0: Float, y0: Float, x1: Float, y1: Float, colors: LongArray, positions: FloatArray?, tile: Shader.TileMode)` Create a shader that draws a linear gradient along a line.

Inherited functions

From class Shader

Boolean

getLocalMatrix(localM: Matrix)

Return true if the shader has a non-identity local matrix.

Unit

setLocalMatrix(localM: Matrix?)

Set the shader's local matrix. Passing null will reset the shader's matrix to identity. If the matrix has scale value as 0, the drawing result is undefined.

Public constructors

LinearGradient

Added in API level 1

LinearGradient(
    x0: Float, 
    y0: Float, 
    x1: Float, 
    y1: Float, 
    color0: Int, 
    color1: Int, 
    tile: Shader.TileMode)

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

LinearGradient(
    x0: Float, 
    y0: Float, 
    x1: Float, 
    y1: Float, 
    colors: IntArray, 
    positions: FloatArray?, 
    tile: Shader.TileMode)

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`	IntArray: The sRGB colors to be distributed along the gradient line This value cannot be `null`.
`positions`	FloatArray?: 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

LinearGradient(
    x0: Float, 
    y0: Float, 
    x1: Float, 
    y1: Float, 
    color0: Long, 
    color1: Long, 
    tile: Shader.TileMode)

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`.

Exceptions
`java.lang.IllegalArgumentException`	if the colors do not share the same `ColorSpace` or do not use a valid one.

LinearGradient

Added in API level 29

LinearGradient(
    x0: Float, 
    y0: Float, 
    x1: Float, 
    y1: Float, 
    colors: LongArray, 
    positions: FloatArray?, 
    tile: Shader.TileMode)

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`	LongArray: The colors to be distributed along the gradient line This value cannot be `null`.
`positions`	FloatArray?: 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`.

Exceptions
`java.lang.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`.