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'

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

Примечание

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

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

(Source code, 2x.png, 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.

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

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

'butt'

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

'projecting'

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

'round'

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

(Source code, 2x.png, png)

staticdemo()[source]

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