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

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

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

Примечание

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

Параметры:	path_effectsiterable of AbstractPathEffect Эффекты путей, которые представляет этот рендерер. renderermatplotlib.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(). Некоторые бэкэнды могут захотеть переопределить этот метод, чтобы нарисовать маркер только один раз и использовать его несколько раз.

Параметры:	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», в зависимости от пространства, в котором находятся смещения.

Это предоставляет реализацию по умолчанию 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, путь которого берется из исходного элемента управления PathEffect.

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

Базы: matplotlib.patheffects.AbstractPathEffect

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

Параметры:

offsetpair of floats Смещение, применяемое к пути, в пунктах. shadow_colorcolor Цвет тени. По умолчанию — черный. Значение None использует цвет исходного объекта с коэффициентом масштабирования rho. alphafloat Альфа-прозрачность созданного фрагмента тени. По умолчанию — 0,3. rhofloat Коэффициент масштабирования, применяемый к цвету 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

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

Параметры:

offsetpair of floats Смещение тени в пунктах. shadow_rgbFacecolor Цвет тени. alphafloat Альфа-прозрачность созданного фрагмента тени. По умолчанию — 0,3. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rhofloat Коэффициент масштабирования, применяемый к цвету 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

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

Путь будет нанесён штрихом, а его 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, а затем рисует исходный объект-артист, чтобы избежать необходимости вызова Normal.

Параметры:

offsetpair of floats Смещение тени в пунктах. shadow_rgbFacecolor Цвет тени. alphafloat Альфа-прозрачность созданного фрагмента тени. По умолчанию — 0,3. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rhofloat Коэффициент масштабирования, применяемый к цвету 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, а затем рисует исходный объект-артист, чтобы избежать необходимости вызова Normal.

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

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

Рисует путь с обновлённым gc.