mpl_toolkits.mplot3d.art3d.Text3D

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

Bases: Text

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

Параметры:

x, y, zfloat

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

textstr

Строка текста для отображения.

zdir{'x', 'y', 'z', None, 3-tuple}

Направление текста. См. get_dir_vector для описания значений.

Другие параметры:

**kwargs

Все остальные параметры передаются в Text.

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

Текст выравнивается относительно точки привязки (x, y) в соответствии с horizontalalignment (по умолчанию: 'left') и verticalalignment (по умолчанию: 'bottom'). См. также Выравнивание текста.

Хотя Text принимает ключевое слово 'label', по умолчанию оно не добавляется в метки легенды.

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
animated	bool
backgroundcolor	цвет
bbox	словарь с свойствами для patches.FancyBboxPatch
clip_box	неизвестно
clip_on	неизвестно
clip_path	неизвестно
color или c	цвет
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	{'left', 'center', 'right'}
in_layout	bool
label	объект
linespacing	вещественное число (кратное размеру шрифта)
math_fontfamily	строка
mouseover	bool
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемая функция
position	(вещественное число, вещественное число)
rasterized	bool
rotation	вещественное число или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: вещественное число, length: вещественное число, randomness: вещественное число)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	строка
usetex	bool или None
verticalalignment или va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	вещественное число

y	вещественное число
zorder	вещественное число

draw(renderer)[source]

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

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

Параметры:

rendererRendererBase подкласс.

Примечания

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

get_position_3d()[source]

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

get_tightbbox(renderer=None)[source]

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

Параметры:

rendererRendererBase подкласс

рендер, который будет использоваться для отрисовки графиков (т.е. fig.canvas.get_renderer())

Возвращает:

Bbox

Охватывающая область (в пикселях координат рисунка).

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, backgroundcolor=<UNSET>, bbox=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, fontfamily=<UNSET>, fontproperties=<UNSET>, fontsize=<UNSET>, fontstretch=<UNSET>, fontstyle=<UNSET>, fontvariant=<UNSET>, fontweight=<UNSET>, gid=<UNSET>, horizontalalignment=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linespacing=<UNSET>, math_fontfamily=<UNSET>, mouseover=<UNSET>, multialignment=<UNSET>, parse_math=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, position_3d=<UNSET>, rasterized=<UNSET>, rotation=<UNSET>, rotation_mode=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, text=<UNSET>, transform=<UNSET>, transform_rotates_text=<UNSET>, url=<UNSET>, usetex=<UNSET>, verticalalignment=<UNSET>, visible=<UNSET>, wrap=<UNSET>, x=<UNSET>, y=<UNSET>, z=<UNSET>, zorder=<UNSET>)[source]

Установить несколько свойств одновременно.

Поддерживаемые свойства

Свойство	Описание
3d_properties	float
agg_filter	функция-фильтр, принимающая массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращающая массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
backgroundcolor	цвет
bbox	словарь с свойствами для patches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
color или c	цвет
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	str
horizontalalignment или ha	{'left', 'center', 'right'}
in_layout	bool
label	объект
linespacing	число с плавающей точкой (кратное размеру шрифта)
math_fontfamily	str
mouseover	bool
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемая функция
position	(число с плавающей точкой, число с плавающей точкой)
position_3d	(число с плавающей точкой, число с плавающей точкой, число с плавающей точкой)
rasterized	bool
rotation	число с плавающей точкой или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool или None
verticalalignment или va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible	bool
wrap	bool
x	float
y	float
z	float
zorder	float

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

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

Параметры:

zfloat

Положение z в трехмерном пространстве.

zdir{'x', 'y', 'z', 3-tuple}

Направление текста. Значение по умолчанию: 'z'. См. get_dir_vector для описания значений.

set_position_3d(xyz, zdir=None)[source]

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

Параметры:

xyz(float, float, float)

Положение в трехмерном пространстве.

zdir{'x', 'y', 'z', None, 3-tuple}

Направление текста. Если не указано, zdir не будет изменён. См. get_dir_vector для описания значений.

set_z(z)[source]

Установить положение z текста.

Параметры:

zfloat