RadialGradient

Kotlin |Java

public class RadialGradient
extends Shader

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

Summary

Public constructors
`RadialGradient(float centerX, float centerY, float radius, int[] colors, float[] stops, Shader.TileMode tileMode)` Create a shader that draws a radial gradient given the center and radius.
`RadialGradient(float centerX, float centerY, float radius, long[] colors, float[] stops, Shader.TileMode tileMode)` Create a shader that draws a radial gradient given the center and radius.
`RadialGradient(float startX, float startY, float startRadius, float endX, float endY, float endRadius, long[] colors, float[] stops, Shader.TileMode tileMode)` Create a shader that draws a radial gradient given the start and end points as well as starting and ending radii.
`RadialGradient(float centerX, float centerY, float radius, int centerColor, int edgeColor, Shader.TileMode tileMode)` Create a shader that draws a radial gradient given the center and radius.
`RadialGradient(float centerX, float centerY, float radius, long centerColor, long edgeColor, Shader.TileMode tileMode)` Create a shader that draws a radial gradient given the center and radius.

Inherited methods

From class


        
          android.graphics.Shader

`boolean`	`getLocalMatrix(Matrix localM)` Return true if the shader has a non-identity local matrix.
`void`	`setLocalMatrix(Matrix localM)` Set the shader's local matrix.

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

RadialGradient

Added in API level 1

public RadialGradient (float centerX, 
                float centerY, 
                float radius, 
                int[] colors, 
                float[] stops, 
                Shader.TileMode tileMode)

Create a shader that draws a radial gradient given the center and radius.

Parameters
`centerX`	`float`: The x-coordinate of the center of the radius
`centerY`	`float`: The y-coordinate of the center of the radius
`radius`	`float`: Must be positive. The radius of the circle for this gradient.
`colors`	`int`: The sRGB colors to be distributed between the center and edge of the circle This value cannot be `null`.
`stops`	`float`: May be `null`. Valid values are between `0.0f` and `1.0f`. The relative position of each corresponding color in the colors array. If `null`, colors are distributed evenly between the center and edge of the circle.
`tileMode`	`Shader.TileMode`: The Shader tiling mode This value cannot be `null`.

RadialGradient

Added in API level 29

public RadialGradient (float centerX, 
                float centerY, 
                float radius, 
                long[] colors, 
                float[] stops, 
                Shader.TileMode tileMode)

Create a shader that draws a radial gradient given the center and radius.

Parameters
`centerX`	`float`: The x-coordinate of the center of the radius
`centerY`	`float`: The y-coordinate of the center of the radius
`radius`	`float`: Must be positive. The radius of the circle for this gradient.
`colors`	`long`: The colors to be distributed between the center and edge of the circle This value cannot be `null`.
`stops`	`float`: May be `null`. Valid values are between `0.0f` and `1.0f`. The relative position of each corresponding color in the colors array. If `null`, colors are distributed evenly between the center and edge of the circle.
`tileMode`	`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 `stops` is not `null` and has a different length from `colors`.

RadialGradient

Added in API level 31

public RadialGradient (float startX, 
                float startY, 
                float startRadius, 
                float endX, 
                float endY, 
                float endRadius, 
                long[] colors, 
                float[] stops, 
                Shader.TileMode tileMode)

Create a shader that draws a radial gradient given the start and end points as well as starting and ending radii. The starting point is often referred to as the focal center and represents the starting circle of the radial gradient.

Parameters
`startX`	`float`: The x-coordinate of the center of the starting circle of the radial gradient, often referred to as the focal point.
`startY`	`float`: The y-coordinate of the center of the starting circle of the radial gradient, often referred to as the focal point.
`startRadius`	`float`: The radius of the starting circle of the radial gradient, often referred to as the focal radius. Must be greater than or equal to zero. Value is 0.0f or greater
`endX`	`float`: The x-coordinate of the center of the radius for the end circle of the radial gradient
`endY`	`float`: The y-coordinate of the center of the radius for the end circle of the radial gradient
`endRadius`	`float`: The radius of the ending circle for this gradient. This must be strictly greater than zero. A radius value equal to zero is not allowed. Value is 0.0f or greater
`colors`	`long`: The colors to be distributed between the center and edge of the circle This value cannot be `null`.
`stops`	`float`: May be `null`. Valid values are between `0.0f` and `1.0f`. The relative position of each corresponding color in the colors array. If `null`, colors are distributed evenly between the center and edge of the circle.
`tileMode`	`Shader.TileMode`: The Shader tiling mode This value cannot be `null`.

Throws
`IllegalArgumentException`	In one of the following circumstances: There are less than two colors The colors do not share the same `ColorSpace` The colors do not use a valid `ColorSpace` The `stops` parameter is not `null` and has a different length from `colors`. The `startRadius` is negative The `endRadius` is less than or equal to zero

RadialGradient

Added in API level 1

public RadialGradient (float centerX, 
                float centerY, 
                float radius, 
                int centerColor, 
                int edgeColor, 
                Shader.TileMode tileMode)

Create a shader that draws a radial gradient given the center and radius.

Parameters
`centerX`	`float`: The x-coordinate of the center of the radius
`centerY`	`float`: The y-coordinate of the center of the radius
`radius`	`float`: Must be positive. The radius of the circle for this gradient
`centerColor`	`int`: The sRGB color at the center of the circle.
`edgeColor`	`int`: The sRGB color at the edge of the circle.
`tileMode`	`Shader.TileMode`: The Shader tiling mode This value cannot be `null`.

RadialGradient

Added in API level 29

public RadialGradient (float centerX, 
                float centerY, 
                float radius, 
                long centerColor, 
                long edgeColor, 
                Shader.TileMode tileMode)

Create a shader that draws a radial gradient given the center and radius.

Parameters
`centerX`	`float`: The x-coordinate of the center of the radius
`centerY`	`float`: The y-coordinate of the center of the radius
`radius`	`float`: Must be positive. The radius of the circle for this gradient
`centerColor`	`long`: The color at the center of the circle.
`edgeColor`	`long`: The color at the edge of the circle.
`tileMode`	`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.