figure

Creare finestre delle figure

Sintassi

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

Descrizione

figure crea una nuova finestra della figura utilizzando i valori predefiniti delle proprietà. La figura risultante è la figura corrente.

figure(Name,Value) modifica le proprietà della figura utilizzando uno o più argomenti della coppia nome-valore. Ad esempio, figure('Color','white') imposta il colore dello sfondo sul bianco.

f = figure(___) restituisce l'oggetto Figure. Utilizzare f per eseguire una query o modificare le proprietà della figura dopo averla creata.

figure(f) rende la figura specificata da f la figura corrente e la visualizza sopra tutte le altre figure.

figure(n) trova una figura in cui la proprietà Number è uguale a n e la rende la figura corrente. Se non è presente una figura con quel valore di proprietà, MATLAB^® crea una nuova figura e imposta la relativa proprietà Number su n.

Esempi

Modifica della dimensione della figura

Creare una figura predefinita. La figura appare come una scheda in un contenitore della figura.

f = figure;

Ottiene la posizione, la larghezza e l'altezza della figura.

f.Position

ans =

    1    1    1070    620

Questo significa che la figura è posizionata con l'angolo inferiore sinistro adiacente all'angolo del contenitore della figura e che ha una larghezza di 1070 pixel e un'altezza di 620 pixel.

È possibile ridimensionare il contenitore della figura in modo interattivo. In alternativa, è possibile specificare la dimensione della figura impostando la proprietà Position, che sgancia la figura dal contenitore della figura. Ad esempio, posizionare la figura in modo che si trovi 100 pixel a destra e 200 pixel al di sopra dell'angolo inferiore sinistro del display primario e specificare che abbia una larghezza di 500 pixel e un'altezza di 300 pixel.

f.Position = [100 200 500 300];

Definizione del titolo della figura

Creare una figura e specificare la proprietà Name. Per impostazione predefinita, il titolo risultante include il numero della figura.

figure(Name="Measured Data");

Specificare nuovamente la proprietà Name ma, questa volta, impostare la proprietà NumberTitle su "off". Il titolo risultante non include il numero della figura.

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

Elaborazione con più figure contemporaneamente

Creare due figure, quindi creare un grafico a linee. Le figure appaiono come schede in un contenitore delle figure. Per impostazione predefinita, il comando plot punta alla figura corrente.

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

Impostare la figura corrente su f1 in modo che sia la destinazione del prossimo grafico. Creare quindi un grafico a dispersione.

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

Argomenti di input

f — Figura di destinazione

Oggetto Figure

Figura di destinazione, specificata come oggetto Figure.

n — Numero della figura di destinazione

valore intero scalare

Numero della figura di destinazione, specificato come valore intero scalare. Quando si specifica questo argomento, MATLAB cerca una figura esistente in cui la proprietà Number è uguale a n. Se non è presente una figura con quel valore di proprietà, MATLAB crea una nuova figura e imposta la relativa proprietà Number su n. Per impostazione predefinita, il valore della proprietà Number è visualizzato nel titolo della figura.

Tipi di dati: double

Argomenti nome-valore

Specificare coppie opzionali di argomenti come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell’argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono comparire dopo gli altri argomenti, mentre l'ordine delle coppie non è rilevante.

Esempio figure(Color="white") crea una figura con sfondo bianco.

Per le release antecedenti alla R2021a, utilizzare le virgole per separare ciascun nome e valore e includere Name tra virgolette.

Esempio figure("Color","white") crea una figura con sfondo bianco.

Nota

Le proprietà qui elencate sono solo un sottoinsieme. Per un elenco completo, vedere Figure.

Name — Nome

'' (predefinito) | vettore di caratteri | scalare di stringa

Nome della figura, specificato come vettore di caratteri o scalare di stringa.

Esempio figure('Name','Results') imposta il nome della figura su 'Results'.

Per impostazione predefinita, il nome è 'Figure n', dove n è un intero. Quando si specifica la proprietà Name, il titolo della figura diventa 'Figure n: name'. Se si desidera che appaia solo il valore Name, impostare IntegerHandle o NumberTitle su 'off'.

Color — Colore dello sfondo

Tripletta RGB | codice di colore esadecimale | 'r' | 'g' | 'b' | ...

Colore dello sfondo, specificato come tripletta RGB, codice di colore esadecimale, nome del colore o nome abbreviato. Se si specifica 'none', il colore dello sfondo appare nero sullo schermo ma, se si stampa la figura, lo sfondo viene stampato come se la finestra della figura fosse trasparente.

Per un colore personalizzato, specificare una tripletta RGB o un codice di colore esadecimale.

• Una tripletta RGB è un vettore riga a tre elementi i cui elementi specificano le intensità dei componenti rosso, verde e blu del colore. Le intensità devono essere comprese nell'intervallo [0,1], ad esempio, [0.4 0.6 0.7].

