matplotlib.patches.FancyBboxPatch

class matplotlib.patches.FancyBboxPatch(xy, width, height, boxstyle='round', *, mutation_scale=1, mutation_aspect=1, **kwargs)

Bases: Patch

Eine ausgefallene Box um ein Rechteck mit der unteren linken Ecke bei xy = (x, y) mit angegebener Breite und Höhe.

FancyBboxPatch ist ähnlich wie Rectangle, aber es zeichnet eine ausgefallene Box um das Rechteck. Die Transformation der Rechteckbox in die ausgefallene Box wird an die in BoxStyle definierten Stilklassen delegiert.

Parameter:

xy(float, float)

Die untere linke Ecke der Box.

widthfloat

Die Breite der Box.

heightfloat

Die Höhe der Box.

boxstylestr oder BoxStyle

Der Stil der ausgefallenen Box. Dies kann entweder eine BoxStyle-Instanz oder ein String mit dem Stilnamen und optional durch Kommas getrennten Attributen sein (z. B. "Round, pad=0.2"). Dieser String wird an BoxStyle übergeben, um ein BoxStyle-Objekt zu erstellen. Siehe dort für eine vollständige Dokumentation.

Die folgenden Box-Stile sind verfügbar

Klasse	Name	Parameter
Square	square	pad=0.3
Circle	circle	pad=0.3
Ellipse	ellipse	pad=0.3
LArrow	larrow	pad=0.3
RArrow	rarrow	pad=0.3
DArrow	darrow	pad=0.3
Round	round	pad=0.3, rounding_size=None
Round4	round4	pad=0.3, rounding_size=None
Sawtooth	sawtooth	pad=0.3, tooth_size=None
Roundtooth	roundtooth	pad=0.3, tooth_size=None

mutation_scalefloat, Standard: 1

Skalierungsfaktor, der auf die Attribute des Box-Stils angewendet wird (z. B. pad oder rounding_size).

mutation_aspectfloat, Standard: 1

Die Höhe des Rechtecks wird vor der Mutation mit diesem Wert gestaucht und die mutierte Box wird mit dem Inversen davon gestreckt. Dies ermöglicht beispielsweise unterschiedliche horizontale und vertikale Abstände.

Andere Parameter:

**kwargsPatch Eigenschaften

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	unknown
animated	bool
antialiased oder aa	bool oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
edgecolor oder ec	Farbe oder None
facecolor oder fc	Farbe oder None
figure	Figure oder SubFigure
füllen	bool
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth oder lw	float oder None
mouseover	bool
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

get_bbox()

Gibt die Bbox zurück.

get_boxstyle()

Gibt das Boxstyle-Objekt zurück.

get_height()

Gibt die Höhe des Rechtecks zurück.

get_mutation_aspect()

Gibt das Seitenverhältnis der Bbox-Mutation zurück.

get_mutation_scale()

Gibt die Mutationsskalierung zurück.

get_path()

Gibt den mutierten Pfad des Rechtecks zurück.

get_width()

Gibt die Breite des Rechtecks zurück.

get_x()

Gibt die linke Koordinate des Rechtecks zurück.

get_y()

Gibt die untere Koordinate des Rechtecks zurück.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, bounds=<UNSET>, boxstyle=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, height=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, mutation_aspect=<UNSET>, mutation_scale=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, width=<UNSET>, x=<UNSET>, y=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften 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 oder aa	bool oder None
Grenzen	unknown
boxstyle	[ 'square' | 'circle' | 'ellipse' | 'larrow' | 'rarrow' | 'darrow' | 'round' | 'round4' | 'sawtooth' | 'roundtooth' ]
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
edgecolor oder ec	Farbe oder None
facecolor oder fc	Farbe oder None
figure	Figure oder SubFigure
füllen	bool
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
Höhe	float
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth oder lw	float oder None
mouseover	bool
mutation_aspect	float
mutation_scale	float
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
width	float
x	float
y	float
zorder	float

set_bounds(*args)

Setzt die Grenzen des Rechtecks.

Aufrufsignaturen

set_bounds(left, bottom, width, height)
set_bounds((left, bottom, width, height))

Parameter:

left, bottomfloat

Die Koordinaten der unteren linken Ecke des Rechtecks.

width, heightfloat

Die Breite/Höhe des Rechtecks.

set_boxstyle(boxstyle=None, **kwargs)

Setzt den Box-Stil, möglicherweise mit weiteren Attributen.

Attribute des vorherigen Box-Stils werden nicht wiederverwendet.

Ohne Argument (oder mit boxstyle=None) werden die verfügbaren Box-Stile als menschenlesbarer String zurückgegeben.

Parameter:

boxstylestr oder BoxStyle

Der Stil der Box: entweder eine BoxStyle-Instanz oder ein String, der der Stilname und optional durch Kommas getrennte Attribute sind (z. B. "Round,pad=0.2"). Ein solcher String wird verwendet, um ein BoxStyle-Objekt zu erstellen, wie in dieser Klasse dokumentiert.

Die folgenden Box-Stile sind verfügbar

Klasse	Name	Parameter
Square	square	pad=0.3
Circle	circle	pad=0.3
Ellipse	ellipse	pad=0.3
LArrow	larrow	pad=0.3
RArrow	rarrow	pad=0.3
DArrow	darrow	pad=0.3
Round	round	pad=0.3, rounding_size=None
Round4	round4	pad=0.3, rounding_size=None
Sawtooth	sawtooth	pad=0.3, tooth_size=None
Roundtooth	roundtooth	pad=0.3, tooth_size=None

**kwargs

Zusätzliche Attribute für den Box-Stil. Siehe die obige Tabelle für unterstützte Parameter.

Beispiele

set_boxstyle("Round,pad=0.2")
set_boxstyle("round", pad=0.2)

set_height(h)

Setzt die Rechteckhöhe.

Parameter:

hfloat

set_mutation_aspect(aspect)

Setzt das Seitenverhältnis der Bbox-Mutation.

Parameter:

aspectfloat

set_mutation_scale(scale)

Setzt die Mutationsskalierung.

Parameter:

scalefloat

set_width(w)

Setzt die Rechteckbreite.

Parameter:

wfloat

set_x(x)

Setzt die linke Koordinate des Rechtecks.

Parameter:

xfloat

set_y(y)

Setzt die untere Koordinate des Rechtecks.

Parameter:

yfloat

Beispiele für die Verwendung von matplotlib.patches.FancyBboxPatch

Referenz für Matplotlib-Künstler

Referenz für Matplotlib-Künstler

Zeichnen von schicken Boxen

Zeichnen von schicken Boxen