figure

Crear ventana de figura

Sintaxis

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

Descripción

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

figure(Name,Value) modifica las propiedades de la figura mediante uno o varios argumentos de par nombre-valor. Por ejemplo, figure('Color','white') establece el color del fondo en blanco.

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

figure(f) convierte la figura especificada por f en la figura actual y la muestra sobre 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 nueva figura y establece su propiedad Number como n.

Ejemplos

Especificar título de 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');

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

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

Trabajar con varias figuras simultáneamente

Cree dos figuras y, a continuación, cree un gráfico de líneas. De forma predeterminada, el comando plot se dirige a la figura actual.

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

Establezca la figura actual como f1, de manera que sea el destino del siguiente gráfico. Luego, cree un gráfico de dispersión.

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

Argumentos de entrada

f — Figura de destino

objeto Figure

Figura de destino, especificada como un objeto Figure.

n — Número de figura de destino

valor entero escalar

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

Tipos de datos: double

Argumentos de par nombre-valor

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

Especifique pares opcionales separados por comas de argumentos Name,Value. Name es el nombre del argumento y Value es el valor correspondiente. Name debe aparecer dentro de comillas simples (' '). Puede especificar varios argumentos de par de nombre y valor como Name1,Value1,...,NameN,ValueN.

Nota

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

'Number' — Número de la figura

entero | []

Esta propiedad es de solo lectura.

Número de la figura, devuelto como un entero o un array vacío. Puede hacer referencia a una figura utilizando este valor. Por ejemplo, figure(2) convierte la figura con un valor de propiedad Number de 2 en la figura actual.

Si la propiedad IntegerHandle se establece en 'off', Number es un array vacío.

Si IntegerHandle es 'on', el valor de la propiedad Number es un entero. Si se elimina el objeto Figure, MATLAB reutiliza el número para la siguiente figura.

'Name' — Nombre

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

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

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

De forma predeterminada, el nombre es 'Figure n', donde n es un entero. Cuando se especifica la propiedad Name, el título de la figura se convierte en 'Figure n: name'. Si solo desea que aparezca el valor Name, establezca IntegerHandle o NumberTitle como 'off'.

'Color' — Color de fondo

Triplete RGB | 'r' | 'g' | 'b' | ...

Color de fondo, especificado como un triplete RGB o una de las opciones de color enumeradas en la tabla. Si especifica 'none', el color de fondo aparece negro en la pantalla pero, si se imprime la figura, el fondo se imprime como si la ventana de la figura fuera transparente.

Para un color personalizado, especifique un triplete RGB. Un triplete RGB es un vector de 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]. Si lo prefiere, puede especificar algunos colores comunes por su nombre. Esta tabla muestra las opciones de nombre de color largo y corto, y los valores equivalentes de triplete RGB.

Opción	Descripción	Triplete RGB equivalente
'red' o 'r'	Rojo	[1 0 0]
'green' o 'g'	Verde	[0 1 0]
'blue' o 'b'	Azul	[0 0 1]
'yellow' o 'y'	Amarillo	[1 1 0]
'magenta' o 'm'	Magenta	[1 0 1]
'cyan' o 'c'	Cian	[0 1 1]
'white' o 'w'	Blanco	[1 1 1]
'black' o 'k'	Negro	[0 0 0]
'none'	Sin color	No aplicable

Tipos de datos: double | char

'Position' — Ubicación y tamaño del área de dibujo

[left bottom width height]

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

Esta tabla describe cada elemento del vector Position.

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

Todas las mediciones se encuentran en las unidades especificadas por la propiedad Units.

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

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

Nota

El sistema operativo Windows^® impone un ancho de ventana mínimo y un tamaño máximo de ventana. Si especifica un tamaño de figura fuera de esos límites, la figura mostrada se ajustará a los límites en lugar de al tamaño 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 las 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 los sistemas Windows y Macintosh: En los sistemas Windows, un píxel es 1/96 de pulgada. En los sistemas Macintosh, un píxel es 1/72 de pulgada. En los sistemas Linux®, el tamaño de un píxel se determina según la resolución del sistema.
'normalized'	Estas unidades se normalizan con respecto al contenedor principal. La esquina inferior izquierda del contenedor se asigna a (0,0) y la esquina superior derecha se asigna a (1,1).
'inches'	Pulgadas.
'centimeters'	Centímetros.
'points'	Puntos. Un punto equivale a 1/72 de pulgada.
'characters'	Estas unidades se basan en la fuente uicontrol predeterminada del objeto raíz de gráficos: Ancho de carácter = ancho de la letra x. Altura de carácter = distancia entre las líneas de referencia de dos líneas de texto. Para obtener acceso 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 después de completar el cálculo para evitar afectar a otras funciones que asuman el valor predeterminado.

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

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

• Si especifica la propiedad Units después de la propiedad Position, MATLAB establece la posición mediante el argumento Units predeterminado. A continuación, MATLAB convierte el valor de Position en el valor equivalente de las unidades que especifique.

Más acerca de

Figura actual

La figura actual es el destino de los comandos gráficos como axes y colormap. Típicamente, 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.

Consulte también

Funciones

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

Propiedades

• Figure Properties

Introducido antes de R2006a