matplotlib.patches.Patch #

类 matplotlib.patches。补丁（*， edgecolor = None， facecolor = None， color = None， linewidth = None， linestyle = None， antialiased = None， hatch = None， fill = True， capstyle = None， joinstyle = None， ** kwargs）[来源]#

基地：Artist

补丁是具有面颜色和边缘颜色的 2D 艺术家。

如果edgecolor、facecolor、linewidth或antialiased中的任何一个是None，它们默认为它们的 rc 参数设置。

支持以下 kwarg 属性

财产	描述
`agg_filter`	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
`alpha`	未知
`animated`	布尔
`antialiased`或aa	布尔或无
`capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`clip_box`	`Bbox`
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`color`	颜色
`edgecolor`或 ec	颜色或无
`facecolor`或 fc	颜色或无
`figure`	`Figure`
`fill`	布尔
`gid`	字符串
`hatch`	{'/'、'\'、'\|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
`in_layout`	布尔
`joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`label`	目的
`linestyle`或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`或 lw	浮动或无
`mouseover`	布尔
`path_effects`	`AbstractPathEffect`
`picker`	None 或 bool 或 float 或可调用
`rasterized`	布尔
`sketch_params`	（比例：浮动，长度：浮动，随机性：浮动）
`snap`	布尔或无
`transform`	`Transform`
`url`	字符串
`visible`	布尔
`zorder`	漂浮

包含( mouseevent , radius = None ) [来源] #

测试补丁中是否发生鼠标事件。

返回：

（布尔，空字典）

contains_point ( point , radius = None ) [来源] #

返回给定点是否在补丁内。

参数：

点（浮点数，浮点数）: 要检查的点 (x, y)，位于的目标坐标中 self.get_transform()。这些是添加到图形或轴的补丁的显示坐标。
半径浮动，可选: 在目标坐标中的补丁上添加额外的边距 self.get_transform()。有关详细信息，请参阅Path.contains_point。

返回：

布尔

笔记

此方法的正确使用取决于补丁的变换。孤立的补丁没有变换。在这种情况下，面片创建坐标和点坐标匹配。以下示例检查圆心是否在圆内

>>> center = 0, 0
>>> c = Circle(center, radius=1)
>>> c.contains_point(center)
True

检查转换后的补丁的惯例源于该方法主要用于检查显示坐标（例如来自鼠标事件）是否在补丁内。如果要对数据坐标进行上述检查，则必须先正确转换它们：

>>> center = 0, 0
>>> c = Circle(center, radius=1)
>>> plt.gca().add_patch(c)
>>> transformed_center = c.get_transform().transform(center)
>>> c.contains_point(transformed_center)
True

contains_points ( points , radius = None ) [来源] #

返回给定点是否在补丁内。

参数：

点(N, 2) 数组: 要检查的点，在的目标坐标中 self.get_transform()。这些是添加到图形或轴的补丁的显示坐标。列包含 x 和 y 值。
半径浮动，可选: 在目标坐标中的补丁上添加额外的边距 self.get_transform()。有关详细信息，请参阅Path.contains_point。

返回：

长度-N 布尔数组

笔记

此方法的正确使用取决于补丁的变换。请参阅上的注释Patch.contains_point。

绘制（渲染器）[来源] #

使用给定的渲染器绘制艺术家（及其子级）。

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 Artist 子类中被覆盖。

属性填充#: 返回补丁是否填充。

get_aa ( ) [来源] #: 的别名get_antialiased。

get_antialiased ( ) [来源] #: 返回是否使用抗锯齿进行绘图。

get_capstyle ( ) [来源] #: 返回帽子样式。

get_data_transform ( ) [来源] #: 将映射数据坐标返回Transform到物理坐标。

get_ec ( ) [来源] #: 的别名get_edgecolor。

get_edgecolor ( ) [来源] #: 返回边缘颜色。

get_extents ( ) [来源] #: Patch将的轴对齐范围返回为Bbox。

get_facecolor ( ) [来源] #: 返回面部颜色。

get_fc ( ) [来源] #: 的别名get_facecolor。

get_fill ( ) [来源] #: 返回补丁是否填充。

get_hatch ( ) [来源] #: 返回阴影图案。

get_joinstyle ( ) [来源] #: 返回连接样式。

get_linestyle ( ) [来源] #: 返回线型。

get_linewidth ( ) [来源] #: 返回以点为单位的线宽。

get_ls ( ) [来源] #: 的别名get_linestyle。

get_lw ( ) [来源] #: 的别名get_linewidth。

get_patch_transform ( ) [来源] #

将实例映射补丁坐标返回Transform到数据坐标。

例如，可以通过提供单位圆的坐标和将坐标（块坐标）缩放 5 的变换来定义表示半径为 5 的圆的补丁。

get_path ( ) [来源] #: 返回此补丁的路径。

get_transform ( ) [来源] #: Transform将应用返回到Patch.

get_verts ( ) [来源] #

返回此补丁中使用的顶点的副本。

如果补丁包含贝塞尔曲线，则曲线将由线段插值。要将曲线作为曲线访问，请使用get_path。

get_window_extent ( renderer = None ) [source] #

在显示空间中获取艺术家的边界框。

边界框的宽度和高度是非负的。

子类应覆盖以包含在边界框“紧密”计算中。默认是在 0, 0 处返回一个空的边界框。

使用此功能时要小心，如果艺术家的艺术家窗口范围发生变化，结果将不会更新。由于变换堆栈中的任何更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做的那样），范围可能会发生变化。这可能会导致意外行为，其中交互式图形在屏幕上看起来很好，但会错误地保存。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , antialiased=<UNSET> , capstyle=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , fill=<UNSET> , gid=<UNSET > , hat=<UNSET> , in_layout=<UNSET> ,joinstyle =<UNSET> ,标签=<UNSET> ,linestyle=<UNSET> ,linewidth=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET > , picker=< UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> ) [来源] #

一次设置多个属性。

支持的属性是

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

未知

animated

布尔

antialiased

布尔或无

capstyle

CapStyle或 {'butt', 'projecting', 'round'}

clip_box

Bbox

clip_on

布尔

clip_path

补丁或（路径，变换）或无

color

颜色

edgecolor

颜色或无

facecolor

颜色或无

figure

Figure

fill

布尔

gid

字符串

hatch

{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}

in_layout

布尔

joinstyle

JoinStyle或 {'miter', 'round', 'bevel'}

label

目的

linestyle

{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

linewidth

浮动或无

mouseover

布尔

path_effects

AbstractPathEffect

picker

None 或 bool 或 float 或可调用

rasterized

布尔

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

transform

Transform

url

字符串

visible

布尔

zorder

漂浮

set_aa ( aa ) [来源] #: 的别名set_antialiased。

set_alpha ( alpha ) [来源] #

设置用于混合的 alpha 值 - 并非所有后端都支持。

参数：

alpha标量或无: alpha必须在 0-1 范围内（含）。

set_antialiased ( aa ) [来源] #

设置是否使用抗锯齿渲染。

参数：

aa布尔值或无

set_capstyle ( s ) [来源] #

设置CapStyle.

对于所有其他补丁，默认的 capstyle 是“round”FancyArrowPatch和“butt”。

参数：

sCapStyle或 {'butt', 'projecting', 'round'}

set_color ( c ) [来源] #

设置 edgecolor 和 facecolor。

参数：

c颜色

也可以看看

Patch.set_facecolor,Patch.set_edgecolor: 用于单独设置边缘或面颜色。

set_ec (颜色) [来源] #: 的别名set_edgecolor。

set_edgecolor (颜色) [来源] #

设置补丁边缘颜色。

参数：

颜色颜色或无

set_facecolor (颜色) [来源] #

设置补丁面颜色。

参数：

颜色颜色或无

set_fc (颜色) [来源] #: 的别名set_facecolor。

set_fill ( b ) [来源] #

设置是否填充补丁。

参数：

b布尔值

set_hatch (孵化) [来源] #

设置阴影图案。

孵化可以是以下之一：

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

可以组合字母，在这种情况下，所有指定的阴影都已完成。如果相同的字母重复，则会增加该图案的阴影密度。

阴影仅在 PostScript、PDF、SVG 和 Agg 后端中受支持。

参数：

孵化{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_joinstyle ( s ) [来源] #

设置JoinStyle.

对于所有其他补丁，默认连接样式是“圆形”FancyArrowPatch和“斜接”。

参数：

sJoinStyle或 {'miter', 'round', 'bevel'}

set_linestyle ( ls ) [来源] #

设置面片线型。

线型	描述
`'-'`或者`'solid'`	实线
`'--'`或者`'dashed'`	虚线
`'-.'`或者`'dashdot'`	点划线
`':'`或者`'dotted'`	虚线
`'none'`, `'None'`, , 或`' '''`	什么都不画