Matplotlib is hiring a Research Software Engineering Fellow! See discourse for details. Apply by January 3, 2020

Version 3.1.1
matplotlib
Fork me on GitHub

目录

Related Topics

杂音

matplotlib.patheffects

为路径效果定义类。支持路径效果 TextLine2DPatch .

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.backend_base.renderBase实例
copy_with_path_effect(path_effects)[源代码]
draw_markers(gc, marker_path, marker_trans, path, *args, **kwargs)[源代码]

在路径中的每个顶点处绘制标记。这包括所有顶点,包括曲线上的控制点。为了避免这种行为,在调用这个函数之前应该删除这些顶点。

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

参数:
gcGraphicsContextBase : GraphicsContextBase

图形上下文

marker_transmatplotlib.transforms.Transform : matplotlib.transforms.Transform

应用于标记的仿射变换。

反式matplotlib.transforms.Transform : matplotlib.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() 可以在全球范围内生产。

new_gc()[源代码]

返回的实例 GraphicsContextBase

points_to_pixels(points)[源代码]

将点转换为显示单位

您需要重写这个函数(除非您的后端没有dpi,例如postscript或svg)。一些成像系统假定每英寸像素的值为:

points to pixels = points * pixels_per_inch/72.0 * dpi/72.0
参数:
points : 标量或类数组

浮点数或浮点数数组

返回:
转换为像素的点
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 .

阿尔法 : 浮动

创建的阴影面片的透明度。默认值为0.3。

rho : 浮动

应用于rgbface颜色的比例因子,如果 shadow_rgbFaceNone . 默认值为0.3。

**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 : 颜色

阴影颜色。

阿尔法 : 浮动

创建的阴影面片的透明度。默认值为0.3。http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html

rho : 浮动

应用于rgbface颜色的比例因子,如果 shadow_rgbFace 未指定。默认值为0.3。

**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 然后画出原来的艺术家以避免需要打电话 Normal .

参数:
offset : 双浮体

阴影在点中的偏移。

shadow_rgbFace : 颜色

阴影颜色。

阿尔法 : 浮动

创建的阴影面片的透明度。默认值为0.3。http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html

rho : 浮动

应用于rgbface颜色的比例因子,如果 shadow_rgbFace 未指定。默认值为0.3。

**kwargs

额外的关键字被存储并传递到 AbstractPathEffect._update_gc() .

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]

覆盖标准绘制路径以添加阴影偏移和阴影所需的颜色更改。

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

基类:matplotlib.patheffects.Stroke

添加简单 Stroke 然后画出原来的艺术家以避免需要打电话 Normal .

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

draw_path(renderer, gc, tpath, affine, rgbFace)[源代码]

使用更新的GC绘制路径。