matplotlib.patches.Patch

class matplotlib.patches.Patch(edgecolor=None, facecolor=None, color=None, linewidth=None, linestyle=None, antialiased=None, hatch=None, fill=True, capstyle=None, joinstyle=None, **kwargs)

Объект Patch — это двумерный художник с цветом заливки и цветом контура.

Если какое-либо из значений edgecolor, facecolor, linewidth или antialiased равно None, они принимают значения по умолчанию из параметров rc.

Поддерживаются следующие свойства kwarg:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или aa	[True | False] или None для значения по умолчанию
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, None, ‘none’ или ‘auto’
facecolor или fc	спецификация цвета mpl или None по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка-идентификатор
hatch	[‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой печатный объект с преобразованием ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность включения/выключения) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
visible	[True | False]
zorder	любое число

contains(mouseevent, radius=None)

Проверяет, произошло ли событие мыши внутри области.

Возвращает Истина/Ложь, {}

contains_point(point, radius=None)

Возвращает True, если заданная точка находится внутри пути (преобразованного с помощью атрибута transform).

draw(renderer)

Отрисовывает объект Patch на заданном рендерере.

fill

Возвращает, установлена ли заливка.

get_aa()

Возвращает True, если объект Patch должен быть отрисован с антиалиасингом.

get_antialiased()

Возвращает True, если объект Patch должен быть отрисован с антиалиасингом.

get_capstyle()

Возвращает текущую установку capstyle.

get_data_transform()

Возвращает экземпляр Transform, который отображает координаты данных в физические координаты.

get_ec()

Возвращает цвет контура объекта Patch.

get_edgecolor()

Возвращает цвет контура объекта Patch.

get_extents()

Возвращает объект Bbox, определяющий прямоугольные границы объекта Patch.

get_facecolor()

Возвращает цвет заливки объекта Patch.

get_fc()

Возвращает цвет заливки объекта Patch.

get_fill()

Возвращает, установлена ли заливка.

get_hatch()

Возвращает текущий узор штриховки.

get_joinstyle()

Возвращает текущий стиль соединения.

get_linestyle()

Возвращает стиль линии. Будет одним из [‘сплошная’ | ‘штриховая’ | ‘штрихпунктирная’ | ‘пунктирная’]

get_linewidth()

Возвращает ширину линии в пунктах.

get_ls()

Возвращает стиль линии. Будет одним из [‘сплошная’ | ‘штриховая’ | ‘штрихпунктирная’ | ‘пунктирная’]

get_lw()

Возвращает ширину линии в пунктах.

get_patch_transform()

Возвращает экземпляр Transform, который преобразует координаты фигуры в координаты данных.

Например, можно определить фигуру круга, представляющую радиус 5, предоставив координаты единичного круга и преобразование, которое масштабирует координаты (координаты фигуры) на 5.

get_path()

Возвращает путь этой фигуры.

get_transform()

Возвращает Transform, применяемый к Patch.

get_verts()

Возвращает копию вершин, используемых в этой фигуре.

Если фигура содержит кривые Безье, кривые будут интерполированы отрезками прямых. Чтобы получить доступ к кривым как к кривым, используйте get_path().

get_window_extent(renderer=None)

set_aa(aa)

Псевдоним для set_antialiased.

set_alpha(alpha)

Устанавливает альфа-прозрачность фигуры.

ПРИНИМАЕТ: float или None

set_antialiased(aa)

Устанавливает, использовать ли антиалайзинг при отрисовке.

ПРИНИМАЕТ: [True | False] или None для значения по умолчанию

set_capstyle(s)

Устанавливает стиль окончания фигуры.

ПРИНИМАЕТ: [‘butt’ | ‘round’ | ‘projecting’]

set_color(c)

Устанавливает как цвет края, так и цвет заливки.

ПРИНИМАЕТ: цветовое представление matplotlib

См. также

set_facecolor(), set_edgecolor()

Для отдельной установки цвета края или заливки.

set_ec(color)

Псевдоним для set_edgecolor.

set_edgecolor(color)

Устанавливает цвет края фигуры.

ПРИНИМАЕТ: цветовое представление matplotlib, None, ‘none’ или ‘auto’

set_facecolor(color)

Устанавливает цвет заливки фигуры.

ПРИНИМАЕТ: цветовое представление matplotlib или None для значения по умолчанию, или ‘none’ для отсутствия цвета.

set_fc(color)

Псевдоним для set_facecolor.

set_fill(b)

Устанавливает, закрашивать ли фигуру.

ПРИНИМАЕТ: [True | False]

set_hatch(hatch)

Устанавливает узор штриховки.

hatch может быть одним из:

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

Буквы могут быть объединены, в этом случае выполняются все указанные виды штриховки. Если одна и та же буква повторяется, это увеличивает плотность штриховки этого узора.

Штриховка поддерживается только в PostScript, PDF, SVG и Agg backends.

ПРИНИМАЕТ: [‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]

set_joinstyle(s)

Устанавливает стиль соединения фигуры.

ПРИНИМАЕТ: [‘miter’ | ‘round’ | ‘bevel’]

set_linestyle(ls)

Устанавливает стиль линии фигуры.

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	штриховая линия
'-.' или 'dashdot'	штрих-пунктирная линия
':' или 'dotted'	пунктирная линия

В качестве альтернативы может быть предоставлена кортеж с последовательностью длины, имеющей следующий вид:

(offset, onoffseq),

где onoffseq — кортеж чётной длины чередующихся значений длины прочерка и пробела в пунктах.

ПРИНИМАЕТ: [‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ |

(смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linewidth(w)

Устанавливает ширину линии фигуры в пунктах.

ПРИНИМАЕТ: float или None для значения по умолчанию

set_ls(ls)

Псевдоним для set_linestyle.

set_lw(lw)

Псевдоним для set_linewidth.

update_from(other)

Обновляет этот Patch на основе свойств other.

validCap = ('butt', 'round', 'projecting')

validJoin = ('miter', 'round', 'bevel')

zorder = 1

Примеры использования matplotlib.patches.Patch

Руководство по легендам