matplotlib.text

Классы для включения текста в график.

class matplotlib.text.Annotation(**kwargs) [source]

Базы: matplotlib.text.Text, matplotlib.text._AnnotationBase

Аннотация — это Text, которая может ссылаться на определённую позицию xy. При желании можно нарисовать стрелку, направленную от текста к xy.

Атрибуты:	xy Анотируемая позиция. xycoords Система координат для xy. arrow_patch `FancyArrowPatch` для рисования стрелки от xytext к xy.

Анотирует точку xy текстом text.

В самом простом случае текст размещается в точке xy.

При желании текст можно отобразить в другой позиции xytext. Добавить стрелку, направленную от текста к анотируемой точке xy, можно, указав arrowprops.

Параметры:

textstr

Текст аннотации. s — устаревший синоним этого параметра.

xy(float, float)

Точка (x, y), подлежащая аннотации.

xytext(float, float), optional

Позиция (x, y) для размещения текста. Если None, по умолчанию используется xy.

xycoordsstr, Artist, Transform, callable or tuple, optional

Система координат, в которой задаётся xy. Поддерживаются следующие типы значений:

Одна из следующих строк:

Значение	Описание
'figure points'	Точки от нижнего левого угла графика
'figure pixels'	Пиксели от нижнего левого угла графика
'figure fraction'	Доля графика от нижнего левого угла
'axes points'	Точки от нижнего левого угла осей
'axes pixels'	Пиксели от нижнего левого угла осей
'axes fraction'	Доля осей от нижнего левого угла
'data'	Использование системы координат объекта, к которому относится аннотация (по умолчанию)
'polar'	(theta, r) если координаты не в формате 'data'

Объект Artist: xy интерпретируется как доля от Bbox объекта. Например, (0, 0) — это нижний левый угол области, а (0.5, 1) — центр верхней части области.
Преобразование Transform для преобразования xy в экранные координаты.
Функция с одним из следующих сигнатур:
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
где renderer — подкласс RendererBase.

Результат функции интерпретируется как в случае с Artist и Transform.
Кортеж (xcoords, ycoords), определяющий отдельные системы координат для x и y. xcoords и ycoords должны быть одного из вышеперечисленных типов.

Более подробную информацию см. в Расширенные аннотации.

По умолчанию — 'data'.

textcoordsstr, Artist, Transform, callable or tuple, optional

Система координат, в которой задаётся xytext.

Все значения xycoords допустимы, а также следующие строки:

Значение	Описание
'offset points'	Смещение (в пунктах) от значения xy
'offset pixels'	Смещение (в пикселях) от значения xy

По умолчанию — значение xycoords, т. е. используется та же система координат для точки аннотации и позиции текста.

arrowpropsdict, optional

Свойства, используемые для рисования стрелки FancyArrowPatch между позициями xy и xytext.

Если arrowprops не содержит ключа 'arrowstyle', допустимые ключи:

Ключ	Описание
width	Ширина стрелки в пунктах
headwidth	Ширина основания стрелки в пунктах
headlength	Длина наконечника стрелки в пунктах
shrink	Доля от общей длины, на которую уменьшается с обеих концов
?	Любой ключ к `matplotlib.patches.FancyArrowPatch`

Если arrowprops содержит ключ 'arrowstyle', вышеуказанные ключи запрещены. Допустимые значения 'arrowstyle':

Имя	Атрибуты
`'-'`	None
`'->'`	head_length=0.4,head_width=0.2
`'-['`	widthB=1.0,lengthB=0.2,angleB=None
`'\|-\|'`	widthA=1.0,widthB=1.0
`'-\|>'`	head_length=0.4,head_width=0.2
`'<-'`	head_length=0.4,head_width=0.2
`'<->'`	head_length=0.4,head_width=0.2
`'<\|-'`	head_length=0.4,head_width=0.2
`'<\|-\|>'`	head_length=0.4,head_width=0.2
`'fancy'`	head_length=0.4,head_width=0.4,tail_width=0.4
`'simple'`	head_length=0.5,head_width=0.5,tail_width=0.2
`'wedge'`	tail_width=0.3,shrink_factor=0.5

Допустимые ключи для FancyArrowPatch:

