LinearGradientBrush 类

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

Module: aspose.imaging.brushes

Full Name: aspose.imaging.brushes.LinearGradientBrush

Inheritance: LinearGradientBrushBase

Constructors

Name	描述
LinearGradientBrush()	使用默认参数初始化 LinearGradientBrush 类的新实例。 起始颜色为黑色，结束颜色为白色，角度为 45 度，矩形位于 (0,0)，大小为 (1,1)。
LinearGradientBrush(point1, point2, color1, color2)	初始化 LinearGradientBrush 类的新实例。
LinearGradientBrush(point1, point2, color1, color2)	初始化 LinearGradientBrush 类的新实例。
LinearGradientBrush(rect, color1, color2, angle)	初始化 LinearGradientBrush 类的新实例。
LinearGradientBrush(rect, color1, color2, angle)	初始化 LinearGradientBrush 类的新实例。
LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable)	初始化 LinearGradientBrush 类的新实例。
LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable)	初始化 LinearGradientBrush 类的新实例。

Properties

Name	Type	Access	描述
角度	float	r/w	获取或设置渐变角度。
blend	Blend	r/w	获取或设置一个 Blend ，它指定用于定义渐变自定义衰减的位置信息和因子。
disposed	bool	r	获取一个值，指示此实例是否已释放。
end_color	Color	r/w	获取或设置结束渐变颜色。
gamma_correction	bool	r/w	获取或设置一个值，指示是否为此 LinearGradientBrushBase 启用了伽马校正。
interpolation_colors	ColorBlend	r/w	获取或设置一个 ColorBlend，用于定义多颜色线性渐变。
is_angle_scalable	bool	r/w	获取或设置一个值，指示在使用此 LinearGradientBrushBase 进行变换时，是否更改了 LinearGradientBrushBase.angle。
is_transform_changed	bool	r	获取一个值，指示变换是否以某种方式被更改。例如设置变换矩阵或 调用任何修改变换矩阵的方法。此属性为向后兼容 GDI+ 而引入。
linear_colors	Color[]	r/w	获取或设置渐变的起始和结束颜色。
opacity	float	r/w	获取或设置画笔的不透明度。该值应在 0 到 1 之间。0 表示画笔完全可见，1 表示画笔完全不透明。
rectangle	RectangleF	r/w	获取或设置定义渐变起始和结束点的矩形区域。
start_color	Color	r/w	获取或设置起始渐变颜色。
transform	Matrix	r/w	获取或设置一个 Matrix 副本，用于定义此 TransformBrush 的局部几何变换。
wrap_mode	WrapMode	r/w	获取或设置一个指示此 TransformBrush 的包装模式的 WrapMode 枚举。

Methods

Name	描述
create_with_points(point1, point2, color1, color2)	使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。
create_with_points_f(point1, point2, color1, color2)	使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。
create_with_rect_colors_angle(rect, color1, color2, angle)	基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。
create_with_rect_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable)	基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。
create_with_rect_f_colors_angle(rect, color1, color2, angle)	基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。
create_with_rect_f_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable)	基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。
deep_clone()	创建当前 Brush 的新深度克隆。
multiply_transform(matrix)	将表示此 LinearGradientBrush 的本地几何变换的 Matrix 与指定的 Matrix 相乘，并在前面预置指定的 Matrix。
multiply_transform(matrix, order)	将表示此 LinearGradientBrush 的本地几何变换的 Matrix 与指定的 Matrix 按指定顺序相乘。
reset_transform()	将 TransformBrush.transform 属性重置为单位矩阵。
rotate_transform(angle)	按指定量旋转本地几何变换。此方法将在变换前预置旋转。
rotate_transform(angle, order)	按指定量并按指定顺序旋转本地几何变换。
scale_transform(sx, sy)	按指定的比例缩放本地几何变换。此方法将在变换前预置缩放矩阵。
scale_transform(sx, sy, order)	按指定的比例并按指定顺序缩放本地几何变换。
set_blend_triangular_shape(focus)	创建具有中心颜色并在两端线性衰减到单一颜色的线性渐变。
set_blend_triangular_shape(focus, scale)	创建具有中心颜色并在两端线性衰减到单一颜色的线性渐变。
set_sigma_bell_shape(focus)	基于钟形曲线创建渐变衰减。
set_sigma_bell_shape(focus, scale)	基于钟形曲线创建渐变衰减。
translate_transform(dx, dy)	按指定的尺寸平移本地几何变换。此方法将在变换前预置平移。
translate_transform(dx, dy, order)	按指定的尺寸并按指定顺序平移本地几何变换。

Constructor: LinearGradientBrush()

 LinearGradientBrush() 

