figure

Erstellen von Abbildungsfenstern

Syntax

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

Beschreibung

figure erstellt ein neues Abbildungsfenster mit Standardwerten für die Eigenschaften. Die resultierende Abbildung ist die aktuelle Abbildung.

figure(Name,Value) ändert die Eigenschaften der Abbildung mithilfe eines oder mehrerer Name-Wert-Paar-Argumente. figure('Color','white') setzt beispielsweise die Hintergrundfarbe auf weiß.

f = figure(___) gibt das Figure-Objekt zurück. Verwenden Sie f, um die Eigenschaften der Abbildung nach der Erstellung abzufragen oder zu modifizieren.

figure(f) legt die von f angegebene Abbildung als aktuelle Abbildung fest und zeigt sie über allen anderen Abbildungen an.

figure(n) sucht eine Abbildung, bei der die Eigenschaft Number gleich n ist und legt sie als aktuelle Abbildung fest. Wenn keine Abbildung mit diesem Eigenschaftswert existiert, erstellt MATLAB^® eine neue Abbildung und setzt deren Eigenschaft Number auf n.

Beispiele

Ändern der Abbildungsgröße

Erstellen Sie eine Standardabbildung. Diese Abbildung erscheint als Registerkarte in einem Abbildungscontainer.

f = figure;

Rufen Sie die Stelle, Breite und Höhe der Abbildung ab.

f.Position

ans =

    1    1    1070    620

Dies bedeutet, dass die linke untere Ecke der Abbildung neben der Ecke des Abbildungscontainers positioniert ist und die Abbildung 1070 Pixel breit mal 620 Pixel hoch ist.

Sie können die Größe des Abbildungscontainers interaktiv ändern. Alternativ können Sie die Abbildungsgröße angeben, indem Sie die Eigenschaft Position festlegen, wodurch die Abbildung vom Abbildungscontainer abgedockt wird. Positionieren Sie beispielsweise die Abbildung 100 Pixel rechts und 200 Pixel über der unteren linken Ecke der primären Anzeige und legen Sie ihre Größe auf 500 Pixel Breite und 300 Pixel Höhe fest.

f.Position = [100 200 500 300];

Angeben eines Abbildungstitels

Erstellen Sie eine Abbildung und geben Sie die Eigenschaft Name an. Standardmäßig umfasst der resultierende Titel die Abbildungsnummer.

figure(Name="Measured Data");

Geben Sie die Eigenschaft Name erneut an, setzen Sie diesmal jedoch die Eigenschaft NumberTitle auf "off". Der resultierende Titel umfasst diesmal nicht die Nummer der Abbildung.

figure(Name="Measured Data",NumberTitle="off");

Simultanes Arbeiten mit mehreren Abbildungen

Erstellen Sie zwei Abbildungen und daraufhin ein Liniendiagramm. Die Abbildungen werden in einem Abbildungscontainer als Registerkarten angezeigt. Standardmäßig gilt der Befehl plot für die aktuelle Abbildung.

f1 = figure;
f2 = figure;
plot([1 2 3],[2 4 6]);

Setzen Sie die aktuelle Abbildung auf f1, sodass diese das Ziel für das nächste Diagramm ist. Erstellen Sie daraufhin ein Streudiagramm.

figure(f1);
scatter((1:20),rand(1,20));

Eingabeargumente

f — Zielabbildung

Figure-Objekt

Zielabbildung, angegeben als Figure-Objekt.

n — Nummer der Zielabbildung

Skalar-Ganzzahlwert

Nummer der Zielabbildung, angegeben als Skalar-Ganzzahlwert. Wenn Sie dieses Argument angeben, sucht MATLAB eine bestehende Abbildung, deren Eigenschaft Number gleich n ist. Wenn keine Abbildung mit diesem Eigenschaftswert existiert, erstellt MATLAB eine neue Abbildung und setzt deren Eigenschaft Number auf n. Standardmäßig wird die Eigenschaft Number im Titel der Abbildung angezeigt.

Datentypen: double

Name-Wert-Argumente

Geben Sie optionale Argumentpaare als Name1=Value1,...,NameN=ValueN an, wobei Name der Name des Arguments und Value der entsprechende Wert ist. Name-Wert-Argumente müssen nach anderen Argumenten angezeigt werden. Die Reihenfolge der Paare spielt jedoch keine Rolle.

Beispiel: figure(Color="white") erstellt eine Abbildung mit weißem Hintergrund.

In Releases vor R2021a verwenden Sie Kommas, um die einzelnen Namen und Werte zu trennen, und schließen Sie Name in Anführungszeichen ein.

