matplotlib._enums

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

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

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

classmatplotlib._enums.JoinStyle(value, names=<not given>, *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'

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

Примечание

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

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

(Source code, 2x.png, png)

staticdemo()[source]

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

classmatplotlib._enums.CapStyle(value, names=<not given>, *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, 2x.png, png)

staticdemo()[source]

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