• Un codice di colore esadecimale è uno scalare di stringa o un vettore di caratteri che inizia con un simbolo cancelletto (#) seguito da tre o sei cifre esadecimali che possono andare da 0 a F. I valori non differenziano tra maiuscole e minuscole. Pertanto, i codici di colore "#FF8800", "#ff8800", "#F80" e "#f80" sono equivalenti.

In alternativa, è possibile specificare alcuni colori comuni per nome. Questa tabella elenca le opzioni di colore denominate, le terzine RGB equivalenti e i codici di colore esadecimali.

Nome del colore	Nome abbreviato	Tripletta RGB	Codice di colore esadecimale	Aspetto
"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"	Non applicabile	Non applicabile	Non applicabile	Nessun colore

Questa tabella elenca le tavolozze dei colori predefinite per i grafici nei temi chiaro e scuro.

Tavolozza	Colori della tavolozza
"gem": tema chiaro predefinito Prima di R2025a: Per impostazione predefinita, la maggior parte dei grafici utilizza questi colori.
"glow": tema scuro predefinito

È possibile ottenere le triplette RGB e i codici di colore esadecimali per queste tavolozze utilizzando le funzioni orderedcolors e rgb2hex. Ad esempio, ottenere le triplette RGB per la tavolozza "gem" e convertirle in codici di colore esadecimali.

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

Prima di R2023b: Ottenere le triplette RGB utilizzando RGB = get(groot,"FactoryAxesColorOrder").

Prima di R2024a: Ottenere i codici di colore esadecimali utilizzando H = compose("#%02X%02X%02X",round(RGB*255)).

Tipi di dati: double | char

Position — Posizione e dimensione della figura, esclusi i bordi, gli strumenti della figura e la barra del titolo

[left bottom width height]

Posizione e dimensione della figura, esclusi i bordi, gli strumenti della figura e la barra del titolo, specificate come vettore a quattro elementi di forma [left bottom width height].

Questa tabella descrive ciascun elemento del vettore.

Elemento	Descrizione
left	Distanza dal bordo sinistro del display primario al bordo interno sinistro della finestra. Questo valore può essere negativo su sistemi che dispongono di più di un monitor. Se la figura è ancorata, questo valore è relativo al suo contenitore.
bottom	Distanza dal bordo inferiore del display primario al bordo inferiore interno della finestra. Questo valore può essere negativo su sistemi che dispongono di più di un monitor. Se la figura è ancorata, questo valore è relativo al suo contenitore.
width	Distanza tra il bordo interno destro e quello sinistro della finestra.
height	Distanza tra i bordi interni superiore e inferiore della finestra.

Tutte le misure sono espresse in unità, specificate dalla proprietà Units.

Per le figure ancorate a un contenitore della figura, l'impostazione della proprietà Position sgancia la figura e imposta la proprietà WindowStyle su 'normal'.

Per posizionare l'intera finestra, compresi i bordi, gli strumenti della figura e la barra del titolo, utilizzare la proprietà OuterPosition.

Nota

Il sistema operativo Windows^® impone una larghezza minima e una dimensione massima della finestra. Se si specifica una dimensione della figura non compresa tra questi limiti, la figura visualizzata si conforma ai limiti anziché alla dimensione specificata.

Units — Unità di misura

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

Unità di misura, specificata come uno dei valori di questa tabella.

Valore delle unità	Descrizione
'pixels' (predefinita)	Pixel. Nei sistemi Windows e Macintosh, la dimensione di un pixel è pari a 1/96-esimo di pollice. Questa dimensione è indipendente dalla risoluzione del sistema. Nei sistemi Linux®, la dimensione di un pixel è determinata dalla risoluzione del sistema.
'normalized'	Queste unità sono normalizzate rispetto al contenitore padre. L'angolo inferiore sinistro del contenitore è associato a (0,0) e l'angolo superiore destro a (1,1).
'inches'	Pollici.
'centimeters'	Centimetri.
'points'	Punti. Un punto corrisponde a 1/72-esimo di pollice.
'characters'	Queste unità si basano sul carattere uicontrol predefinito dell'oggetto radice grafico: Larghezza del carattere = larghezza della lettera x. Altezza del carattere = distanza tra le linee di base di due righe di testo. Per accedere al carattere uicontrol predefinito, utilizzare get(groot,'defaultuicontrolFontName') o set(groot,'defaultuicontrolFontName').

MATLAB misura tutte le unità dall'angolo inferiore sinistro dell'oggetto padre.

Questa proprietà influisce sulla proprietà Position. Se si modifica la proprietà Units, considerare di riportarla al valore predefinito al completamento del calcolo, onde evitare di influenzare altre funzioni che adottano il valore predefinito.

L'ordine in cui si specificano le proprietà Units e Position produce i seguenti effetti:

• Se si specifica la proprietà Units prima della proprietà Position, MATLAB imposta Position utilizzando le unità specificate.

• Se si specifica la proprietà Units dopo la proprietà Position, MATLAB imposta la posizione utilizzando l'impostazione predefinita di Units. Quindi, MATLAB converte il valore Position nel valore equivalente nelle unità specificate.

Ulteriori informazioni

Figura corrente

La figura corrente è la destinazione dei comandi grafici, come axes e colormap. Usualmente, si tratta dell'ultima figura creata o dell'ultima figura su cui si è fatto clic con il mouse. Il comando gcf restituisce la figura corrente.

Suggerimenti

• Utilizzare l'oggetto radice grafico per impostare i valori predefiniti a livello di radice per gli altri tipi di oggetti. Ad esempio, impostare la mappa dei colori predefinita per tutte le future figure sulla mappa dei colori summer.

  set(groot,'DefaultFigureColormap',summer)

  Per ripristinare una proprietà al suo valore originale predefinito di MATLAB, utilizzare la parola chiave 'remove'.

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

  Per maggiori informazioni sull'impostazione dei valori predefiniti, vedere Default Property Values.

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

Funzioni

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

Proprietà

• Figure