Ключ	Описание
arrowstyle	стиль стрелки
connectionstyle	стиль соединения
relpos	по умолчанию (0.5, 0.5)
patchA	по умолчанию — область текста
patchB	по умолчанию — None
shrinkA	по умолчанию — 2 пункта
shrinkB	по умолчанию — 2 пункта
mutation_scale	по умолчанию — размер текста (в пунктах)
mutation_aspect	по умолчанию — 1.
?	любой ключ для `matplotlib.patches.PathPatch`

По умолчанию — None, т. е. стрелка не рисуется.

annotation_clipbool or None, optional

Определяет, должна ли быть отрисована аннотация, если точка аннотации xy находится вне области осей.

Если True, аннотация будет отрисована только тогда, когда xy находится в области осей.
Если False, аннотация всегда будет отрисована.
Если None, аннотация будет отрисована только тогда, когда xy находится в области осей, и xycoords равно 'data'.

По умолчанию — None.

**kwargs

Дополнительные kwargs передаются в Text.

Возвращает:

annotationAnnotation

См. также

Расширенные аннотации

property anncoords: Система координат, используемая для Annotation.xyann.

contains(self, event) [source]

Проверка, произошло ли событие мыши внутри области.

В случае с текстом попадание считается истинным в любой точке области, содержащей текст.

Возвращает:	`boolbool`

draw(self, renderer) [source]: Отобразить объект Annotation на заданном renderer.

get_anncoords(self)

Возвращает систему координат для использования с Annotation.xyann.

См. также xycoords в Annotation.

get_window_extent(self, renderer=None) [source]

Возвращает Bbox рамку, содержащую текст и стрелку, в единицах отображения.

Параметры:

Параметры:	`rendererRenderer, optional` Для вычисления рамки требуется объект рендеринга. Если объект уже нарисован, объект рендеринга кэшируется; поэтому передавать этот аргумент необходимо только при вызове `get_window_extent` до первого вызова `draw`. На практике обычно легче сначала вызвать отрисовку (например, сохранив изображение).

rendererRenderer, optional: Для вычисления рамки требуется объект рендеринга. Если объект уже нарисован, объект рендеринга кэшируется; поэтому передавать этот аргумент необходимо только при вызове get_window_extent до первого вызова draw. На практике обычно легче сначала вызвать отрисовку (например, сохранив изображение).

set_anncoords(self, coords)

Устанавливает систему координат для использования с Annotation.xyann.

См. также xycoords в Annotation.

set_figure(self, fig) [source]

Устанавливает экземпляр Figure, к которому принадлежит объект.

Параметры:	`figFigure`

update_positions(self, renderer) [source]: Обновляет пиксельные позиции аннотируемой точки и текста.

property xyann

Позиция текста.

См. также xytext в Annotation.

class matplotlib.text.OffsetFrom(artist, ref_coord, unit='points') [source]

Базовый класс: object

Класс-помощник для работы с Annotation

Параметры:

Параметры:	`artistArtist, BboxBase, or Transform` Объект, от которого вычисляется смещение. `ref_coordlength 2 sequence` Если artist — это `Artist` или `BboxBase`, это значение — расположение начала смещения в долях рамки artist. Если artist — это преобразование, начало смещения — это преобразование, применённое к этому значению. `unit{'points, 'pixels'}` Единицы экрана, используемые для ввода смещения (пиксели или точки).

artistArtist, BboxBase, or Transform

Объект, от которого вычисляется смещение.

ref_coordlength 2 sequence

Если artist — это Artist или BboxBase, это значение — расположение начала смещения в долях рамки artist.

Если artist — это преобразование, начало смещения — это преобразование, применённое к этому значению.

