figure

Crear una ventana de figura

Sintaxis

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

Descripción

figure crea una ventana de figura nueva utilizando valores de propiedades predeterminados. La figura resultante es la figura actual.

figure(Name,Value) modifica las propiedades de la figura utilizando uno o más argumentos de par nombre-valor. Por ejemplo, figure('Color','white') establece el color del fondo como blanco.

f = figure(___) devuelve el objeto Figure. Utilice f para consultar o modificar las propiedades de la figura después de crearla.

figure(f) convierte la figura que especifica f en la figura actual y la muestra encima de todas las demás figuras.

figure(n) encuentra una figura en la que la propiedad Number es igual a n y la convierte en la figura actual. Si no existe ninguna figura con ese valor de propiedad, MATLAB^® crea una figura nueva y establece la propiedad Number en n.

Ejemplos

Cambiar el tamaño de la figura

Cree una figura predeterminada.

f = figure;

Obtenga la ubicación, la anchura y la altura de la figura.

f.Position

ans =

   680   558   560   420

Esto significa que la ventana de figuras está situada 680 píxeles a la derecha y 558 píxeles por encima de la esquina inferior izquierda de la visualización principal, y que tiene 560 píxeles de anchura y 420 píxeles de altura.

Divida a la mitad la anchura y la altura de la figura ajustando el tercer y el cuarto elemento del vector Position.

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

Especificar el título de la figura

Cree una figura y especifique la propiedad Name. De forma predeterminada, el título resultante incluye el número de la figura.

figure('Name','Measured Data');

Defina la propiedad Name de nuevo, pero, esta vez, establezca la propiedad NumberTitle en 'off'. El título resultante no incluye el número de la figura.

figure('Name','Measured Data','NumberTitle','off');

Trabajar con múltiples figuras de manera simultánea

Cree dos figuras y, después, cree una gráfica de líneas. De forma predeterminada, el comando plot afecta a la figura actual.

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

Establezca la figura actual en f1, de forma que sea el objetivo de la gráfica siguiente. Después, cree un diagrama de dispersión.

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

Argumentos de entrada

f — Figura objetivo

objeto Figure

Figura objetivo, especificada como objeto Figure.

n — Número de figura objetivo

valor entero escalar

Número de figura objetivo, especificado como valor entero escalar. Cuando especifica este argumento, MATLAB busca una figura existente en la que la propiedad Number es igual a n. Si no existe ninguna figura con ese valor de propiedad, MATLAB crea una figura nueva y establece la propiedad Number en n. De forma predeterminada, el valor de propiedad Number se muestra en el título de la figura.

Tipos de datos: double

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

Ejemplo: figure(Color="white") crea una figura con un fondo blanco.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: figure("Color","white") crea una figura con un fondo blanco.

Nota

Las propiedades que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte Figure Properties.

Name — Nombre

'' (predeterminado) | vector de caracteres | escalar de cadena

Nombre de la figura, especificado como vector de caracteres o escalar de cadena.

Ejemplo: figure('Name','Results') establece el nombre de la figura en 'Results'.

De forma predeterminada, el nombre es 'Figure n', donde n es un entero. Al especificar la propiedad Name, el título de la figura pasa a ser 'Figure n: name'. Si desea que solo aparezca el valor Name, establezca IntegerHandle o NumberTitle en 'off'.

Color — Color de fondo

Triplete RGB | código de color hexadecimal | 'r' | 'g' | 'b' | ...

