matplotlib.patheffects

Определяет классы для эффектов траекторий. Эффекты траекторий поддерживаются в Text, Line2D и Patch.

class matplotlib.patheffects.AbstractPathEffect(offset=0.0, 0.0) [source]

Базовый класс для эффектов траекторий.

Подклассы должны переопределить метод draw_path для добавления функциональности эффекта.

Параметры:	offsetpair of floats Смещение, применяемое к траектории, измеряется в пунктах.

draw_path(self, renderer, gc, tpath, affine, rgbFace=None) [source]

Производные классы должны переопределить этот метод. Аргументы такие же, как в matplotlib.backend_bases.RendererBase.draw_path(), за исключением первого аргумента, который является рендерером.

class matplotlib.patheffects.Normal(offset=0.0, 0.0) [source]

Базы: matplotlib.patheffects.AbstractPathEffect

"Идентичный" эффект траектории.

Единственная цель эффекта траектории Normal — нарисовать исходный объект без специального эффекта траектории.

Параметры:	offsetpair of floats Смещение, применяемое к траектории, измеряется в пунктах.

class matplotlib.patheffects.PathEffectRenderer(path_effects, renderer) [source]

Базы: matplotlib.backend_bases.RendererBase

Реализует рендерер, содержащий другой рендерер.

Этот прокси перехватывает вызовы draw, вызывая соответствующий метод draw класса AbstractPathEffect.

Примечание

Не все методы были переопределены в этом подклассе RendererBase. Возможно, потребуется добавить дополнительные методы для дальнейшего расширения возможностей эффектов траекторий.

Параметры:	path_effectsiterable of AbstractPathEffect Эффекты траекторий, которые представляет этот рендерер. renderermatplotlib.backend_bases.RendererBase subclass

copy_with_path_effect(self, path_effects) [source]

draw_markers(self, gc, marker_path, marker_trans, path, *args, **kwargs) [source]

Рисует маркер в каждой вершине в траектории.

Это включает все вершины, включая контрольные точки на кривых. Для предотвращения этого поведения эти вершины следует удалить перед вызовом этой функции.

Это обеспечивает реализацию по умолчанию draw_markers, которая выполняет несколько вызовов draw_path(). Некоторые бэкэнды могут захотеть переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.

Параметры:	gcGraphicsContextBase Контекст графики. marker_transmatplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. transmatplotlib.transforms.Transform Аффинное преобразование, применяемое к траектории.

draw_path(self, gc, tpath, affine, rgbFace=None) [source]

Рисует экземпляр Path с использованием данного аффинного преобразования.

draw_path_collection(self, gc, master_transform, paths, *args, **kwargs) [source]

Рисует коллекцию траекторий, выбирая свойства рисования из списков facecolors, edgecolors, linewidths, linestyles и antialiaseds. offsets — список смещений, которые нужно применить к каждой из траекторий. Смещения в offsets сначала преобразуются с помощью offsetTrans перед применением.

offset_position может быть либо "screen", либо "data", в зависимости от пространства, в котором находятся смещения; "data" устарел.

Это обеспечивает реализацию по умолчанию draw_path_collection(), которая выполняет несколько вызовов draw_path(). Некоторые бэкэнды могут захотеть переопределить этот метод, чтобы отрисовать каждый набор данных траекторий только один раз, а затем ссылаться на эту траекторию несколько раз с различными смещениями, цветами, стилями и т. д. Генераторные методы _iter_collection_raw_paths() и _iter_collection() предназначены для помощи (и стандартизации) реализации в различных бэкэндах. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведении draw_path_collection() можно было применять глобально.

class matplotlib.patheffects.PathPatchEffect(offset=0, 0, **kwargs) [source]

Базы: matplotlib.patheffects.AbstractPathEffect

Рисует экземпляр PathPatch, чья траектория взята от исходного объекта с эффектом траектории.