Beispiel: figure("Color","white") erstellt eine Abbildung mit weißem Hintergrund.

Hinweis

Die hier aufgeführten Eigenschaften sind lediglich eine Teilmenge. Eine vollständige Liste finden Sie unter Figure.

Name — Name

'' (Standardeinstellung) | Zeichenvektor | Zeichenfolgenskalar

Name der Abbildung, angegeben als Zeichenvektor oder Zeichenfolgenskalar.

Beispiel: figure('Name','Results') setzt den Namen der Abbildung auf 'Results'.

Standardmäßig ist der Name 'Figure n', wobei n eine Ganzzahl ist. Wenn Sie die Eigenschaft Name angeben, wird der Titel der Abbildung auf 'Figure n: name' gesetzt. Wenn nur der Wert von Name erscheinen soll, setzen Sie IntegerHandle oder NumberTitle auf 'off'.

Color — Hintergrundfarbe

RGB-Tripel | hexadezimaler Farbcode | 'r' | 'g' | 'b' | ...

Hintergrundfarbe, angegeben als RGB-Tripel, hexadezimaler Farbcode, Farbname oder Kurzname. Wenn Sie 'none' angeben, erscheint die Hintergrundfarbe auf dem Bildschirm schwarz. Wenn Sie die Abbildung ausdrucken, wird der Hintergrund so gedruckt, als wäre das Abbildungsfenster transparent.

Für eine benutzerdefinierte Farbe geben Sie ein RGB-Tripel oder einen hexadezimalen Farbcode an.

• Ein RGB-Tripel ist ein aus drei Elementen bestehender Zeilenvektor, dessen Elemente die Intensitäten der Rot-, Grün- und Blaukomponenten der Farbe angeben. Die Intensitäten müssen im Bereich [0,1] liegen, z. B. [0.4 0.6 0.7].

