PaintSweepGradient

PaintSweepGradient 类具有以下属性：

center

一个 Offset 类的实例。渐变的中心。

colors

渐变应该在每个停止点处获得的颜色。该列表必须至少包含两个颜色。

如果提供了 stops，则该列表的长度必须与 stops 相同。

end_angle

渐变停止点 1.0 的角度（以弧度为单位）。默认值为 math.pi * 2。

rotation

渐变围绕其边界框中心点的旋转（以弧度为单位）。

start_angle

渐变停止点 0.0 的角度（以弧度为单位）。默认值为 0.0。

stops

一组值，从 0.0 到 1.0，表示渐变沿线的分数。

如果提供，则该列表的长度必须与 colors 相同。如果第一个值不是 0.0，则隐含一个位置为 0.0 且颜色等于 colors 中第一个颜色的停止点。如果最后一个值不是 1.0，则隐含一个位置为 1.0 且颜色等于 colors 中最后一个颜色的停止点。

tile_mode

如何在开始之前和结束之后的区域中平铺渐变。该值的类型为 GradientTileMode。

有关 Sweep 渐变的更多信息，请参见 这里。

使用示例

cv.Path(
    [
        cv.Path.MoveTo(60, 230),
        cv.Path.LineTo(110, 330),
        cv.Path.LineTo(10, 330),
        cv.Path.Close(),
    ],
    ft.Paint(
        gradient=ft.PaintSweepGradient(
            (60, 280),
            colors=[ft.colors.YELLOW, ft.colors.BLUE],
            start_angle=0,
            end_angle=math.pi * 2,
        ),
        stroke_width=5,
        stroke_join=ft.StrokeJoin.ROUND,
        style=ft.PaintingStyle.STROKE,
    ),
)

stroke_cap

当 style 设置为 PaintingStyle.STROKE 时，在线条末端放置的完成类型。

该值是 ft.StrokeCap 枚举的实例：

• BUTT (默认) - 用平边开始和结束轮廓。
• ROUND - 用半圆扩展开始和结束轮廓。
• SQUARE - 用半方形扩展开始和结束轮廓。与通过 Paint.stroke_width 给出的宽度将每个轮廓扩展一半类似。

stroke_join

当 style 设置为 PaintingStyle.STROKE 时，线段连接处的完成类型。

该值是 ft.StrokeJoin 枚举的实例：

• MITER (默认) - 尖角。
• BEVEL -斜角。
• ROUND - 圆角。

stroke_miter_limit

当连接类型为 StrokeJoin.MITER 且样式为 PaintingStyle.STROKE 时，用于绘制线段的斜接限制。如果超过此限制，则将绘制 StrokeJoin.BEVEL 连接。这可能会导致路径的角点“弹出”，如图所示。

该限制以长度表示为斜接。

默认值为 4.0。使用 0 作为限制将始终使用 StrokeJoin.BEVEL 连接。

stroke_width

当样式设置为 PaintingStyle.STROKE 时，边缘的宽度（以逻辑像素为单位）。宽度以与路径方向正交的方向测量。

默认值为 0.0，相当于发际线宽度。

stroke_dash_pattern

一个圆形数组，表示虚线偏移量和长度。

例如，数组 [5, 10] 将导致 5 像素长的虚线，后跟 10 像素长的空白空间。数组 [5, 10, 5] 将导致一个 5 像素的虚线，一个

I apologize for the incomplete translation earlier. Here is the complete translation of the text in Chinese:

---

title: PaintSweepGradient sidebar_label: PaintSweepGradient

导入选项卡从 '@theme/Tabs'； 导入选项卡项从 '@theme/TabItem'；

PaintSweepGradient 类具有以下属性：

center

一个 Offset 类的实例。渐变的中心。

colors

渐变应该在每个停止点处获得的颜色。该列表必须至少包含两个颜色。

如果提供了 stops，则该列表的长度必须与 stops 相同。

end_angle

渐变停止点 1.0 的角度（以弧度为单位）。默认值为 math.pi * 2。

rotation

渐变围绕其边界框中心点的旋转（以弧度为单位）。

start_angle

渐变停止点 0.0 的角度（以弧度为单位）。默认值为 0.0。

stops

一组值，从 0.0 到 1.0，表示渐变沿线的分数。

如果提供，则该列表的长度必须与 colors 相同。如果第一个值不是 0.0，则隐含一个位置为 0.0 且颜色等于 colors 中第一个颜色的停止点。如果最后一个值不是 1.0，则隐含一个位置为 1.0 且颜色等于 colors 中最后一个颜色的停止点。

tile_mode

如何在开始之前和结束之后的区域中平铺渐变。该值的类型为 GradientTileMode。

有关 Sweep 渐变的更多信息，请参见 这里。

使用示例

cv.Path(
    [
        cv.Path.MoveTo(60, 230),
        cv.Path.LineTo(110, 330),
        cv.Path.LineTo(10, 330),
        cv.Path.Close(),
    ],
    ft.Paint(
        gradient=ft.PaintSweepGradient(
            (60, 280),
            colors=[ft.colors.YELLOW, ft.colors.BLUE],
            start_angle=0,
            end_angle=math.pi * 2,
        ),
        stroke_width=5,
        stroke_join=ft.StrokeJoin.ROUND,
        style=ft.PaintingStyle.STROKE,
    ),
)

stroke_cap

当 style 设置为 PaintingStyle.STROKE 时，在线条末端放置的完成类型。

该值是 ft.StrokeCap 枚举的实例：

• BUTT (默认) - 用平边开始和结束轮廓。
• ROUND - 用半圆扩展开始和结束轮廓。
• SQUARE - 用半方形扩展开始和结束轮廓。与通过 Paint.stroke_width 给出的宽度将每个轮廓扩展一半类似。

