Эффекты путей

matplotlib.patheffects

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

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

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

Подклассы должны переопределить метод 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]

Базы: matplotlib.patheffects.AbstractPathEffect

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

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

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

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

Базы: 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 может быть либо "screen", либо "data", в зависимости от пространства, в котором находятся смещения.

Это предоставляет реализацию по умолчанию для 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.