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. La figura aparece como una pestaña en un contenedor de figuras.

f = figure;

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

f.Position

ans =

    1    1    1070    620

Esto significa que la figura se coloca con su esquina inferior izquierda adyacente a la esquina del contenedor de figuras, y la figura tiene 1070 píxeles de anchura y 620 píxeles de altura.

Puede cambiar el tamaño del contenedor de figuras de forma interactiva. Como alternativa, puede especificar el tamaño de la figura estableciendo su propiedad Position, que desacopla la figura del contenedor de figuras. Por ejemplo, coloque la figura 100 píxeles a la derecha y 200 píxeles por encima de la esquina inferior izquierda de la pantalla principal, y especifique que su tamaño tenga 500 píxeles de ancho y 300 píxeles de altura.

f.Position = [100 200 500 300];

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. Las figuras aparecen como pestañas en un contenedor de figuras. 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.

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

En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.

Paleta	Colores de la paleta
"gem": tema claro predeterminado Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada.
"glow": tema oscuro predeterminado

Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.

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

Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").

Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).

Tipos de datos: double | char

Position — Ubicación y tamaño de la figura, excluidos los bordes, las herramientas de la figura y la barra de título

[left bottom width height]

Ubicación y tamaño de la figura, excluidos los bordes, las herramientas de la figura y la barra de título, especificados como un vector de cuatro elementos de la forma [left bottom width height].

Esta tabla describe cada elemento del vector.

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 a su contenedor.
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 a su contenedor.
width	Distancia entre los bordes interiores derecho e izquierdo de la ventana.
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.

En las figuras acopladas a un contenedor de figuras, cuando se establece la propiedad Position, se desacopla la figura y se establece la propiedad WindowStyle en 'normal'.

Para colocar la ventana completa, incluidos los bordes, las herramientas de la figura y la barra de título, 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 ajustará a los límites en lugar de ajustarse al tamaño que especificó.

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. En sistemas Windows y Macintosh, el tamaño de un píxel es de 1/96 de una pulgada. Este tamaño es independiente de la resolución de su sistema. 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