`matplotlib.patheffects`¶

为路径效果定义类。支持路径效果 Text ， Line2D 和 Patch .

参见

class matplotlib.patheffects.AbstractPathEffect(offset=(0.0, 0.0))[源代码]¶

基类：object

路径效果的基类。

子类应重写 draw_path 添加效果功能的方法。

参数:	offset双浮体应用于路径的偏移量，以点为单位测量。

draw_path(renderer, gc, tpath, affine, rgbFace=None)[源代码]¶: 派生应重写此方法。参数与 matplotlib.backend_bases.RendererBase.draw_path() 除了第一个参数是渲染器。

class matplotlib.patheffects.Normal(offset=(0.0, 0.0))[源代码]¶

基类：matplotlib.patheffects.AbstractPathEffect

“身份”的路径效应。

正常的路径效果的唯一目的是绘制没有特殊路径效果的原始艺术家。

参数:	offset双浮体应用于路径的偏移量，以点为单位测量。

class matplotlib.patheffects.PathEffectRenderer(path_effects, renderer)[源代码]¶

基类：matplotlib.backend_bases.RendererBase

实现包含另一个渲染器的渲染器。

然后，该代理截获draw调用，调用适当的 AbstractPathEffect 绘制方法。

注解

并非所有方法都在此renderBase子类上被重写。可能需要添加更多的方法来进一步扩展PathEffects功能。

参数:	path_effects : iterable of `AbstractPathEffect`可以此渲染器表示的路径效果。渲染器： `matplotlib.backend_bases.RendererBase` 子类matplotlib.u基.RendererBase子类

copy_with_path_effect(path_effects)[源代码]¶

draw_markers(gc, marker_path, marker_trans, path, *args, **kwargs)[源代码]¶

在路径中的每个顶点绘制一个标记。

这包括所有顶点，包括曲线上的控制点。为了避免这种行为，应该在调用此函数之前删除这些顶点。

这提供了一个draw_标记的回退实现，该标记对 draw_path() . 有些后端可能希望重写此方法，以便只绘制一次标记并多次重复使用它。

参数:	gc ： `GraphicsContextBaseGraphicsContextBase` 图形上下文。 marker_trans ： `matplotlib.transforms.Transformmatplotlib.transforms.Transform` 应用于标记的仿射变换。反式： `matplotlib.transforms.Transformmatplotlib.transforms.Transform` 应用于路径的仿射变换。

draw_path(gc, tpath, affine, rgbFace=None)[源代码]¶: 画一个 Path 使用给定仿射变换的实例。

draw_path_collection(gc, master_transform, paths, *args, **kwargs)[源代码]¶

从列表中选择图形特性绘制路径集合脸色， 绿色染料 ， 线宽度 ， 直线运动 和 抗混叠剂 . 偏移量 是要应用于每个路径的偏移列表。中的偏移量 偏移量 首先被 抵销交易 在应用之前。

offset_position 可以是“屏幕”或“数据”，具体取决于偏移所处的空间；“数据”已弃用。

这提供了 draw_path_collection() 打了多次电话给 draw_path() . 有些后端可能希望重写此项，以便只渲染一次每个路径数据集，然后使用不同的偏移量、颜色、样式等多次引用该路径。生成器方法 _iter_collection_raw_paths() 和 _iter_collection() 旨在帮助（和标准化）跨后端的实现。强烈建议使用这些生成器，以便更改 draw_path_collection() 可以在全球范围内生产。

class matplotlib.patheffects.PathPatchEffect(offset=(0, 0), **kwargs)[源代码]¶

基类：matplotlib.patheffects.AbstractPathEffect

绘制一个 PathPatch 其路径来自原始PathEffect艺术家的实例。

参数:	offset双浮体应用于路径的偏移量，以点为单位。 **kwargs 所有关键字参数都传递给 `PathPatch` 构造函数。不能重写的属性是“path”、“clip-box”、“transform”和“clip-path”。

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]¶: 派生应重写此方法。参数与 matplotlib.backend_bases.RendererBase.draw_path() 除了第一个参数是渲染器。

