public final class PathGradientBrush extends PathGradientBrushBase
Encapsulates a Brush
object with a gradient. This class cannot be inherited.
The center color is white by default. A user can changed this value at any time later.
The surround colors array is initialized by single element containing white color by default. The surround colors may be changed later, however at least single element is required when setting up the surround colors.
See the Blend
(PathGradientBrush.getBlend()
/PathGradientBrush.setBlend(Blend)
) for more details about its initialization.
Constructor and Description |
---|
PathGradientBrush(GraphicsPath path)
Initializes a new instance of the
PathGradientBrush class with the specified path. |
PathGradientBrush(Point[] points)
Initializes a new instance of the
PathGradientBrush class with the specified points. |
PathGradientBrush(Point[] points,
int wrapMode)
Initializes a new instance of the
PathGradientBrush class with the specified points and wrap mode. |
PathGradientBrush(PointF[] points)
Initializes a new instance of the
PathGradientBrush class with the specified points. |
PathGradientBrush(PointF[] points,
int wrapMode)
Initializes a new instance of the
PathGradientBrush class with the specified points and wrap mode. |
Modifier and Type | Method and Description |
---|---|
Blend |
getBlend()
Gets or sets a
Blend that specifies positions and factors that define a custom falloff for the gradient. |
Color |
getCenterColor()
Gets or sets the color at the center of the path gradient.
|
ColorBlend |
getInterpolationColors()
Deprecated.
This property is not used in this class anymore. Use PathMulticolorGradientBrush class instead.
|
Color[] |
getSurroundColors()
Gets or sets an array of colors that correspond to the points in the path this
PathGradientBrush fills. |
void |
setBlend(Blend value)
Gets or sets a
Blend that specifies positions and factors that define a custom falloff for the gradient. |
void |
setBlendTriangularShape(float focus)
Creates a gradient with a center color and a linear falloff to one surrounding color.
|
void |
setBlendTriangularShape(float focus,
float scale)
Creates a gradient with a center color and a linear falloff to each surrounding color.
|
void |
setCenterColor(Color value)
Gets or sets the color at the center of the path gradient.
|
void |
setInterpolationColors(ColorBlend value)
Deprecated.
This property is not used in this class anymore. Use PathMulticolorGradientBrush class instead.
|
void |
setSigmaBellShape(float focus)
Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary.
|
void |
setSigmaBellShape(float focus,
float scale)
Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary.
|
void |
setSurroundColors(Color[] value)
Gets or sets an array of colors that correspond to the points in the path this
PathGradientBrush fills. |
getCenterPoint, getFocusScales, getGraphicsPath, getPathPoints, setCenterPoint, setFocusScales
getTransform, getWrapMode, isTransformChanged, multiplyTransform, multiplyTransform, resetTransform, rotateTransform, rotateTransform, scaleTransform, scaleTransform, setTransform, setWrapMode, translateTransform, translateTransform
deepClone, getOpacity, setOpacity
dispose, getDisposed
public PathGradientBrush(PointF[] points)
Initializes a new instance of the PathGradientBrush
class with the specified points.
points
- An array of PointF
structures that represents the points that make up the vertices of the path.public PathGradientBrush(PointF[] points, int wrapMode)
Initializes a new instance of the PathGradientBrush
class with the specified points and wrap mode.
points
- An array of PointF
structures that represents the points that make up the vertices of the path.wrapMode
- A WrapMode
that specifies how fills drawn with this PathGradientBrush
are tiled.public PathGradientBrush(Point[] points)
Initializes a new instance of the PathGradientBrush
class with the specified points.
points
- An array of Point
structures that represents the points that make up the vertices of the path.public PathGradientBrush(Point[] points, int wrapMode)
Initializes a new instance of the PathGradientBrush
class with the specified points and wrap mode.
points
- An array of Point
structures that represents the points that make up the vertices of the path.wrapMode
- A WrapMode
that specifies how fills drawn with this PathGradientBrush
are tiled.public PathGradientBrush(GraphicsPath path)
Initializes a new instance of the PathGradientBrush
class with the specified path.
path
- The GraphicsPath
(PathGradientBrushBase.getGraphicsPath()
) that defines the area filled by this PathGradientBrush
.@Deprecated public final ColorBlend getInterpolationColors()
Gets or sets a ColorBlend
that defines a multicolor linear gradient.
ColorBlend
that defines a multicolor linear gradient.@Deprecated public final void setInterpolationColors(ColorBlend value)
Gets or sets a ColorBlend
that defines a multicolor linear gradient.
ColorBlend
that defines a multicolor linear gradient.public final Color getCenterColor()
Gets or sets the color at the center of the path gradient.
Value: AColor
that represents the color at the center of the path gradient.public final void setCenterColor(Color value)
Gets or sets the color at the center of the path gradient.
Value: AColor
that represents the color at the center of the path gradient.public final Color[] getSurroundColors()
Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush
fills.
Color
structures that represents the colors associated with each point in the path this PathGradientBrush
fills.public final void setSurroundColors(Color[] value)
Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush
fills.
Color
structures that represents the colors associated with each point in the path this PathGradientBrush
fills.public final Blend getBlend()
public final void setBlend(Blend value)
public final void setSigmaBellShape(float focus)
Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. The transition from one color to another is based on a bell-shaped curve.
focus
- A value from 0 through 1 that specifies where, along any radial from the center of the path to the path's boundary, the center color will be at its highest intensity. A value of 1 (the default) places the highest intensity at the center of the path.public final void setSigmaBellShape(float focus, float scale)
Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. The transition from one color to another is based on a bell-shaped curve.
focus
- A value from 0 through 1 that specifies where, along any radial from the center of the path to the path's boundary, the center color will be at its highest intensity. A value of 1 (the default) places the highest intensity at the center of the path.scale
- A value from 0 through 1 that specifies the maximum intensity of the center color that gets blended with the boundary color. A value of 1 causes the highest possible intensity of the center color, and it is the default value.public final void setBlendTriangularShape(float focus)
Creates a gradient with a center color and a linear falloff to one surrounding color.
focus
- A value from 0 through 1 that specifies where, along any radial from the center of the path to the path's boundary, the center color will be at its highest intensity. A value of 1 (the default) places the highest intensity at the center of the path.public final void setBlendTriangularShape(float focus, float scale)
Creates a gradient with a center color and a linear falloff to each surrounding color.
focus
- A value from 0 through 1 that specifies where, along any radial from the center of the path to the path's boundary, the center color will be at its highest intensity. A value of 1 (the default) places the highest intensity at the center of the path.scale
- A value from 0 through 1 that specifies the maximum intensity of the center color that gets blended with the boundary color. A value of 1 causes the highest possible intensity of the center color, and it is the default value.Copyright (c) 2008-2020 Aspose Pty Ltd. All Rights Reserved.