matplotlib._enums

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

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

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

classmatplotlib._enums.JoinStyle(value)[source]

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

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

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

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

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

'miter'

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

'round'

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

'bevel'

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

Примечание

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

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

(Исходный код, png)

staticdemo()[source]

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

classmatplotlib._enums.CapStyle(value)[source]

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

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

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

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

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

'butt'

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

'projecting'

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

'round'

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

(Исходный код, png)

staticdemo()[source]

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