Color de fondo, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto. Si especifica 'none', el color de fondo aparece como negro en pantalla, pero si imprime la figura, el fondo se imprime como si la ventana de figura fuera transparente.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"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"	No se aplica	No se aplica	No se aplica	Sin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Código de color hexadecimal	Apariencia
[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"

Tipos de datos: double | char

Position — Ubicación y tamaño del área dibujable

[left bottom width height]

Ubicación y tamaño del área dibujable, especificados como vector de la forma [left bottom width height]. Esta área excluye los bordes de la figura, la barra de título, la barra de menú y las barras de herramientas.

Esta tabla describe cada elemento del vector Position.

Elemento	Descripción
left	Distancia desde el borde izquierdo de la visualización principal al borde izquierdo interior de la ventana. Este valor puede ser negativo en sistemas que tienen más de un monitor. Si la figura está acoplada, este valor es relativo al panel de figuras del escritorio de MATLAB.
bottom	Distancia desde el borde inferior de la visualización principal al borde inferior interior de la ventana. Este valor puede ser negativo en sistemas que tienen más de un monitor. Si la figura está acoplada, este valor es relativo al panel de figuras del escritorio de MATLAB.
width	Distancia entre los bordes interiores derecho e izquierdo de la figure.
height	Distancia entre los bordes interiores superior e inferior de la ventana.

Todas las medidas están en las unidades que especifica la propiedad Units.

No puede especificar la propiedad Position de la figura cuando la figura está acoplada.

En MATLAB Online™, los elementos bottom y left del vector Position se ignoran.

Para situar la ventana completa, incluidos los bordes, la barra de título, la barra de menú y las barras de herramientas, utilice la propiedad OuterPosition.

Nota

El sistema operativo Windows^® aplica una anchura de ventana mínima y un tamaño de ventana máximo. Si especifica un tamaño de figura fuera de esos límites, la figura mostrada se ajusta a los límites en lugar de al tamaño que haya especificado.

Units — Unidades de medida

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

Unidades de medida, especificadas como uno de los valores de esta tabla.

Valor de unidades	Descripción
'pixels' (valor predeterminado)	Píxeles. A partir de la versión R2015b, las distancias en píxeles son independientes de la resolución del sistema en sistemas Windows y Macintosh: En sistemas Windows, un píxel es 1/96 de una pulgada. En sistemas Macintosh, un píxel es 1/72 de una pulgada. En sistemas Linux®, la resolución del sistema determina el tamaño de un píxel.
'normalized'	Estas unidades están normalizadas con respecto al contenedor principal. La esquina inferior izquierda del contenedor se asigna a (0,0) y la esquina superior derecha, a (1,1).
'inches'	Pulgadas.
'centimeters'	Centímetros.
'points'	Puntos. Un punto equivale a 1/72 de una pulgada.
'characters'	Estas unidades se basan en la fuente UIControl predeterminada del objeto raíz de gráficas: Anchura del carácter = anchura de la letra x. Altura del carácter = distancia entre las líneas de referencia de dos líneas de texto. Para acceder a la fuente UIControl predeterminada, utilice get(groot,'defaultuicontrolFontName') o set(groot,'defaultuicontrolFontName').

MATLAB mide todas las unidades desde la esquina inferior izquierda del objeto principal.

Esta propiedad afecta a la propiedad Position. Si cambia la propiedad Units, considere devolver su valor al valor predeterminado una vez terminado el cálculo para evitar afectar a otras funciones que asumen el valor predeterminado.

El orden en el que especifique las propiedades Units y Position tiene estos efectos:

• Si especifica la propiedad Units antes que la propiedad Position, MATLAB establece Position utilizando las unidades que especifica.

• Si especifica la propiedad Units después de la propiedad Position, MATLAB establece Position utilizando la propiedad Units predeterminada. Después, MATLAB convierte el valor Position al valor equivalente en las unidades que especifica.

Más acerca de

Figura actual

La figura actual es el objetivo de comandos de gráficas como axes y colormap. Normalmente, es la última figura creada o la última figura en la que se ha hecho clic con el ratón. El comando gcf devuelve la figura actual.

Sugerencias

• Utilice el objeto raíz de gráfica para establecer valores predeterminados en el nivel de raíz para otros tipos de objetos. Por ejemplo, establezca el mapa de colores predeterminado para todas las figuras futuras en el mapa de colores summer.

  set(groot,'DefaultFigureColormap',summer)

  Para restaurar una propiedad a su valor predeterminado original de MATLAB, utilice la palabra clave 'remove'.

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

  Para obtener más información sobre cómo establecer valores predeterminados, consulte Valores predeterminados de las propiedades.

Historial de versiones

Introducido antes de R2006a

Consulte también

Funciones

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

Propiedades

• Figure Properties