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.

f = figure;

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

f.Position

ans =

   680   558   560   420

Questo significa che la finestra della figura è posizionata 680 pixel a destra e 558 pixel sopra l'angolo inferiore sinistro del display primario, con una larghezza di 560 pixel e un'altezza di 420 pixel.

Dimezzare la larghezza e l'altezza della figura regolando il terzo e il quarto elemento del vettore di posizione.

f.Position(3:4) = [280 210];

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. 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 Properties.

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 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

Si riportano di seguito le triplette RGB e i codici di colore esadecimale per i colori predefiniti che MATLAB utilizza in molti tipi di grafici.

Tripletta RGB	Codice di colore esadecimale	Aspetto
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Tipi di dati: double | char

Position — Posizione e dimensione dell'area disegnabile

[left bottom width height]

Posizione e dimensione dell'area disegnabile, specificate come vettore di forma [left bottom width height]. Quest'area esclude i bordi delle figure, la barra del titolo, la barra del menu e le barre degli strumenti.

Questa tabella descrive ciascun elemento del vettore Position.

Elemento	Descrizione
left	Distanza dal bordo sinistro del display primario al bordo interno sinistro della finestra. Questo valore può essere negativo nei sistemi con più di un monitor. Se la figura è agganciata, questo valore è relativo al pannello della figura nel desktop di MATLAB.
bottom	Distanza dal bordo inferiore del display primario al bordo inferiore interno della finestra. Questo valore può essere negativo nei sistemi con più di un monitor. Se la figura è agganciata, questo valore è relativo al pannello della figura nel desktop di MATLAB.
width	Distanza tra il bordo interno destro e quello sinistro della figure.
height	Distanza tra i bordi interni superiore e inferiore della finestra.

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

Non è possibile specificare la proprietà Position della figura quando la figura è agganciata.

In MATLAB Online™, gli elementi bottom e left del vettore Position sono ignorati.

Per posizionare l'intera finestra, compresi i bordi, la barra del titolo, la barra del menu e le barre degli strumenti, 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 rispetterà i limiti anziché la 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. A partire dalla release R2015b, le distanze in pixel sono indipendenti dalla risoluzione del sistema sui sistemi Windows e Macintosh: Nei sistemi Windows, un pixel corrisponde a 1/96-esimo di pollice. Nei sistemi Macintosh, un pixel corrisponde a 1/72-esimo di pollice. 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 Properties