• Ein hexadezimaler Farbcode ist ein Zeichenfolgenskalar oder Zeichenvektor, der mit einem Rautezeichen (#) beginnt, auf das drei oder sechs hexadezimale Ziffern folgen, die von 0 bis F reichen können. Bei den Werten wird nicht zwischen Groß- und Kleinbuchstaben unterschieden. Daher sind die Farbcodes "#FF8800", "#ff8800", "#F80" und "#f80" äquivalent.

Alternativ können Sie einige gängige Farben einfach mit ihrem Namen angeben. In dieser Tabelle sind die Namen der Farboptionen, die äquivalenten RGB-Tripel und die hexadezimalen Farbcodes angegeben.

Name der Farbe	Kurzname	RGB-Tripel	Hexadezimaler Farbcode	Darstellung
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	Nicht zutreffend	Nicht zutreffend	Nicht zutreffend	Keine Farbe

In dieser Tabelle finden Sie die Standardfarbpaletten für Diagramme im hellen und dunklen Design.

Palette	Palettenfarben
"gem" – Standardmäßig helles Design Vor R2025a: Die meisten Diagramme verwenden standardmäßig diese Farben.
"glow" – Standardmäßig dunkles Design

Die RGB-Tripel und hexadezimalen Farbcodes für diese Paletten erhalten Sie mit den Funktionen orderedcolors und rgb2hex. Besorgen Sie sich zum Beispiel die RGB-Tripel für die "gem"-Palette und wandeln Sie sie in hexadezimale Farbcodes um.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Vor R2023b: Besorgen Sie sich die RGB-Tripel mit RGB = get(groot,"FactoryAxesColorOrder").

Vor R2024a: Besorgen Sie sich die hexadezimalen Farbcodes mit H = compose("#%02X%02X%02X",round(RGB*255)).

Datentypen: double | char

Position — Position und Größe der Abbildung, außer Rändern, Abbildungstools und Titelleiste

[left bottom width height]

Position und Größe der Abbildung, außer Rändern, Abbildungstools und Titelleiste, angegeben als ein Vektor aus vier Elementen mit der Form [left bottom width height].

In dieser Tabelle sind die Elemente des Vektors aufgeführt.

Element	Beschreibung
left	Abstand vom linken Rand der primären Anzeige zum inneren linken Rand des Fensters. Dieser Wert kann bei Systemen mit mehreren Monitoren negativ sein. Ist die Abbildung angedockt, ist dieser Wert relativ zum Container der Abbildung.
bottom	Abstand vom unteren Rand der primären Anzeige zum inneren unteren Rand des Fensters. Dieser Wert kann bei Systemen mit mehreren Monitoren negativ sein. Ist die Abbildung angedockt, ist dieser Wert relativ zum Container der Abbildung.
width	Abstand zwischen dem linken und rechten inneren Rand des Fensters.
height	Abstand zwischen dem oberen und unteren inneren Rand des Fensters.

Die Einheit dieser Abmessungen wird von der Eigenschaft Units festgelegt.

Bei Abbildungen, die in einem Abbildungscontainer angedockt sind, wird die Abbildung durch Festlegen der Eigenschaft Position abgedockt und die Eigenschaft WindowStyle auf 'normal' gesetzt.

Um das gesamte Fenster einschließlich Rändern, Abbildungstools und Titelleiste zu positionieren, verwenden Sie die Eigenschaft OuterPosition.

Hinweis

Das Windows^®-Betriebssystem erzwingt eine minimale Fensterbreite und maximale Fenstergröße. Wenn Sie eine Abbildungsgröße außerhalb dieser Grenzen angeben, folgt die angezeigte Abbildung den Grenzwerten, nicht der von Ihnen angegebenen Größe.

Units — Maßeinheiten

'pixels' (Standardeinstellung) | 'normalized' | 'inches' | 'centimeters' | 'points' | 'characters'

Maßeinheiten, angegeben als einer der Werte aus dieser Tabelle.

Einheitenwert	Beschreibung
'pixels' (Standard)	Pixel. Bei Windows- und Macintosh-Systemen entspricht ein Pixel 1/96 eines Zolls. Diese Größe ist von Ihrer Systemauflösung unabhängig. Bei Linux®-Systemen wird die Größe eines Pixels durch Ihre Systemauflösung bestimmt.
'normalized'	Diese Einheiten werden relativ zum übergeordneten Container normalisiert. Die untere linke Ecke des Containers entspricht (0,0), die obere rechte Ecke (1,1).
'inches'	Zoll.
'centimeters'	Zentimeter.
'points'	Punkte. Ein Punkt entspricht 1/72 eines Zolls.
'characters'	Diese Einheiten basieren auf der uicontrol-Standardschriftart des Grafiken-Rootobjekts: Zeichenbreite = Breite des Buchstaben x. Zeichenhöhe = Abstand zwischen den Grundlinien zweier Textzeilen. Verwenden Sie get(groot,'defaultuicontrolFontName') oder set(groot,'defaultuicontrolFontName'), um auf die uicontrol-Standardschriftart zuzugreifen.

MATLAB misst alle Einheiten ab der linken unteren Ecke des übergeordneten Objekts.

Diese Eigenschaft wirkt sich auf die Eigenschaft Position aus. Wenn Sie die Eigenschaft Units ändern, sollten Sie deren Wert ggf. nach Abschluss Ihrer Berechnung wieder auf den Standardwert zurücksetzen, um nicht andere Funktionen, die vom Standardwert ausgehen, zu beeinträchtigen.

Die Reihenfolge, in der Sie die Eigenschaften Units und Position angeben, hat die folgenden Auswirkungen:

• Wenn Sie die Eigenschaft Units vor der Eigenschaft Position angeben, legt MATLAB Position anhand der von Ihnen angegebenen Einheiten fest.

• Wenn Sie die Eigenschaft Units nach der Eigenschaft Position angeben, legt MATLAB die Position anhand der Standardeinstellung für Units fest. Daraufhin wandelt MATLAB den Wert Position in den äquivalenten Wert in den von Ihnen angegebenen Einheiten fest.

Mehr über

Aktuelle Abbildung

Die aktuelle Abbildung ist das Ziel für Grafikbefehle wie axes und colormap. In der Regel ist dies die zuletzt erstellte Abbildung oder die letzte Abbildung, auf die mit der Maus geklickt wurde. Der Befehl gcf gibt die aktuelle Abbildung zurück.

Tipps

• Verwenden Sie das Grafiken-Rootobjekt, um die Standardwerte auf Root-Ebene für andere Objekttypen festzulegen. Setzen Sie beispielsweise die Standard-Farbtabelle für alle zukünftigen Abbildungen auf die Farbtabelle summer.

  set(groot,'DefaultFigureColormap',summer)

  Verwenden Sie das Schlüsselwort 'remove', um eine Eigenschaft auf den MATLAB-Standardwert zurückzusetzen.

  set(groot,'DefaultFigureColormap','remove')

  Weitere Informationen zum Festlegen von Standardwerten finden Sie unter Default Property Values.

Versionsverlauf

Eingeführt vor R2006a

Siehe auch

Funktionen

• axes | gcf | gca | clf | cla | shg

Eigenschaften

• Figure