stroke_join

当 style 设置为 PaintingStyle.STROKE 时，线段连接处的完成类型。

该值是 ft.StrokeJoin 枚举的实例：

• MITER (默认) - 尖角。
• BEVEL - 斜角。
• ROUND - 圆角。

stroke_miter_limit

当连接类型为 StrokeJoin.MITER 且样式为 PaintingStyle.STROKE 时，用于绘制线段的斜接限制。如果超过此限制，则将绘制 StrokeJoin.BEVEL 连接。这可能会导致路径的角点“弹出”，如图所示。

该限制以长度表示为斜接。

默认值为 4.0。使用 0 作为限制将始终使用 StrokeJoin.BEVEL 连接。

stroke_width

当样式设置为 PaintingStyle.STROKE 时，边缘的宽度（以逻辑像素为单位）。宽度以与路径方向正交的方向测量。

默认值为 0.0，相当于发际线宽度。

stroke_dash_pattern

一个圆形数组，表示虚线偏移量和长度。

例如，数组 [5, 10] 将导致 5 像素长的虚线，后跟 10 像素长的空白空间。数组 `[5,

I apologize for the incomplete translation earlier. Here is the complete translation of the text in Chinese:

---

title: PaintSweepGradient sidebar_label: PaintSweepGradient

导入选项卡从 '@theme/Tabs'； 导入选项卡项从 '@theme/TabItem'；

PaintSweepGradient 类具有以下属性：

center

一个 Offset 类的实例。渐变的中心。

colors

渐变应该在每个停止点处获得的颜色。该列表必须至少包含两个颜色。

如果提供了 stops，则该列表的长度必须与 stops 相同。

end_angle

渐变停止点 1.0 的角度（以弧度为单位）。默认值为 math.pi * 2。

rotation

渐变围绕其边界框中心点的旋转（以弧度为单位）。

start_angle

渐变停止点 0.0 的角度（以弧度为单位）。默认值为 0.0。

stops

一组值，从 0.0 到 1.0，表示渐变沿线的分数。

如果提供，则该列表的长度必须与 colors 相同。如果第一个值不是 0.0，则隐含一个位置为 0.0 且颜色等于 colors 中第一个颜色的停止点。如果最后一个值不是 1.0，则隐含一个位置为 1.0 且颜色等于 colors 中最后一个颜色的停止点。

tile_mode

如何在开始之前和结束之后的区域中平铺渐变。该值的类型为 GradientTileMode。

有关 Sweep 渐变的更多信息，请参见 这里。

使用示例

cv.Path(
    [
        cv.Path.MoveTo(60, 230),
        cv.Path.LineTo(110, 330),
        cv.Path.LineTo(10, 330),
        cv.Path.Close(),
    ],
    ft.Paint(
        gradient=ft.PaintSweepGradient(
            (60, 280),
            colors=[ft.colors.YELLOW, ft.colors.BLUE],
            start_angle=0,
            end_angle=math.pi * 2,
        ),
        stroke_width=5,
        stroke_join=ft.StrokeJoin.ROUND,
        style=ft.PaintingStyle.STROKE,
    ),
)

stroke_cap

当 style 设置为 PaintingStyle.STROKE 时，在线条末端放置的完成类型。

该值是 ft.StrokeCap 枚举的实例：

• BUTT (默认) - 用平边开始和结束轮廓。
• ROUND - 用半圆扩展开始和结束轮廓。
• SQUARE - 用半方形扩展开始和结束轮廓。与通过 Paint.stroke_width 给出的宽度将每个轮廓扩展一半类似。

stroke_join

当 style 设置为 PaintingStyle.STROKE 时，线段连接处的完成类型。

该值是 ft.StrokeJoin 枚举的实例：

• MITER (默认) - 尖角。
• BEVEL - 斜角。
• ROUND - 圆角。

stroke_miter_limit

当连接类型为 StrokeJoin.MITER 且样式为 PaintingStyle.STROKE 时，用于绘制线段的斜接限制。如果超过此限制，则将绘制 StrokeJoin.BEVEL 连接。这可能会导致路径的角点“弹出”，如图所示。

该限制以长度表示为斜接。

默认值为 4.0。使用 0 作为限制将始终使用 StrokeJoin.BEVEL 连接。

stroke_width

当样式设置为 PaintingStyle.STROKE 时，边缘的宽度（以逻辑像素为单位）。宽度以与路径方向正交的方向测量。

默认值为 0.0，相当于发际线宽度。

stroke_dash_pattern

一个圆形数组，表示虚线偏移量和长度。

例如，数组 [5, 10] 将导致 5 像素长的虚线，后跟 10 像素长的空白空间。数组 `[5,

stroke_dash_pattern

一个圆形数组，表示虚线偏移量和长度。

例如，数组 [5, 10] 将导致 5 像素长的虚线，后跟 10 像素长的空白空间。数组 [5, 10, 5] 将导致一个 5 像素的虚线，一个 10 像素的空白空间，一个 5 像素的虚线，依此类推。

style

是否在形状内、形状边缘或两者上绘制。

该值是 ft.PaintingStyle 枚举的实例：

• FILL (默认) - 在形状内绘制。例如，当应用于 canvas.Circle 形状时，会绘制一个圆盘。
• STROKE - 在形状边缘绘制。例如，当应用于 canvas.Circle 形状时，会绘制一个圆环。边缘的宽度由 Paint.stroke_width 属性确定。

tile_mode

如何在开始之前和结束之后的区域中平铺渐变。该值的类型为 GradientTileMode。

有关 Sweep 渐变的更多信息，请参见 这里。