Package icyllis.modernui.graphics

Class RadialGradient.Builder

java.lang.Object

icyllis.modernui.graphics.GradientShader.Builder

icyllis.modernui.graphics.RadialGradient.Builder

Enclosing class:

RadialGradient

public static class RadialGradient.Builder
extends GradientShader.Builder

Builder pattern of RadialGradient.

Constructor Summary

Constructors

Constructor	Description
Builder(float centerX, float centerY, float radius, Shader.TileMode tileMode)
Builder(float centerX, float centerY, float radius, Shader.TileMode tileMode, ColorSpace colorSpace)
Builder(float centerX, float centerY, float radius, Shader.TileMode tileMode, ColorSpace colorSpace, int colorCount)

Method Summary

Modifier and Type	Method	Description
RadialGradient.Builder	addColor(float r, float g, float b, float a)	Add a color representing the color of the i-th stop.
RadialGradient.Builder	addColor(int color)	Add a color representing the color of the i-th stop.
RadialGradient.Builder	addColorStop(float offset, int color)	Helper version of addColor(int) and addPosition(float).
RadialGradient.Builder	addPosition(float position)	Add a number between 0 and 1, inclusive, representing the position of the i-th color stop.
RadialGradient	build()	Create the radial gradient, this builder cannot be reused anymore.
int	getColorCount()	Returns the initial number of color stops.
RadialGradient.Builder	setHueInterpolationMethod(GradientShader.HueInterpolationMethod hueInterpolationMethod)	For color functions with a hue angle (LCH, HSL, HWB etc.), this specifies a way to interpolate hue values.
RadialGradient.Builder	setInterpolationColorSpace(GradientShader.InterpolationColorSpace interpolationColorSpace)	Set the color space for interpolation.
RadialGradient.Builder	setInterpolationInPremul(boolean interpolationInPremul)	If false, gradients will interpolate their colors in unpremul space and then premultiply each of the results.
RadialGradient.Builder	setLocalMatrix(Matrix localMatrix)	This specifies an additional local matrix for the gradient, it transforms gradient's local coordinates to geometry's local coordinates, null means identity.

Methods inherited from class icyllis.modernui.graphics.GradientShader.Builder

getHueInterpolationMethod, getInterpolationColorSpace, isInterpolationInPremul

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

public Builder(float centerX,
 float centerY,
 float radius,
 @NonNull
 Shader.TileMode tileMode)

Builder

public Builder(float centerX,
 float centerY,
 float radius,
 @NonNull
 Shader.TileMode tileMode,
 @Nullable
 ColorSpace colorSpace)

Builder

public Builder(float centerX,
 float centerY,
 float radius,
 @NonNull
 Shader.TileMode tileMode,
 @Nullable
 ColorSpace colorSpace,
 int colorCount)

Method Details

addColor

@NonNull
public RadialGradient.Builder addColor(@ColorInt
 int color)

Add a color representing the color of the i-th stop.

addColor

@NonNull
public RadialGradient.Builder addColor(float r,
 float g,
 float b,
 float a)

Add a color representing the color of the i-th stop.

addPosition

@NonNull
public RadialGradient.Builder addPosition(float position)

Add a number between 0 and 1, inclusive, representing the position of the i-th color stop. 0 represents the start of the gradient and 1 represents the end.

A gradient can be created with implicit positions (by assuming they are uniformly distributed). Once you call this method, the number of colors must be equal to the number of positions.

addColorStop

@NonNull
public RadialGradient.Builder addColorStop(float offset,
 @ColorInt
 int color)

Helper version of addColor(int) and addPosition(float).

getColorCount

public int getColorCount()

Returns the initial number of color stops.

setInterpolationInPremul

public RadialGradient.Builder setInterpolationInPremul(boolean interpolationInPremul)

If false, gradients will interpolate their colors in unpremul space and then premultiply each of the results. If true, gradients will premultiply their colors first, and then interpolate between them.

Interpolating colors using the premultiplied representations tends to produce more attractive transitions than the non-premultiplied representations, particularly when transitioning from a fully opaque color to fully transparent.

The default is true to match CSS requirements.

Overrides:

setInterpolationInPremul in class GradientShader.Builder

Parameters:

interpolationInPremul - whether interpolate colors in premul space

setInterpolationColorSpace

public RadialGradient.Builder setInterpolationColorSpace(@NonNull
 GradientShader.InterpolationColorSpace interpolationColorSpace)

Set the color space for interpolation.

The default is GradientShader.InterpolationColorSpace.DESTINATION.

Overrides:

setInterpolationColorSpace in class GradientShader.Builder

setHueInterpolationMethod

public RadialGradient.Builder setHueInterpolationMethod(@NonNull
 GradientShader.HueInterpolationMethod hueInterpolationMethod)

For color functions with a hue angle (LCH, HSL, HWB etc.), this specifies a way to interpolate hue values.

The default is GradientShader.HueInterpolationMethod.SHORTER.

Overrides:

setHueInterpolationMethod in class GradientShader.Builder

setLocalMatrix

@NonNull
public RadialGradient.Builder setLocalMatrix(@Nullable
 Matrix localMatrix)

This specifies an additional local matrix for the gradient, it transforms gradient's local coordinates to geometry's local coordinates, null means identity.

Parameters:

localMatrix - the local matrix to set

build

@NonNull
public RadialGradient build()

Create the radial gradient, this builder cannot be reused anymore.

Specified by:

build in class GradientShader.Builder

Throws:

IllegalArgumentException - no color, NaN, infinity, non-invertible matrix, etc.