matplotlib._enums

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

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

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

classmatplotlib._enums.JoinStyle(*values)[исходный код]

Определяет способ отрисовки соединения двух отрезков линии.

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

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

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

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

'miter'

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

'round'

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

'bevel'

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

Примечание

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

Более подробное описание влияния предела miter приведено в документации Mozilla для разработчиков

(Source code, 2x.png, png)

staticdemo()[исходный код]

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

classmatplotlib._enums.CapStyle(*values)[исходный код]

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

Способ отрисовки начальной и конечной точек линий, представляющих замкнутую кривую (то есть заканчивающихся командой 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()[исходный код]

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