matplotlib.patheffects

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

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

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

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

Параметры:	offset : pair 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]

Bases: matplotlib.patheffects.AbstractPathEffect

"Идентичный" эффект пути.

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

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

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

Bases: matplotlib.backend_bases.RendererBase

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

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

Примечание

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

Параметры:	path_effects : iterable of AbstractPathEffect Эффекты пути, которые представляет этот рендерер. renderer : matplotlib.backend_bases.RendererBase instance

copy_with_path_effect(self, path_effects) [source]

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

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

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

Параметры:	gc : GraphicsContextBase Контекст графики marker_trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. trans : matplotlib.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 может быть либо «экран», либо «данные», в зависимости от пространства, в котором находятся смещения.

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

new_gc(self) [source]

Возвращает экземпляр GraphicsContextBase.

points_to_pixels(self, points) [source]

Преобразует точки в единицы отображения.

Вам нужно переопределить эту функцию (если ваш бэкэнд не имеет dpi, например, postscript или svg). Некоторые системы отображения предполагают некоторое значение для пикселей на дюйм:

points to pixels = points * pixels_per_inch/72.0 * dpi/72.0

Параметры:	points : scalar or array_like Число с плавающей запятой или массив NumPy чисел с плавающей запятой
Возвращает:	Точки, преобразованные в пиксели

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

Основы: matplotlib.patheffects.AbstractPathEffect

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

Параметры:	offset : pair 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]

Основы: matplotlib.patheffects.AbstractPathEffect

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

Параметры:

offset : pair of floats Смещение, применяемое к пути, в пунктах. shadow_color : color Цвет тени. По умолчанию — черный. Значение None берёт цвет исходного объекта с коэффициентом масштабирования rho. alpha : float Альфа-прозрачность создаваемого фрагмента тени. По умолчанию 0.3. rho : float Коэффициент масштабирования rgbFace цвета, если shadow_rgbFace не указан. По умолчанию 0.3. **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]

Основы: matplotlib.patheffects.AbstractPathEffect

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

Параметры:

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

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

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

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

Основы: 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) [source]

Основы: matplotlib.patheffects.SimplePatchShadow

Добавляет простую тень SimplePatchShadow и затем рисует исходный объект Artist, чтобы избежать необходимости вызова Normal.

Параметры:

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

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

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

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

Основы: matplotlib.patheffects.Stroke

Добавляет простую обводку Stroke и затем рисует исходный объект Artist, чтобы избежать вызова Normal.

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

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

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