mpl_toolkits.mplot3d.art3d.Text3D

class mpl_toolkits.mplot3d.art3d.Text3D(x=0, y=0, z=0, text='', zdir='z', axlim_clip=False, **kwargs)

Bases: Text

Textobjekt mit 3D-Position und -Richtung.

Parameter:

x, y, zfloat

Die Position des Textes.

textstr

Der anzuzeigende Textstring.

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

Die Richtung des Textes. Siehe get_dir_vector für eine Beschreibung der Werte.

axlim_clipbool, Standard: False

Ob Text außerhalb der Achsenansichtslimits ausgeblendet werden soll.

Andere Parameter:

**kwargs

Alle anderen Parameter werden an Text weitergegeben.

Erstellt eine Text-Instanz an x, y mit dem String text.

Der Text wird relativ zum Ankerpunkt (x, y) ausgerichtet gemäß horizontalalignment (Standard: 'left') und verticalalignment (Standard: 'baseline'). Siehe auch Textausrichtung.

Obwohl Text das Schlüsselwortargument 'label' akzeptiert, wird es standardmäßig nicht zu den Handles einer Legende hinzugefügt.

Gültige Schlüsselwortargumente sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder None
animated	bool
antialiased	bool
backgroundcolor	color
bbox	dict mit Eigenschaften für patches.FancyBboxPatch
clip_box	unknown
clip_on	unknown
clip_path	unknown
color oder c	color
figure	Figure oder SubFigure
fontfamily oder family oder fontname	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties oder font oder font_properties	font_manager.FontProperties oder str oder pathlib.Path
fontsize oder size	float oder {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch oder stretch	{ein numerischer Wert im Bereich 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle oder style	{'normal', 'italic', 'oblique'}
fontvariant oder variant	{'normal', 'small-caps'}
fontweight oder weight	{ein numerischer Wert im Bereich 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	str
horizontalalignment oder ha	{'left', 'center', 'right'}
in_layout	bool
label	object
linespacing	float (Vielfaches der Schriftgröße)
math_fontfamily	str
mouseover	bool
multialignment oder ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	(float, float)
rasterized	bool
rotation	float oder {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
text	object
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool, Standard: rcParams["text.usetex"] (Standard: False)
verticalalignment oder va	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	float
y	float
zorder	float

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

get_position_3d()

Gibt die (x, y, z)-Position des Textes zurück.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber mit Berücksichtigung von Clipping.

Parameter:

rendererRendererBase Unterklasse, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
3d_properties	float
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder None
animated	bool
antialiased	bool
backgroundcolor	color
bbox	dict mit Eigenschaften für patches.FancyBboxPatch
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color oder c	color
figure	Figure oder SubFigure
fontfamily oder family oder fontname	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties oder font oder font_properties	font_manager.FontProperties oder str oder pathlib.Path
fontsize oder size	float oder {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch oder stretch	{ein numerischer Wert im Bereich 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle oder style	{'normal', 'italic', 'oblique'}
fontvariant oder variant	{'normal', 'small-caps'}
fontweight oder weight	{ein numerischer Wert im Bereich 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	str
horizontalalignment oder ha	{'left', 'center', 'right'}
in_layout	bool
label	object
linespacing	float (Vielfaches der Schriftgröße)
math_fontfamily	str
mouseover	bool
multialignment oder ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	(float, float)
position_3d	(float, float, float)
rasterized	bool
rotation	float oder {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
text	object
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool, Standard: rcParams["text.usetex"] (Standard: False)
verticalalignment oder va	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	float
y	float
z	float
zorder	float

set_3d_properties(z=0, zdir='z', axlim_clip=False)

Legt die z-Position und die Richtung des Textes fest.

Parameter:

zfloat

Die z-Position im 3D-Raum.

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

Die Richtung des Textes. Standard: 'z'. Siehe get_dir_vector für eine Beschreibung der Werte.

axlim_clipbool, Standard: False

Ob Text außerhalb der Achsenansichtslimits ausgeblendet werden soll.

set_position_3d(xyz, zdir=None)

Legt die (x, y, z)-Position des Textes fest.

Parameter:

xyz(float, float, float)

Die Position im 3D-Raum.

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

Die Richtung des Textes. Wenn nicht angegeben, wird zdir nicht geändert. Siehe get_dir_vector für eine Beschreibung der Werte.

set_z(z)

Legt die z-Position des Textes fest.

Parameter:

zfloat