PathGradientBrush Class

Summary: Encapsulates a Brush object with a gradient. This class cannot be inherited.

Module: aspose.psd.brushes

Full Name: aspose.psd.brushes.PathGradientBrush

Inheritance: PathGradientBrushBase

Aspose.PSD Version: 24.9.0

Constructors

NameDescription
PathGradientBrush(path)Initializes a new instance of the PathGradientBrush class with the specified path.
PathGradientBrush(points)Initializes a new instance of the PathGradientBrush class with the specified points.
PathGradientBrush(points)Initializes a new instance of the PathGradientBrush class with the specified points.
PathGradientBrush(points, wrap_mode)Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.
PathGradientBrush(points, wrap_mode)Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Properties

NameTypeAccessDescription
blendBlendr/wGets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.
center_colorColorr/wGets or sets the color at the center of the path gradient.
center_pointPointFr/wGets or sets the center point of the path gradient.
disposedboolrGets a value indicating whether this instance is disposed.
focus_scalesPointFr/wGets or sets the focus point for the gradient falloff.
graphics_pathGraphicsPathrGets the graphics path this brush was build upon.
interpolation_colorsColorBlendr/wGets or sets a ColorBlend that defines a multicolor linear gradient.
is_transform_changedboolrGets a value indicating whether transformations were changed in some way. For example setting the transformation matrix or
calling any of the methods altering the transformation matrix. The property is introduced for backward compatibility with GDI+.
opacityfloatr/wGets or sets the brush opacity. The value should be between 0 and 1. Value of 0 means that brush is fully visible, value of 1 means the brush is fully opaque.
path_pointsPointF[]rGets the path points this brush was build upon.
surround_colorsColor[]r/wGets or sets an array of colors that correspond to the points in the path this PathGradientBrush fills.
transformMatrixr/wGets or sets a copy Matrix that defines a local geometric transform for this TransformBrush.
wrap_modeWrapModer/wGets or sets a WrapMode enumeration that indicates the wrap mode for this TransformBrush.

Methods

