mpl_toolkits.mplot3d.art3d.Text3D

class mpl_toolkits.mplot3d.art3d.Text3D(x=0, y=0, z=0, text='', zdir='z', **kwargs)[source]

Bases: matplotlib.text.Text

Объект текста с 3D позицией и направлением.

Параметры:	x, y, z Позиция текста. textstr Строка текста для отображения. zdir{'x', 'y', 'z', None, 3-tuple} Направление текста. См. get_dir_vector для описания значений.
Другие параметры:	**kwargs Все остальные параметры передаются объекту Text.

Создаёт экземпляр 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 или font_properties	font_manager.FontProperties или str или pathlib.Path
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	число с плавающей точкой (кратное размеру шрифта)
math_fontfamily	строка
multialignment или ma	{'left', 'right', 'center'}
path_effects	AbstractPathEffect
picker	None или булево значение или число с плавающей точкой или вызываемая функция
position	(число с плавающей точкой, число с плавающей точкой)
rasterized	булево значение
rotation	число с плавающей точкой или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	булево значение или None
text	объект
transform	Transform
transform_rotates_text	булево значение
url	строка
usetex	булево значение или None
verticalalignment или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible	булево значение
wrap	булево значение
x	число с плавающей точкой
y	число с плавающей точкой
zorder	число с плавающей точкой

__init__(x=0, y=0, z=0, text='', zdir='z', **kwargs)[source]

Создайте экземпляр 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 или font_properties	font_manager.FontProperties или str или pathlib.Path
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	число (кратное размеру шрифта)
math_fontfamily	строка
multialignment или ma	{'left', 'right', 'center'}
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемый объект
position	(число, число)
rasterized	булево значение
rotation	число или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: число, length: число, randomness: число)
snap	булево значение или None
text	объект
transform	Transform
transform_rotates_text	булево значение
url	строка
usetex	булево значение или None
verticalalignment или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible	булево значение
wrap	булево значение
x	число с плавающей точкой
y	число с плавающей точкой
zorder	число с плавающей точкой

__module__ = 'mpl_toolkits.mplot3d.art3d'

draw(renderer)[source]

Отобразить элемент (и его дочерние элементы) с помощью заданного рендерера.

Это не оказывает никакого влияния, если элемент не виден (Artist.get_visible возвращает False).

Параметры:	rendererRendererBase подкласс.

Примечания

Этот метод переопределяется в подклассах элемента.

get_position_3d()[source]

Возвращает (x, y, z) координаты текста.

get_tightbbox(renderer)[source]

Подобно Artist.get_window_extent, но включает любые обрезки.

Параметры:	rendererRendererBase подкласс рендерер, который будет использоваться для отрисовки графиков (т.е. fig.canvas.get_renderer())
Возвращает:	Bbox Охватывающая область (в пикселях координат фигуры).

set_3d_properties(z=0, zdir='z')[source]

set_position_3d(xyz, zdir=None)[source]

Установить (x, y, z) координаты текста.

Параметры:	xyz(float, float, float) Позиция в 3D пространстве. zdir{'x', 'y', 'z', None, 3-tuple} Направление текста. Если не указано, zdir не будет изменён.

set_z(z)[source]

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

Параметры:	zfloat

Примеры использования mpl_toolkits.mplot3d.art3d.Text3D