使用默认参数初始化 LinearGradientBrush 类的新实例。
起始颜色为黑色，结束颜色为白色，角度为 45 度，矩形位于 (0,0)，大小为 (1,1)。

Constructor: LinearGradientBrush(point1, point2, color1, color2)

 LinearGradientBrush(point1, point2, color1, color2) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
point1	PointF	点1。
point2	PointF	点2。
color1	Color	颜色1。
color2	Color	颜色2。

Constructor: LinearGradientBrush(point1, point2, color1, color2)

 LinearGradientBrush(point1, point2, color1, color2) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
point1	Point	点1。
point2	Point	点2。
color1	Color	颜色1。
color2	Color	颜色2。

Constructor: LinearGradientBrush(rect, color1, color2, angle)

 LinearGradientBrush(rect, color1, color2, angle) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	RectangleF	矩形。
color1	Color	颜色1。
color2	Color	颜色2。
角度	float	角度。

Constructor: LinearGradientBrush(rect, color1, color2, angle)

 LinearGradientBrush(rect, color1, color2, angle) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	Rectangle	矩形。
color1	Color	颜色1。
color2	Color	颜色2。
角度	float	角度。

Constructor: LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable)

 LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	RectangleF	矩形。
color1	Color	颜色1。
color2	Color	颜色2。
角度	float	角度。
is_angle_scalable	bool	如果设置为 true [is angle scalable]。

Constructor: LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable)

 LinearGradientBrush(rect, color1, color2, angle, is_angle_scalable) 

初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	Rectangle	矩形。
color1	Color	颜色1。
color2	Color	颜色2。
角度	float	角度。
is_angle_scalable	bool	如果设置为 true [is angle scalable]。

Method: create_with_points(point1, point2, color1, color2) [static]

 create_with_points(point1, point2, color1, color2) 

使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
point1	Point	表示线性渐变起始点的 Point 结构。
point2	Point	表示线性渐变终点的 Point 结构。
color1	Color	一个 Color 结构，表示线性渐变的起始颜色。
color2	Color	一个 Color 结构，表示线性渐变的结束颜色。

Returns

Type	Description
LinearGradientBrush

Method: create_with_points_f(point1, point2, color1, color2) [static]

 create_with_points_f(point1, point2, color1, color2) 

使用指定的点和颜色初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
point1	PointF	表示线性渐变起始点的 PointF 结构。
point2	PointF	表示线性渐变终点的 PointF 结构。
color1	Color	一个 Color 结构，表示线性渐变的起始颜色。
color2	Color	一个 Color 结构，表示线性渐变的结束颜色。

Returns

Type	Description
LinearGradientBrush

Method: create_with_rect_colors_angle(rect, color1, color2, angle) [static]

 create_with_rect_colors_angle(rect, color1, color2, angle) 

基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	Rectangle	指定线性渐变边界的 RectangleF 结构。
color1	Color	一个 Color 结构，表示渐变的起始颜色。
color2	Color	一个 Color 结构，表示渐变的结束颜色。
角度	float	梯度方向线相对于 x 轴顺时针测量的角度（以度为单位）。

Returns

Type	Description
LinearGradientBrush

Method: create_with_rect_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable) [static]

 create_with_rect_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable) 

基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	Rectangle	指定线性渐变边界的 RectangleF 结构。
color1	Color	一个 Color 结构，表示渐变的起始颜色。
color2	Color	一个 Color 结构，表示渐变的结束颜色。
角度	float	梯度方向线相对于 x 轴顺时针测量的角度（以度为单位）。
is_angle_scalable	bool	如果设置为 true，角度将在使用此 LinearGradientBrush 进行转换时被更改。

Returns

Type	Description
LinearGradientBrush

Method: create_with_rect_f_colors_angle(rect, color1, color2, angle) [static]

 create_with_rect_f_colors_angle(rect, color1, color2, angle) 

基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	RectangleF	指定线性渐变边界的 RectangleF 结构。
color1	Color	一个 Color 结构，表示渐变的起始颜色。
color2	Color	一个 Color 结构，表示渐变的结束颜色。
角度	float	梯度方向线相对于 x 轴顺时针测量的角度（以度为单位）。

Returns

Type	Description
LinearGradientBrush

Method: create_with_rect_f_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable) [static]

 create_with_rect_f_colors_angle_scalable(rect, color1, color2, angle, is_angle_scalable) 

基于矩形、起始和结束颜色以及方向角度，初始化 LinearGradientBrush 类的新实例。

Parameters:

