patheffects

matplotlib.patheffects

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

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

Bases: object

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

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

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

draw_path(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(path_effects) [source]

draw_markers(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(gc, tpath, affine, rgbFace=None) [source]

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

draw_path_collection(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() [source]

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

points_to_pixels(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(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(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(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(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(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(renderer, gc, tpath, affine, rgbFace) [source]

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