matplotlib._enums

Перечисления, представляющие наборы строк, используемых Matplotlib в качестве входных параметров.

Matplotlib часто использует простые типы данных, такие как строки или кортежи, для определения концепции; например, стиль закругления линии можно указать как одну из 'butt', 'round' или 'projecting'. Классы в этом модуле используются внутри и служат для формального документирования этих концепций.

В качестве конечного пользователя вы не будете напрямую использовать эти классы, а только значения, которые они определяют.

classmatplotlib._enums.JoinStyle(value, names=None, *values, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Определяет, как рисуется соединение между двумя отрезками линии.

Для визуального представления каждого JoinStyle, view these docs online, или выполните JoinStyle.demo.

Линии в Matplotlib обычно определяются 1D Path и конечным linewidth, где базовая 1D Path представляет центр нарисованной линии.

По умолчанию GraphicsContextBase определяет границы нарисованной линии как все точки в некотором радиусе, linewidth/2, от любой точки центральной линии. Однако это приводит к тому, что углы выглядят "закругленными", что может быть нежелательным поведением, если вы рисуете, например, многоугольник или звезду.

Поддерживаемые значения:

'miter'

стиль "стрелочное наконечник". Каждая граница заполненной области будет продолжать расширяться по прямой, параллельной касательной вектору центральной линии в точке пересечения с углом, до тех пор пока не встретятся в острой точке.

'round'

закрашивает все точки в радиусе linewidth/2 от центральной линии.

'bevel'

стиль "закруглённый". Его можно представить как закруглённый угол, где "круглая" часть угла была отсечена.

Примечание

Очень длинные наконечники срезки (для формирования *bevel*) отсекаются после зависимой от бэкэнда границы, называемой "предельным значением среза", которая определяет максимальное допустимое соотношение длины среза к ширине линии. Например, бэкэнд PDF использует значение по умолчанию 10, указанное в стандарте PDF, в то время как бэкэнд SVG даже не указывает предельное значение среза, что приводит к значению по умолчанию 4 в соответствии со спецификацией SVG. Matplotlib в настоящее время не позволяет пользователю настроить этот параметр.

Более подробное описание влияния предельного значения среза можно найти в Mozilla Developer Docs

(Source code, png)

staticdemo()[source]

Демонстрация того, как каждый JoinStyle выглядит для различных углов соединения.

classmatplotlib._enums.CapStyle(value, names=None, *values, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Определяет, как рисуются два конечных пункта (наконечники) незамкнутой линии.

Как рисовать начальные и конечные точки линий, представляющих замкнутую кривую (т.е. заканчивающихся на CLOSEPOLY) контролируется линией JoinStyle. Для всех других линий способ рисования начальных и конечных точек контролируется CapStyle.

Для визуального представления каждого CapStyle, view these docs online или выполните CapStyle.demo.

По умолчанию GraphicsContextBase рисует нарисованную линию как прямоугольную в своих конечных точках.

Поддерживаемые значения:

'butt'

линия обрезается в её конечной точке.

'projecting'

линия обрезается как в butt, но заполненная область выходит за пределы конечной точки на расстояние linewidth/2.

'round'

подобно butt, но к концу линии добавляется полукруглая крышка радиусом linewidth/2.

(Source code, png)

staticdemo()[source]

Демонстрация того, как каждый CapStyle выглядит для толстого сегмента линии.