unit{'points, 'pixels'}

Единицы экрана, используемые для ввода смещения (пиксели или точки).

get_unit(self) [source]: Единица для ввода в преобразование, используемое __call__

set_unit(self, unit) [source]

Единица для ввода в преобразование, используемое __call__

Параметры:	`unit{'points', 'pixels'}`

class matplotlib.text.Text(x=0, y=0, text='', color=None, verticalalignment='baseline', horizontalalignment='left', multialignment=None, fontproperties=None, rotation=None, linespacing=None, rotation_mode=None, usetex=None, wrap=False, **kwargs) [source]

Bases: matplotlib.artist.Artist

Обработка хранения и отрисовки текста в координатах окна или данных.

Создает экземпляр Text в точке x, y со строкой text.

Допустимые ключевые аргументы:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	вещественное число или None
`animated`	логическое значение
`backgroundcolor`	цвет
`bbox`	словарь свойств для `patches.FancyBboxPatch`
`clip_box`	`Bbox`
`clip_on`	логическое значение
`clip_path`	Объект Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	вызываемый объект
`figure`	`Figure`
`fontfamily` или family	{НАИМЕНОВАНИЕ ШРИФТА, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
`fontproperties` или font_properties	`font_manager.FontProperties`
`fontsize` или size	{размер в пунктах, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
`fontstretch` или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
`fontstyle` или style	{'normal', 'italic', 'oblique'}
`fontvariant` или variant	{'normal', 'small-caps'}
`fontweight` или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
`gid`	строка
`horizontalalignment` или ha	{'center', 'right', 'left'}
`in_layout`	логическое значение
`label`	объект
`linespacing`	вещественное число (кратное размеру шрифта)
`multialignment` или ma	{'left', 'right', 'center'}
`path_effects`	`AbstractPathEffect`
`picker`	None или логическое значение или вещественное число или вызываемый объект
`position`	(вещественное число, вещественное число)
`rasterized`	логическое значение или None
`rotation`	{угол в градусах, 'vertical', 'horizontal'}
`rotation_mode`	{None, 'default', 'anchor'}
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	логическое значение или None
`text`	объект
`transform`	`Transform`
`url`	строка
`usetex`	логическое значение или None
`verticalalignment` или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
`visible`	логическое значение
`wrap`	логическое значение
`x`	вещественное число
`y`	вещественное число
`zorder`	вещественное число

contains(self, mouseevent) [source]

Проверка, произошла ли событие мыши внутри области.

В случае с текстом, попадание происходит, если курсор находится где-либо внутри прямоугольной области, содержащей текст.

Возвращает:	`boolbool`

END_OF_DOCUMENT_MARKER

draw(self, renderer) [source]: Отображает объект Text на заданном renderer.

get_bbox_patch(self) [source]: Возвращает объект patches.FancyBboxPatch, или None, если он не создан.

get_c(self): Псевдоним для get_color.

get_color(self) [source]: Возвращает цвет текста.

get_family(self): Псевдоним для get_fontfamily.

get_font_properties(self): Псевдоним для get_fontproperties.

get_fontfamily(self) [source]

Возвращает список шрифтов, используемых для поиска шрифта.

См. также

font_manager.FontProperties.get_family

get_fontname(self) [source]

Возвращает имя шрифта в виде строки.

См. также

font_manager.FontProperties.get_name

get_fontproperties(self) [source]: Возвращает объект font_manager.FontProperties.

get_fontsize(self) [source]

Возвращает размер шрифта как целое число.

См. также

font_manager.FontProperties.get_size_in_points

get_fontstyle(self) [source]

Возвращает стиль шрифта в виде строки.

См. также

font_manager.FontProperties.get_style

get_fontvariant(self) [source]

Возвращает вариант шрифта в виде строки.

См. также

font_manager.FontProperties.get_variant

get_fontweight(self) [source]

Получает вес шрифта в виде строки или числа.

См. также

font_manager.FontProperties.get_weight

get_ha(self): Псевдоним для get_horizontalalignment.

get_horizontalalignment(self) [source]: Возвращает горизонтальное выравнивание в виде строки. Может быть 'left', 'center' или 'right'.

get_name(self): Псевдоним для get_fontname.

get_position(self) [source]: Возвращает позицию текста в виде кортежа (x, y).

get_prop_tup(self, renderer=None) [source]

Возвращает хешируемый кортеж свойств.

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

get_rotation(self) [source]: Возвращает угол текста в градусах в виде числа с плавающей точкой.

get_rotation_mode(self) [source]: Возвращает режим поворота текста.

get_size(self): Псевдоним для get_fontsize.

get_stretch(self) [source]

Возвращает растяжение шрифта в виде строки или числа.

См. также

font_manager.FontProperties.get_stretch

get_style(self): Псевдоним для get_fontstyle.

get_text(self) [source]: Возвращает текст в виде строки.

get_unitless_position(self) [source]: Возвращает безразмерную позицию текста в виде кортежа (x, y).

get_usetex(self) [source]: Возвращает, использует ли этот объект Text TeX для отрисовки.

get_va(self): Псевдоним для get_verticalalignment.

get_variant(self): Псевдоним для get_fontvariant.

END_OF_DOCUMENT_MARKER

get_verticalalignment(self) [source]: Возвращает выравнивание по вертикали в виде строки. Будет одним из 'верх', 'центр', 'низ' или 'линия основания'.

get_weight(self): Псевдоним для get_fontweight.

get_window_extent(self, renderer=None, dpi=None) [source]

Возвращает Bbox рамки, ограничивающей текст, в единицах отображения.

Помимо внутреннего использования, это полезно для задания нажаваемых областей в файле png на веб-странице.

Параметры:

Параметры:	`rendererRenderer, optional` Для вычисления рамки требуется рендерер. Если элемент уже нарисован, рендерер кэшируется; поэтому передавать этот аргумент необходимо только при вызове `get_window_extent` до первого `draw`. На практике обычно проще сначала вызвать отрисовку (например, сохранив рисунок). `dpifloat, optional` Значение dpi для вычисления рамки, по умолчанию `self.figure.dpi` (не dpi рендерера); следует установить, например, для соответствия областям с изображением фигуры, сохранённым с пользовательским значением dpi.

rendererRenderer, optional: Для вычисления рамки требуется рендерер. Если элемент уже нарисован, рендерер кэшируется; поэтому передавать этот аргумент необходимо только при вызове get_window_extent до первого draw. На практике обычно проще сначала вызвать отрисовку (например, сохранив рисунок).
dpifloat, optional: Значение dpi для вычисления рамки, по умолчанию self.figure.dpi (не dpi рендерера); следует установить, например, для соответствия областям с изображением фигуры, сохранённым с пользовательским значением dpi.

get_wrap(self) [source]: Возвращает состояние перевода текста.

static is_math_text(s, usetex=None) [source]: [Устарело] Возвращает очищенную строку и логический флаг. Флаг указывает, содержит ли данная строка s какой-либо текст математического форматирования, определяемый по количеству неуправляемых знаков доллара. Если текст математического форматирования отсутствует, очищенная строка имеет неуправляемые знаки доллара. Если usetex включен, флаг всегда имеет значение "TeX".

Примечания

Устарело начиная с версии 3.1.

set_backgroundcolor(self, color) [source]

Устанавливает цвет фона текста, обновляя рамку.

Параметры:	`colorcolor`

См. также

set_bbox: Изменение положения ограничивающей рамки

set_bbox(self, rectprops) [source]

Рисует ограничивающую рамку вокруг себя.

Параметры:	`rectpropsdict with properties for patches.FancyBboxPatch` По умолчанию стиль рамки 'квадрат'. Масштаб мутации `patches.FancyBboxPatch` устанавливается в размер шрифта.

Примеры

t.set_bbox(dict(facecolor='red', alpha=0.5))

set_c(self, color): Псевдоним для set_color.

set_clip_box(self, clipbox) [source]

Устанавливает ограничивающую рамку обрезки элемента.

Параметры:	`clipboxBbox`

set_clip_on(self, b) [source]

Устанавливает, использует ли элемент обрезку.

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

Параметры:	`bbool`

set_clip_path(self, path, transform=None) [source]

Устанавливает путь обрезки элемента.

Параметры:

Параметры:	`pathPatch or Path or TransformedPath or None` Путь обрезки. Если задан `Path`, transform должен быть предоставлен также. Если None, ранее установленный путь обрезки удаляется. `transformTransform, optional` Используется только если path является `Path`, в этом случае предоставленный `Path` преобразуется в `TransformedPath` с помощью transform.

pathPatch or Path or TransformedPath or None: Путь обрезки. Если задан Path, transform должен быть предоставлен также. Если None, ранее установленный путь обрезки удаляется.
transformTransform, optional: Используется только если path является Path, в этом случае предоставленный Path преобразуется в TransformedPath с помощью transform.

Примечания

Для повышения эффективности, если path является Rectangle, этот метод установит ограничивающую рамку обрезки соответствующему прямоугольнику и установит путь обрезки в None.

По техническим причинам (поддержка setp) также принимается кортеж (path, transform) в качестве единственного позиционного параметра.

set_color(self, color) [source]

Устанавливает цвет текста.

Параметры:	`colorcolor`

set_family(self, fontname): Псевдоним для set_fontfamily.

set_font_properties(self, fp): Псевдоним для set_fontproperties.

set_fontfamily(self, fontname) [source]

Установить семейство шрифтов. Может быть либо одна строка, либо список строк в порядке убывания приоритета. Каждая строка может быть либо реальным именем шрифта, либо общим именем класса шрифта. В последнем случае конкретные имена шрифтов будут найдены в соответствующих rcParams.

Если экземпляр Text создается с fontfamily=None, то шрифт устанавливается в rcParams["font.family"] (по умолчанию: ['sans-serif']), и то же самое происходит, когда set_fontfamily() вызывается для существующего экземпляра Text.

Параметры:	`fontname{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}`

См. также

font_manager.FontProperties.set_family

set_fontname(self, fontname) [source]

Псевдоним для set_family.

Односторонний псевдоним: геттер отличается.

Параметры:	`fontname{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}`

См. также

font_manager.FontProperties.set_family

set_fontproperties(self, fp) [source]

Установить свойства шрифта, которые управляют текстом.

Параметры:	`fpfont_manager.FontProperties`

set_fontsize(self, fontsize) [source]

Установить размер шрифта. Может быть либо строкой размера, относительно размера шрифта по умолчанию, либо абсолютным размером шрифта в пунктах.

Параметры:	`fontsize{size in points, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}`

См. также

font_manager.FontProperties.set_size

set_fontstretch(self, stretch) [source]

Установить растяжение шрифта (горизонтальное сжатие или расширение).

Параметры:	`stretch{a numeric value in range 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}`

См. также

font_manager.FontProperties.set_stretch

set_fontstyle(self, fontstyle) [source]

Установить стиль шрифта.

Параметры:	`fontstyle{'normal', 'italic', 'oblique'}`

См. также

font_manager.FontProperties.set_style

set_fontvariant(self, variant) [source]

Установить вариант шрифта, либо 'normal', либо 'small-caps'.

Параметры:	`variant{'normal', 'small-caps'}`

См. также

font_manager.FontProperties.set_variant

set_fontweight(self, weight) [source]

Установить жирность шрифта.

Параметры:	`weight{a numeric value in range 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}`

См. также

font_manager.FontProperties.set_weight

set_ha(self, align): Псевдоним для set_horizontalalignment.

set_horizontalalignment(self, align) [source]

Установить горизонтальное выравнивание на одно из

Параметры:	`align{'center', 'right', 'left'}`

set_linespacing(self, spacing) [source]

Установить межстрочный интервал как кратное значение размера шрифта. По умолчанию 1.2.

Параметры:	`spacingfloat (multiple of font size)`

set_ma(self, align): Псевдоним для set_multialignment.

set_multialignment(self, align) [source]

Установить выравнивание для многострочного макета. Макет ограничивающего прямоугольника всех строк определяется свойствами horizontalalignment и verticalalignment, но многострочный текст внутри этого прямоугольника может быть

Параметры:	`align{'left', 'right', 'center'}`

set_name(self, fontname): Псевдоним для set_fontname.

set_position(self, xy) [source]

Установить позицию (x, y) текста.

Параметры:	`xy(float, float)`

set_rotation(self, s) [source]

Установить угол поворота текста.

Параметры:	`s{angle in degrees, 'vertical', 'horizontal'}`

set_rotation_mode(self, m) [source]

Установить режим поворота текста.

Параметры:	`m{None, 'default', 'anchor'}` Если `None` или `"default"`, текст сначала повернётся, а затем выровняется в соответствии с горизонтальным и вертикальным выравниванием. Если `"anchor"`, выравнивание произойдёт до поворота.

set_size(self, fontsize): Псевдоним для set_fontsize.

set_stretch(self, stretch): Псевдоним для set_fontstretch.

set_style(self, fontstyle): Псевдоним для set_fontstyle.

set_text(self, s) [source]

Установить строку текста s.

Она может содержать новые строки (\n) или математические формулы в формате LaTeX.

Параметры:	`sobject` Любой объект преобразуется в его `str`, за исключением `None`, который становится `''`.

set_usetex(self, usetex) [source]

Параметры:	`usetexbool or None` Использовать TeX для рендеринга, `None` означает использование `rcParams["text.usetex"]` (по умолчанию: False).

set_va(self, align): Псевдоним для set_verticalalignment.

set_variant(self, variant): Псевдоним для set_fontvariant.

set_verticalalignment(self, align) [source]

Установить вертикальное выравнивание

Параметры:	`align{'center', 'top', 'bottom', 'baseline', 'center_baseline'}`

set_weight(self, weight): Псевдоним для set_fontweight.

set_wrap(self, wrap) [source]

Установить режим обрезки текста.

Параметры:	`wrapbool`

set_x(self, x) [source]

Установить x-позицию текста.

Параметры:	`xfloat`

set_y(self, y) [source]

Установить y-позицию текста.

Параметры:	`yfloat`

update(self, kwargs) [source]: Обновить свойства из словаря.

update_bbox_position_size(self, renderer) [source]

Обновить расположение и размер области.

Этот метод следует использовать, когда необходимо обновить расположение и размер области перед фактическим отображением области.

update_from(self, other) [source]: Копировать свойства из другого объекта в себя.

zorder = 3

class matplotlib.text.TextWithDash(**kwargs) [source]

Bases: matplotlib.text.Text

[Устаревший] Это в основном Text с тире (нарисованным с помощью Line2D) перед/после него. Он предназначен для прямого использования вместо Text и должен вести себя идентично ему, когда dashlength = 0.0.

Тире всегда находится между точкой, указанной set_position(), и текстом. Когда тире существует, аргументы выравнивания текста (horizontalalignment, verticalalignment) игнорируются.

dashlength — длина тире в единицах холста. (по умолчанию = 0.0).

dashdirection — одно из 0 или 1, где 0 рисует тире после текста, а 1 — перед. (по умолчанию = 0).

dashrotation задает поворот тире и, как правило, должен оставаться None. В этом случае get_dashrotation() возвращает get_rotation(). (т. е. тире принимает поворот от поворота текста). Поскольку центр текста проецируется на тире, большие отклонения в повороте приводят к тому, что результаты могут считаться визуально непривлекательными. (по умолчанию = None).

dashpad — длина отступа для добавления (или вычитания) расстояния между текстом и тире в единицах холста. (по умолчанию = 3).

dashpush «отодвигает» тире и текст от точки, указанной set_position(), на указанное количество единиц холста. (по умолчанию = 0).

Примечание

Выравнивание двух объектов основано на области объекта Text, полученной с помощью get_window_extent(). Это, в свою очередь, по-видимому, зависит от метрик шрифта, заданных ядром рендеринга. Следовательно, качество «центрирования» текста метки относительно тире зависит от используемого ядра.

Примечание

Я не уверен, что правильно понял get_window_extent(), или достаточно ли этого для предоставления области объекта.

Примечания

Устарело начиная с версии 3.1.

Создайте экземпляр Text в x, y со строкой text.

Допустимы следующие ключевые аргументы:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
`alpha`	число с плавающей точкой или None
`animated`	булево значение
`backgroundcolor`	цвет
`bbox`	словарь с свойствами для `patches.FancyBboxPatch`
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	вызываемый объект
`figure`	`Figure`
`fontfamily` или family	{имя шрифта, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
`fontproperties` или font_properties	`font_manager.FontProperties`
`fontsize` или size	{размер в пунктах, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
`fontstretch` или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
`fontstyle` или style	{'normal', 'italic', 'oblique'}
`fontvariant` или variant	{'normal', 'small-caps'}
`fontweight` или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
`gid`	строка
`horizontalalignment` или ha	{'center', 'right', 'left'}
`in_layout`	булево значение
`label`	объект
`linespacing`	число с плавающей точкой (кратное размеру шрифта)
`multialignment` или ma	{'left', 'right', 'center'}
`path_effects`	`AbstractPathEffect`
`picker`	None или булево значение или число с плавающей точкой или вызываемый объект
`position`	(число с плавающей точкой, число с плавающей точкой)
`rasterized`	булево значение или None
`rotation`	{угол в градусах, 'vertical', 'horizontal'}
`rotation_mode`	{None, 'default', 'anchor'}
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`text`	объект
`transform`	`Transform`
`url`	строка
`usetex`	булево значение или None
`verticalalignment` или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
`visible`	булево значение
`wrap`	булево значение
`x`	число с плавающей точкой
`y`	число с плавающей точкой
`zorder`	число с плавающей точкой

draw(self, renderer) [source]: Отображение объекта TextWithDash на заданном renderer.

get_dashdirection(self) [source]: Получить направление штрихов. 1 — перед текстом, 0 — после.

get_dashlength(self) [source]: Получить длину штриха.

get_dashpad(self) [source]: Получить дополнительное отступы между тире и текстом в единицах холста.

get_dashpush(self) [source]: Получить дополнительное отступы между тире и указанным положением текста в единицах холста.

get_dashrotation(self) [source]: Получить угол поворота тире в градусах.

get_figure(self) [source]: Возвращает экземпляр фигуры, к которому принадлежит объект.

get_position(self) [source]: Возвращает положение текста как кортеж (x, y)

get_prop_tup(self, renderer=None) [source]

Возвращает хешируемый кортеж свойств.

Не предназначен для чтения человеком, но полезен для бэкэндов, которые хотят кэшировать полученные данные о тексте (например, макеты) и должны знать, изменился ли текст.

get_unitless_position(self) [source]: Возвращает безразмерное положение текста как кортеж (x, y)

get_window_extent(self, renderer=None) [source]

Возвращает объект Bbox, определяющий область текста в единицах отображения.

Помимо внутреннего использования, это полезно для задания нажимаемых областей в файле png на веб-странице.

renderer по умолчанию имеет значение _renderer атрибута объекта текста. Он не присваивается до первого выполнения draw(), поэтому вы должны использовать этот аргумент, если хотите вызвать get_window_extent() до первого draw(). Для получения областей веб-страницы проще вызвать метод после сохранения фигуры.

set_dashdirection(self, dd) [source]

Устанавливает направление тире, следующего за текстом. 1 — перед текстом, 0 — после. По умолчанию 0, что нужно для типовых случаев, когда метки находятся ниже и слева от фигуры.

Параметры:	`ddint (1 is before, 0 is after)`

set_dashlength(self, dl) [source]

Устанавливает длину тире в единицах холста.

Параметры:	`dlfloat`

set_dashpad(self, dp) [source]

Устанавливает "отступ" TextWithDash, который представляет собой дополнительный отступ между тире и текстом в единицах холста.

Параметры:	`dpfloat`

set_dashpush(self, dp) [source]

Устанавливает "смещение" TextWithDash, которое представляет собой дополнительный отступ между началом тире и указанным положением.

Параметры:	`dpfloat`

set_dashrotation(self, dr) [source]

Устанавливает угол поворота тире в градусах.

Параметры:	`drfloat`

set_figure(self, fig) [source]

Устанавливает экземпляр фигуры, к которому принадлежит элемент.

Параметры:	`figFigure`

set_position(self, xy) [source]

Устанавливает положение (x, y) TextWithDash.

Параметры:	`xy(float, float)`

set_transform(self, t) [source]

Устанавливает экземпляр matplotlib.transforms.Transform, используемый данным элементом.

Параметры:	`tTransform`

set_x(self, x) [source]

Устанавливает положение x TextWithDash.

Параметры:	`xfloat`

set_y(self, y) [source]

Устанавливает положение y TextWithDash.

Параметры:	`yfloat`

update_coords(self, renderer) [source]: Вычисляет фактические координаты x, y для текста на основе входных x, y и dashlength. Поскольку поворот осуществляется относительно координат фактического холста, нам нужно переводить их туда и обратно.

matplotlib.text.get_rotation(rotation) [source]

Возвращает угол текста в градусах от 0 до 360.

rotation может быть 'горизонтально', 'вертикально' или числовым значением в градусах.