matplotlib.text
Классы для включения текста в график.
-
class matplotlib.text.Annotation(text, xy, xytext=None, xycoords='data', textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)[source] -
Bases:
matplotlib.text.Text,matplotlib.text._AnnotationBaseАннотация — это
Text, которая может ссылаться на конкретную позицию xy. Дополнительно может быть нарисован стрелка, направленная от текста к xy.Атрибуты: - xy
-
Аннотированная позиция.
- xycoords
-
Система координат для xy.
- arrow_patch
-
A
FancyArrowPatchдля указания направления от xytext к xy.
Аннотация точки xy текстом text.
В самом простом виде текст размещается в точке xy.
Дополнительно текст можно отобразить в другой позиции xytext. Тогда можно добавить стрелку, направленную от текста к аннотированной точке xy, определив arrowprops.
Параметры: -
text : str -
Текст аннотации. s — устаревший синоним этого параметра.
-
xy : (float, float) -
Точка (x,y), которую нужно аннотировать.
-
xytext : (float, float), optional -
Позиция (x,y) для размещения текста. Если None, по умолчанию используется xy.
-
xycoords : str, 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'.
-
-
textcoords : str, Artist, Transform, callable or tuple, optional -
Система координат, в которой задано значение xytext.
Применимы все значения xycoords, а также следующие строки:
Значение Описание 'offset points' Смещение (в пунктах) от значения xy 'offset pixels' Смещение (в пикселях) от значения xy По умолчанию — значение xycoords, т.е. используется та же система координат для точки аннотации и позиции текста.
-
arrowprops : dict, 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_clip : bool or None, optional -
Определяет, нужно ли рисовать аннотацию, когда точка аннотации xy находится за пределами области графика.
- Если True, аннотация рисуется только при xy внутри области графика.
- Если False, аннотация всегда рисуется.
- Если None, аннотация рисуется только при xy внутри области графика и xycoords — 'data'.
По умолчанию — None.
- **kwargs
-
Дополнительные kwargs передаются объекту
Text.
Возвращает: -
annotation : Annotation
См. также
-
anncoords -
Система координат для
Annotation.xyann.
-
arrow -
[Устарело]
Примечания
Устарело начиная с версии 3.0: arrow устарел в Matplotlib 3.0 и будет удален в 3.2. Используйте arrow_patch вместо него.
-
contains(self, event)[source] -
Проверить, произошёл ли сдвиг мыши внутри области.
В случае с текстом, попадание считается истинным в любой точке внутри прямоугольника, содержащего текст, выровненного по осям.
Возвращает: -
bool : bool
-
-
draw(self, renderer)[source] -
Отобразить объект
Annotationв заданном renderer.
-
get_anncoords(self) -
Возвращает систему координат для использования с
Annotation.xyann.См. также xycoords в
Annotation.
-
get_window_extent(self, renderer=None)[source] -
Возвращает
Bboxпрямоугольник, содержащий текст и стрелку, в единицах отображения.Параметры: -
renderer : Renderer, optional -
Для вычисления прямоугольника необходимо значение рендерера. Если элемент уже отрисован, рендерер кэшируется; следовательно, передавать этот аргумент необходимо только при вызове
get_window_extentдо первого вызоваdraw. На практике обычно легче сначала вызвать отрисовку (например, сохранив изображение).
-
-
set_anncoords(self, coords) -
Установить систему координат для использования с
Annotation.xyann.См. также xycoords в
Annotation.
-
set_figure(self, fig)[source] -
Установить экземпляр
Figure, к которому принадлежит элемент.Параметры: -
fig : Figure
-
-
update_positions(self, renderer)[source] -
Обновить пиксельные координаты аннотированной точки и текста.
-
xyann -
Положение текста.
См. также xytext в
Annotation.
-
-
class matplotlib.text.OffsetFrom(artist, ref_coord, unit='points')[source] -
Базовый класс:
objectВспомогательный вызываемый класс для работы с
AnnotationПараметры: -
artist : Artist, BboxBase, or Transform -
Объект, от которого будет вычисляться смещение.
-
ref_coord : length 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) alphafloat animatedbool backgroundcolorцвет bboxсловарь свойств для patches.FancyBboxPatchclip_boxBboxclip_onbool clip_path[( Path,Transform) |Patch| None]colorили cцвет containsвызываемый объект figureFigurefontfamilyили family{НАИМЕНОВАНИЕ_ШРИФТА, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} fontpropertiesили font_propertiesfont_manager.FontPropertiesfontsizeили 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_layoutbool labelобъект linespacingfloat (кратное размеру шрифта) multialignmentили ma{'left', 'right', 'center'} path_effectsAbstractPathEffectpickerNone или bool или float или вызываемый объект position(float, float) rasterizedbool или None rotation{угол в градусах, 'vertical', 'horizontal'} rotation_mode{None, 'default', 'anchor'} sketch_params(scale: float, length: float, randomness: float) snapbool или None textобъект transformTransformurlстрока usetexbool или None verticalalignmentили va{'center', 'top', 'bottom', 'baseline', 'center_baseline'} visiblebool wrapbool xfloat yfloat zorderfloat
-
contains(self, mouseevent)[source] -
Проверить, произошёл ли событие мыши внутри области.
В случае с текстом попадание считается истинным в любом месте прямоугольника, содержащего текст.
Возвращает: -
bool : bool
-
-
draw(self, renderer)[source] -
Отображает объект
Textв заданном рендерере.
-
get_bbox_patch(self)[source] -
Возвращает область-патч, или None, если
patches.FancyBboxPatchне создан.
-
get_c(self) -
Псевдоним для
get_color.
-
get_color(self)[source] -
Возвращает цвет текста.
-
get_family(self) -
Псевдоним для
get_fontfamily.
-
get_font_properties(self) -
Псевдоним для
get_fontproperties.
-
get_fontfamily(self)[source] -
Возвращает список начертаний шрифта для поиска.
См. также
-
get_fontname(self)[source] -
Возвращает имя шрифта в виде строки.
См. также
-
get_fontproperties(self)[source] -
Возвращает объект
font_manager.FontProperties.
-
get_fontsize(self)[source] -
Возвращает размер шрифта как целое число.
-
get_fontstyle(self)[source] -
Возвращает стиль шрифта в виде строки.
См. также
-
get_fontvariant(self)[source] -
Возвращает вариант шрифта в виде строки.
См. также
-
get_fontweight(self)[source] -
Получить вес шрифта в виде строки или числа.
См. также
-
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] -
Получить растяжение шрифта в виде строки или числа.
См. также
-
get_style(self) -
Псевдоним для
get_fontstyle.
-
get_text(self)[source] -
Получить текст в виде строки.
-
get_unitless_position(self)[source] -
Возвращает бесразмерную позицию текста в виде кортежа (x, y).
-
-
get_usetex(self)[source] -
Возвращает значение, указывающее, использует ли этот объект
TextTeX для рендеринга.
-
get_va(self) -
Псевдоним для
get_verticalalignment.
-
get_variant(self) -
Псевдоним для
get_fontvariant.
-
get_verticalalignment(self)[source] -
Возвращает вертикальное выравнивание в виде строки. Будет одним из 'top', 'center', 'bottom' или 'baseline'.
-
get_weight(self) -
Псевдоним для
get_fontweight.
-
get_window_extent(self, renderer=None, dpi=None)[source] -
Возвращает
Bboxпрямоугольник, ограничивающий текст, в единицах отображения.Помимо внутреннего использования, это полезно для определения нажаемых областей в файле png на веб-странице.
Параметры: -
renderer : Renderer, optional -
Для вычисления ограничивающей рамки необходим рендерер. Если элемент уже нарисован, рендерер кэшируется; поэтому этот аргумент необходимо передавать только при вызове
get_window_extentдо первого вызоваdraw. На практике обычно проще сначала вызвать отрисовку (например, сохранив рисунок). -
dpi : float, 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] -
Устанавливает цвет фона текста, обновляя ограничивающую рамку.
Параметры: -
color : color
См. также
-
set_bbox - Для изменения положения ограничивающей рамки
-
-
set_bbox(self, rectprops)[source] -
Рисует ограничивающую рамку вокруг себя.
Параметры: -
rectprops : dict with properties for patches.FancyBboxPatch -
По умолчанию стиль рамки 'square'. Масштаб мутации
patches.FancyBboxPatchустанавливается на значение размера шрифта.
Примеры
t.set_bbox(dict(facecolor='red', alpha=0.5))
-
-
set_c(self, color) -
Псевдоним для
set_color.
-
set_clip_box(self, clipbox)[source] -
Устанавливает ограничивающую рамку обрезки элемента.
Параметры: -
clipbox : Bbox
-
-
set_clip_on(self, b)[source] -
Устанавливает, использует ли элемент обрезку.
Если False, элементы будут видны за пределами осей, что может привести к неожиданным результатам.
Параметры: -
b : bool
-
-
set_clip_path(self, path, transform=None)[source] -
Устанавливает путь обрезки элемента, который может быть:
- экземпляр
Patch(или подкласс); или - экземпляр
Path, в этом случае экземплярTransform, который будет применен к пути перед использованием его для обрезки, должен быть предоставлен; или -
None, чтобы удалить ранее установленный путь обрезки.
Для повышения эффективности, если путь оказывается прямоугольником с выравниванием по осям, этот метод установит ограничивающую рамку обрезки соответствующему прямоугольнику и установит путь обрезки в
None. - экземпляр
-
set_color(self, color)[source] -
Устанавливает цвет текста
Параметры: -
color : color
-
-
set_family(self, fontname) -
Псевдоним для
set_fontfamily.
-
set_font_properties(self, fp) -
Псевдоним для
set_fontproperties.
-
-
set_fontfamily(self, fontname)[source] -
Установите семейство шрифтов. Может быть одной строкой или списком строк в порядке убывания приоритета. Каждая строка может быть именем реального шрифта или общим именем класса шрифта. Если это последнее, конкретные имена шрифтов будут найдены в соответствующих параметрах rc.
Если экземпляр
Textсоздан сfontfamily=None, то шрифт устанавливается вrcParams["font.family"], и то же самое происходит при вызовеset_fontfamily()на существующем экземпляреText.Параметры: -
fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
См. также
-
-
set_fontname(self, fontname)[source] -
Псевдоним для
set_family.Только однонаправленный псевдоним: поведение при чтении отличается.
Параметры: -
fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
См. также
-
-
set_fontproperties(self, fp)[source] -
Установите свойства шрифта, которые контролируют текст.
Параметры: -
fp : font_manager.FontProperties
-
-
set_fontsize(self, fontsize)[source] -
Установите размер шрифта. Может быть строкой размера, относительной к размеру стандартного шрифта, или абсолютным размером шрифта в пунктах.
Параметры: -
fontsize : {size in points, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
См. также
-
-
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'}
См. также
-
-
set_fontstyle(self, fontstyle)[source] -
Установите стиль шрифта.
Параметры: -
fontstyle : {'normal', 'italic', 'oblique'}
См. также
-
-
set_fontvariant(self, variant)[source] -
Установите вариант шрифта, либо 'normal', либо 'small-caps'.
Параметры: -
variant : {'normal', 'small-caps'}
См. также
-
-
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'}
См. также
-
-
set_ha(self, align) -
Псевдоним для
set_horizontalalignment.
-
set_horizontalalignment(self, align)[source] -
Установите выравнивание по горизонтали к одному из
Параметры: -
align : {'center', 'right', 'left'}
-
-
set_linespacing(self, spacing)[source] -
Установите интервал между строками как кратное размеру шрифта. По умолчанию 1.2.
Параметры: -
spacing : float (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.Параметры: -
s : object -
Любой объект преобразуется в его
str, за исключениемNone, который становится''.
-
-
set_usetex(self, usetex)[source] -
Параметры: -
usetex : bool or None -
Определяет, использовать ли TeX для отображения,
Noneозначает использованиеrcParams["text.usetex"].
-
-
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] -
Установить состояние обрезки текста.
Параметры: -
wrap : bool
-
-
set_x(self, x)[source] -
Установить положение по оси x текста.
Параметры: -
x : float
-
-
set_y(self, y)[source] -
Установить положение по оси y текста.
Параметры: -
y : float
-
-
update(self, kwargs)[source] -
Обновить свойства из словаря.
-
update_bbox_position_size(self, renderer)[source] -
Обновить положение и размер области.
Этот метод следует использовать, когда необходимо обновить положение и размер области перед фактическим отрисовкой.
-
update_from(self, other)[source] -
Копировать свойства из other в self.
-
zorder = 3
-
-
class matplotlib.text.TextWithDash(**kwargs)[source] -
Базовые классы:
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.
-
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, что подходит для типичного случая меток под и слева от фигуры.
Параметры: -
dd : int (1 is before, 0 is after)
-
-
set_dashlength(self, dl)[source] -
Установить длину дефиса в единицах канвы.
Параметры: -
dl : float
-
-
set_dashpad(self, dp)[source] -
Установить «отступ» объекта TextWithDash, который представляет собой дополнительное расстояние между дефисом и текстом в единицах канвы.
Параметры: -
dp : float
-
-
set_dashpush(self, dp)[source] -
Установить «сдвиг» объекта TextWithDash, который представляет собой дополнительное расстояние между началом дефиса и заданной позицией.
Параметры: -
dp : float
-
-
-
set_dashrotation(self, dr)[source] -
Установить угол поворота штриховки в градусах.
Параметры: -
dr : float
-
-
set_figure(self, fig)[source] -
Установить экземпляр фигуры, к которому принадлежит объект.
Параметры: -
fig : matplotlib.figure.Figure
-
-
set_position(self, xy)[source] -
Установить координаты (x, y)
TextWithDash.Параметры: -
xy : (float, float)
-
-
set_transform(self, t)[source] -
Установить экземпляр
matplotlib.transforms.Transform, используемый этим объектом.Параметры: -
t : matplotlib.transforms.Transform
-
-
set_x(self, x)[source] -
Установить координату x
TextWithDash.Параметры: -
x : float
-
-
set_y(self, y)[source] -
Установить координату y
TextWithDash.Параметры: -
y : float
-
-
update_coords(self, renderer)[source] -
Вычисляет фактические координаты x, y для текста на основе входных x, y и dashlength. Поскольку поворот производится относительно координат реального холста, нам нужно переводить туда и обратно.
-
-
matplotlib.text.get_rotation(rotation)[source] -
Возвращает угол текста в градусах, значение в диапазоне от 0 до 360.
rotation может быть 'horizontal', 'vertical' или числовым значением в градусах.
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.1.1/api/text_api.html