class matplotlib.patheffects.SimpleLineShadow(offset=(2, - 2), shadow_color='k', alpha=0.3, rho=0.3, **kwargs)[源代码]¶

基类：matplotlib.patheffects.AbstractPathEffect

通过线条的简单阴影。

参数:	offset双浮体应用于路径的偏移量，以点为单位。 shadow_color颜色，默认值：“黑色” 阴影的颜色。价值 `None` 使用原始艺术家的颜色，比例因子为 rho . alpha浮点，默认值：0.3 创建的阴影面片的alpha透明度。 rho浮点，默认值：0.3 应用于rgbface颜色的比例因子，如果 `shadow_rgbFace` 是 `None` . **kwargs 额外的关键字被存储并传递到 `AbstractPathEffect._update_gc()` .

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]¶: 覆盖标准绘制路径以添加阴影偏移和阴影所需的颜色更改。

class matplotlib.patheffects.SimplePatchShadow(offset=(2, - 2), shadow_rgbFace=None, alpha=None, rho=0.3, **kwargs)[源代码]¶

基类：matplotlib.patheffects.AbstractPathEffect

一个简单的阴影通过一个填充的补丁。

参数:	offset双浮体阴影在点中的偏移。 shadow_rgbFace颜色阴影颜色。 alpha浮点，默认值：0.3 创建的阴影面片的alpha透明度。http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rho浮点，默认值：0.3 应用于rgbface颜色的比例因子，如果 `shadow_rgbFace` 未指定。 **kwargs 额外的关键字被存储并传递到 `AbstractPathEffect._update_gc()` .

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]¶: 覆盖标准绘制路径以添加阴影偏移和阴影所需的颜色更改。

class matplotlib.patheffects.Stroke(offset=(0, 0), **kwargs)[源代码]¶

基类：matplotlib.patheffects.AbstractPathEffect

重新绘制笔划的基于线条的路径效果。

该路径将使用其GC进行笔画，并使用给定的关键字参数进行更新，即关键字参数应为有效的GC参数值。

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]¶: 用更新的gc绘制路径。

class matplotlib.patheffects.withSimplePatchShadow(offset=(2, - 2), shadow_rgbFace=None, alpha=None, rho=0.3, **kwargs)¶

基类：matplotlib.patheffects.SimplePatchShadow

应用的快捷方式 SimplePatchShadow 然后画出原始的艺术家。

在本课程中，您可以使用：

artist.set_path_effects([path_effects.withSimplePatchShadow()])

作为快捷方式：

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

参数:	offset双浮体阴影在点中的偏移。 shadow_rgbFace颜色阴影颜色。 alpha浮点，默认值：0.3 创建的阴影面片的alpha透明度。http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rho浮点，默认值：0.3 应用于rgbface颜色的比例因子，如果 `shadow_rgbFace` 未指定。 **kwargs 额外的关键字被存储并传递到 `AbstractPathEffect._update_gc()` .

draw_path(renderer, gc, tpath, affine, rgbFace)¶: 覆盖标准绘制路径以添加阴影偏移和阴影所需的颜色更改。

class matplotlib.patheffects.withStroke(offset=(0, 0), **kwargs)¶

基类：matplotlib.patheffects.Stroke

应用的快捷方式 Stroke 然后画出原始的艺术家。

在本课程中，您可以使用：

artist.set_path_effects([path_effects.withStroke()])

作为快捷方式：

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

该路径将使用其GC进行笔画，并使用给定的关键字参数进行更新，即关键字参数应为有效的GC参数值。

draw_path(renderer, gc, tpath, affine, rgbFace)¶: 用更新的gc绘制路径。

matplotlib.patheffects¶

`matplotlib.patheffects`¶