NameDescription
deep_clone()Creates a new deep clone of the current Brush.
multiply_transform(matrix)Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.
multiply_transform(matrix, order)Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.
reset_transform()Resets the TransformBrush.transform property to identity.
rotate_transform(angle)Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.
rotate_transform(angle, order)Rotates the local geometric transform by the specified amount in the specified order.
scale_transform(sx, sy)Scales the local geometric transform by the specified amounts. This method prepends the scaling matrix to the transform.
scale_transform(sx, sy, order)Scales the local geometric transform by the specified amounts in the specified order.
set_blend_triangular_shape(focus)Creates a gradient with a center color and a linear falloff to one surrounding color.
set_blend_triangular_shape(focus, scale)Creates a gradient with a center color and a linear falloff to each surrounding color.
set_sigma_bell_shape(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.
set_sigma_bell_shape(focus, 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.
translate_transform(dx, dy)Translates the local geometric transform by the specified dimensions. This method prepends the translation to the transform.
translate_transform(dx, dy, order)Translates the local geometric transform by the specified dimensions in the specified order.

Constructor: PathGradientBrush(path)

 PathGradientBrush(path) 

Initializes a new instance of the PathGradientBrush class with the specified path.

Parameters:

ParameterTypeDescription
pathGraphicsPathThe GraphicsPath that defines the area filled by this PathGradientBrush.

Constructor: PathGradientBrush(points)

 PathGradientBrush(points) 

Initializes a new instance of the PathGradientBrush class with the specified points.

Parameters:

ParameterTypeDescription
pointsPointF[]An array of PointF structures that represents the points that make up the vertices of the path.

Constructor: PathGradientBrush(points)

 PathGradientBrush(points) 

Initializes a new instance of the PathGradientBrush class with the specified points.

Parameters:

ParameterTypeDescription
pointsPoint[]An array of PointF structures that represents the points that make up the vertices of the path.

Constructor: PathGradientBrush(points, wrap_mode)

 PathGradientBrush(points, wrap_mode) 

Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Parameters:

ParameterTypeDescription
pointsPointF[]An array of PointF structures that represents the points that make up the vertices of the path.
wrap_modeWrapModeA WrapMode that specifies how fills drawn with this PathGradientBrush are tiled.

Constructor: PathGradientBrush(points, wrap_mode)

 PathGradientBrush(points, wrap_mode) 

Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Parameters:

ParameterTypeDescription
pointsPoint[]An array of PointF structures that represents the points that make up the vertices of the path.
wrap_modeWrapModeA WrapMode that specifies how fills drawn with this PathGradientBrush are tiled.

Method: deep_clone()

 deep_clone() 

Creates a new deep clone of the current Brush.

Returns

TypeDescription
BrushA new Brush which is the deep clone of this Brush instance.

Method: multiply_transform(matrix)

 multiply_transform(matrix) 

Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

Parameters:

ParameterTypeDescription
matrixMatrixThe Matrix by which to multiply the geometric transform.

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order) 

Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

Parameters:

ParameterTypeDescription
matrixMatrixThe Matrix by which to multiply the geometric transform.
orderMatrixOrderA MatrixOrder that specifies in which order to multiply the two matrices.

Method: rotate_transform(angle)

 rotate_transform(angle) 

Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.

Parameters:

ParameterTypeDescription
anglefloatThe angle of rotation.

Method: rotate_transform(angle, order)

 rotate_transform(angle, order) 

Rotates the local geometric transform by the specified amount in the specified order.

Parameters:

ParameterTypeDescription
anglefloatThe angle of rotation.
orderMatrixOrderA MatrixOrder that specifies whether to append or prepend the rotation matrix.

Method: scale_transform(sx, sy)

 scale_transform(sx, sy) 

Scales the local geometric transform by the specified amounts. This method prepends the scaling matrix to the transform.

Parameters:

ParameterTypeDescription
sxfloatThe amount by which to scale the transform in the x-axis direction.
syfloatThe amount by which to scale the transform in the y-axis direction.

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order) 

Scales the local geometric transform by the specified amounts in the specified order.

Parameters:

ParameterTypeDescription
sxfloatThe amount by which to scale the transform in the x-axis direction.
syfloatThe amount by which to scale the transform in the y-axis direction.
orderMatrixOrderA MatrixOrder that specifies whether to append or prepend the scaling matrix.

Method: set_blend_triangular_shape(focus)

 set_blend_triangular_shape(focus) 

Creates a gradient with a center color and a linear falloff to one surrounding color.

Parameters:

ParameterTypeDescription
focusfloatA 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.

Method: set_blend_triangular_shape(focus, scale)

 set_blend_triangular_shape(focus, scale) 

Creates a gradient with a center color and a linear falloff to each surrounding color.

Parameters:

ParameterTypeDescription
focusfloatA 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.
scalefloatA 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.

Method: set_sigma_bell_shape(focus)

 set_sigma_bell_shape(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.

Parameters:

ParameterTypeDescription
focusfloatA 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.

Method: set_sigma_bell_shape(focus, scale)

 set_sigma_bell_shape(focus, 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.

Parameters:

ParameterTypeDescription
focusfloatA 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.
scalefloatA 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.

Method: translate_transform(dx, dy)

 translate_transform(dx, dy) 

Translates the local geometric transform by the specified dimensions. This method prepends the translation to the transform.

Parameters:

ParameterTypeDescription
dxfloatThe value of the translation in x.
dyfloatThe value of the translation in y.

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order) 

Translates the local geometric transform by the specified dimensions in the specified order.

Parameters:

ParameterTypeDescription
dxfloatThe value of the translation in x.
dyfloatThe value of the translation in y.
orderMatrixOrderThe order (prepend or append) in which to apply the translation.