参数	Type	Description
rect	RectangleF	指定线性渐变边界的 RectangleF 结构。
color1	Color	一个 Color 结构，表示渐变的起始颜色。
color2	Color	一个 Color 结构，表示渐变的结束颜色。
角度	float	梯度方向线相对于 x 轴顺时针测量的角度（以度为单位）。
is_angle_scalable	bool	如果设置为 true，角度将在使用此 LinearGradientBrush 进行转换时被更改。

Returns

Type	Description
LinearGradientBrush

Method: deep_clone()

 deep_clone() 

创建当前 Brush 的新深度克隆。

Returns

Type	Description
Brush	一个新的 Brush，它是此 Brush 实例的深度克隆。

Method: multiply_transform(matrix)

 multiply_transform(matrix) 

将表示此 LinearGradientBrush 的本地几何变换的 Matrix 与指定的 Matrix 相乘，并在前面预置指定的 Matrix。

Parameters:

参数	Type	Description
matrix	Matrix	用于乘以几何变换的 Matrix。

Method: multiply_transform(matrix, order)

 multiply_transform(matrix, order) 

将表示此 LinearGradientBrush 的本地几何变换的 Matrix 与指定的 Matrix 按指定顺序相乘。

Parameters:

参数	Type	Description
matrix	Matrix	用于乘以几何变换的 Matrix。
order	MatrixOrder	指定两个矩阵相乘顺序的 MatrixOrder。

Method: rotate_transform(angle)

 rotate_transform(angle) 

按指定量旋转本地几何变换。此方法将在变换前预置旋转。

Parameters:

参数	Type	Description
角度	float	旋转角度。

Method: rotate_transform(angle, order)

 rotate_transform(angle, order) 

按指定量并按指定顺序旋转本地几何变换。

Parameters:

参数	Type	Description
角度	float	旋转角度。
order	MatrixOrder	指定是追加还是预置旋转矩阵的 MatrixOrder。

Method: scale_transform(sx, sy)

 scale_transform(sx, sy) 

按指定的比例缩放本地几何变换。此方法将在变换前预置缩放矩阵。

Parameters:

参数	Type	Description
sx	float	在 x 轴方向上缩放变换的量。
sy	float	在 y 轴方向上缩放变换的量。

Method: scale_transform(sx, sy, order)

 scale_transform(sx, sy, order) 

按指定的比例并按指定顺序缩放本地几何变换。

Parameters:

参数	Type	Description
sx	float	在 x 轴方向上缩放变换的量。
sy	float	在 y 轴方向上缩放变换的量。
order	MatrixOrder	一个 MatrixOrder 用于指定是追加还是预先追加缩放矩阵。

Method: set_blend_triangular_shape(focus)

 set_blend_triangular_shape(focus) 

创建具有中心颜色并在两端线性衰减到单一颜色的线性渐变。

Parameters:

参数	Type	Description
焦点	float	一个取值范围为 0 到 1 的值，指定渐变的中心（即渐变仅由结束颜色组成的点）。

Method: set_blend_triangular_shape(focus, scale)

 set_blend_triangular_shape(focus, scale) 

创建具有中心颜色并在两端线性衰减到单一颜色的线性渐变。

Parameters:

参数	Type	Description
焦点	float	一个取值范围为 0 到 1 的值，指定渐变的中心（即渐变仅由结束颜色组成的点）。
比例	float	一个取值范围为 0 到 1 的值，指定颜色从起始颜色到 focus（结束颜色）的衰减速度。

Method: set_sigma_bell_shape(focus)

 set_sigma_bell_shape(focus) 

基于钟形曲线创建渐变衰减。

Parameters:

参数	Type	Description
焦点	float	一个取值范围为 0 到 1 的值，指定渐变的中心（即起始颜色和结束颜色等量混合的点）。

Method: set_sigma_bell_shape(focus, scale)

 set_sigma_bell_shape(focus, scale) 

基于钟形曲线创建渐变衰减。

Parameters:

参数	Type	Description
焦点	float	一个取值范围为 0 到 1 的值，指定渐变的中心（即渐变仅由结束颜色组成的点）。
比例	float	一个取值范围为 0 到 1 的值，指定颜色从 focus 衰减的速度。

Method: translate_transform(dx, dy)

 translate_transform(dx, dy) 

按指定的尺寸平移本地几何变换。此方法将在变换前预置平移。

Parameters:

参数	Type	Description
dx	float	x 方向的平移值。
dy	float	y 方向的平移值。

Method: translate_transform(dx, dy, order)

 translate_transform(dx, dy, order) 

按指定的尺寸并按指定顺序平移本地几何变换。

Parameters:

参数	Type	Description
dx	float	x 方向的平移值。
dy	float	y 方向的平移值。
order	MatrixOrder	应用平移的顺序（预先追加或追加）。