Параметры:	offsetpair of floats Смещение, применяемое к траектории, в пунктах. **kwargs Все ключевые аргументы передаются конструктору PathPatch. Свойства, которые нельзя переопределить, — "path", "clip_box", "transform" и "clip_path".

draw_path(self, renderer, gc, tpath, affine, rgbFace) [source]

Производные классы должны переопределить этот метод. Аргументы такие же, как в matplotlib.backend_bases.RendererBase.draw_path(), за исключением первого аргумента, который является рендерером.

class matplotlib.patheffects.SimpleLineShadow(offset=2, - 2, shadow_color='k', alpha=0.3, rho=0.3, **kwargs) [source]

Bases: matplotlib.patheffects.AbstractPathEffect

Простой оттенок с помощью линии.

Параметры:

offsetpair of floats Смещение, применяемое к пути, в пунктах. shadow_colorcolor, default: 'black' Цвет тени. Значение None принимает исходный цвет элемента с масштабным коэффициентом rho. alphafloat, default: 0.3 Альфа-прозрачность создаваемого фрагмента тени. rhofloat, default: 0.3 Коэффициент масштабирования для rgbFace цвета, если shadow_rgbFace равен None. **kwargs Дополнительные ключевые слова сохраняются и передаются в AbstractPathEffect._update_gc().

draw_path(self, renderer, gc, tpath, affine, rgbFace) [source]

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

class matplotlib.patheffects.SimplePatchShadow(offset=2, - 2, shadow_rgbFace=None, alpha=None, rho=0.3, **kwargs) [source]

Bases: matplotlib.patheffects.AbstractPathEffect

Простая тень с помощью заполненного фрагмента.

Параметры:

offsetpair of floats Смещение тени в пунктах. shadow_rgbFacecolor Цвет тени. alphafloat, default: 0.3 Альфа-прозрачность создаваемого фрагмента тени. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rhofloat, default: 0.3 Коэффициент масштабирования для rgbFace цвета, если shadow_rgbFace не указан. **kwargs Дополнительные ключевые слова сохраняются и передаются в AbstractPathEffect._update_gc().

draw_path(self, renderer, gc, tpath, affine, rgbFace) [source]

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

class matplotlib.patheffects.Stroke(offset=0, 0, **kwargs) [source]

Bases: matplotlib.patheffects.AbstractPathEffect

PathEffect на основе линии, который перерисовывает штрих.

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

draw_path(self, renderer, gc, tpath, affine, rgbFace) [source]

Отрисовка пути с обновленным gc.

class matplotlib.patheffects.withSimplePatchShadow(offset=2, - 2, shadow_rgbFace=None, alpha=None, rho=0.3, **kwargs)

Bases: matplotlib.patheffects.SimplePatchShadow

Сокращение PathEffect для применения SimplePatchShadow и затем отрисовки исходного элемента.

С помощью этого класса вы можете использовать

artist.set_path_effects([path_effects.withSimplePatchShadow()])

как сокращение для

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

Параметры:

offsetpair of floats Смещение тени в пунктах. shadow_rgbFacecolor Цвет тени. alphafloat, default: 0.3 Альфа-прозрачность создаваемого фрагмента тени. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rhofloat, default: 0.3 Коэффициент масштабирования для rgbFace цвета, если shadow_rgbFace не указан. **kwargs Дополнительные ключевые слова сохраняются и передаются в AbstractPathEffect._update_gc().

draw_path(self, renderer, gc, tpath, affine, rgbFace)

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

class matplotlib.patheffects.withStroke(offset=0, 0, **kwargs)

Bases: matplotlib.patheffects.Stroke

Сокращение PathEffect для применения Stroke и затем отрисовки исходного элемента.

С помощью этого класса вы можете использовать

artist.set_path_effects([path_effects.withStroke()])

как сокращение для

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

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

draw_path(self, renderer, gc, tpath, affine, rgbFace)

Отрисовка пути с обновленным gc.