saveas

Guardar figura en un formato de archivo específico

Sintaxis

saveas(fig,filename)

saveas(fig,filename,formattype)

Descripción

saveas(fig,filename) guarda la figura o el diagrama de bloques de Simulink^® especificado por fig al archivo filename. Especifique el nombre del archivo como un vector de caracteres o cadena que incluya una extensión de archivo, como por ejemplo, 'myplot.jpg'. La extensión del archivo define el formato de archivo. Si no especifica una extensión, saveas guarda la figura en un archivo FIG. Para guardar la figura actual, especifique fig como gcf.

saveas(fig,filename,formattype) crea el archivo utilizando el formato de archivo especificado formattype. Si no especifica una extensión de archivo en el nombre de archivo, como por ejemplo 'myplot', entonces la extensión estándar que corresponde al formato especificado se añade automáticamente al nombre del archivo. Si especifica una extensión de archivo, no tiene que coincidir con el formato. saveas usa formattype para el formato, pero guarda el archivo con la extensión especificada. Así, es posible que la extensión del archivo no coincida con el formato actual utilizado.

Ejemplos

Guardar figura como un archivo PNG

Cree una gráfica de barras y guárdela como un archivo PNG.

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart.png')

Guardar figura como un archivo EPS

Cree una gráfica de barras y guárdela como un archivo EPS. Especifique el driver 'epsc' para guardarlo en color.

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart','epsc')

saveas guarda la gráfica de barras como Barchart.eps.

Guardar un diagrama de bloques de Simulink como un archivo JPEG

Guarde un diagrama de bloques de Simulink llamado 'sldemo_tank' como un archivo JPEG. Utilice get_param obtener el identificador del diagrama. Para ejecutar este código debe tener instalado Simulink.

openExample('sldemo_tank')
fig = get_param('sldemo_tank','Handle');
saveas(fig,'MySimulinkDiagram.jpg');

Argumentos de entrada

fig — Figura que se desea guardar

objeto de figura | diagrama de bloques de Simulink

Figura que se desea guardar, especificada como un objeto de figura o un diagrama de bloques de Simulink. Si especifica otros tipos de objetos de gráficas, como por ejemplo ejes, entonces saveas guarda la figura del elemento principal en el objeto.

Ejemplo: saveas(gcf,'MyFigure.png')

Para guardar un diagrama de bloques de Simulink, use get_param para obtener el identificador del diagrama. Por ejemplo, guarde un diagrama de bloques llamado 'sldemo_tank'.

openExample('sldemo_tank')
saveas(get_param('sldemo_tank','Handle'),'MySimulinkDiagram.png');

filename — Nombre de archivo

vector de caracteres | cadena

Nombre de archivo, especificado como vector de caracteres o cadena con o sin una extensión de archivo.

Ejemplo: 'Bar Chart'

Ejemplo: 'Bar Chart.png'

Si especifica una extensión de archivo, entonces saveas usa el formato asociado. Si especifica una extensión de archivo y además especifica el argumento de entrada formattype, entonces saveas usa formattype para el formato y guarda el archivo con el nombre especificado. Así, es posible que la extensión del archivo no coincida con el formato actual utilizado.

Puede especificar cualquier extensión que corresponda a un formato de archivo. Esta tabla enumera algunas extensiones de archivo comunes.

Extensión	Formato resultante
.fig	Archivo FIG de MATLAB® (no válido para diagramas de bloques de Simulink)
.m	Archivo FIG de MATLAB y código MATLAB que abre la figura (no válido para diagramas de bloques de Simulink)
.jpg	imagen JPEG
.png	Portable Network Graphics
.eps	EPS nivel 3 blanco y negro
.pdf	Formato de documento portátil
.tif	Imagen TIFF, comprimida

Tipos de datos: char | string

formattype — Formato de archivo

'fig' | 'm' | 'mfig' | formato de archivo de imagen | formato de archivo de gráfico vectorial

Formato de archivo, especificado como una de las siguientes opciones:

• 'fig': Guarda la figura como un archivo de figura MATLAB con la extensión .fig. Para abrir figuras con la extensión .fig, use la función openfig. Este formato no es válido para diagramas de bloques de Simulink.

• 'm' o 'mfig': Guarda la figura como un archivo de figura MATLAB y crea además un archivo de MATLAB que abre la figura. Para abrir la figura, ejecute el archivo de MATLAB. Esta opción no es válida para diagramas de bloques de Simulink.

• Formatos de archivo de imagen: Especifique el formato como una de las opciones de imagen en la tabla, Formatos de archivo de imagen.

• Formatos de archivo de gráfico vectorial: Especifique el formato como una de las opciones de gráficos vectoriales en la tabla Formatos de gráficos vectoriales.

Archivo de imagen

Las imágenes contienen una representación basada en píxeles de la figura. El tamaño del archivo generado depende de la figura, el formato y la resolución de su sistema. Los navegadores web usan mucho las imágenes y otras aplicaciones que muestran gráficas. Sin embargo, no son compatibles con la transparencia o escala y usted no puede modificar objetos de gráficas individuales (como líneas y texto) en otras aplicaciones de gráficas.

Formatos de archivo de imagen

Opción	Formato	Extensión del archivo por defecto
'jpeg'	JPEG de 24 bits	.jpg
'png'	PNG de 24 bits	.png
'tiff'	TIFF de 24 bits (comprimido)	.tif
'tiffn'	TIFF de 24 bits (no comprimido)	.tif
'meta'	Metarchivo mejorado (solo Windows)	.emf

Archivo de gráfico vectorial

Los archivos de gráficos vectoriales guardan comandos que redibujan la figura. Este tipo de formato escala bien, pero puede dar como resultado un archivo grande. En algunos casos es posible que los gráficos vectoriales contengan líneas sueltas u otros elementos visuales. Algunas aplicaciones admiten la edición extensiva de formatos de gráficos vectoriales, mientras que otras aplicaciones solo admiten el cambio de tamaño de los gráficos. Se recomienda hacer todos los cambios necesarios mientras su figura esté en MATLAB.

Normalmente, saveas genera archivos de gráficos vectoriales que se escalan correctamente cuando se modifica su tamaño. Para algunas figuras complejas, los archivos podrían contener imágenes integradas. Estas imágenes no se escalan correctamente y el grado en que puede editarlas en otras aplicaciones es limitado.

Para exportar una figura que contenga todo el contenido de gráficos vectoriales, utilice la función exportgraphics y especifique el argumento de par nombre-valor ContentType como "vector".

Formatos de gráficos vectoriales

Opción	Formato	Extensión del archivo por defecto
'pdf'	Página completa de formato de documento portátil (PDF) color	.pdf
'eps'	Encapsulated PostScript® (EPS) nivel 3 blanco y negro	.eps
'epsc'	Encapsulated PostScript (EPS) nivel 3 color	.eps
'eps2'	Encapsulated PostScript (EPS) nivel 2 blanco y negro	.eps
'epsc2'	Encapsulated PostScript (EPS) nivel 2 color	.eps
'meta'	Enhanced Metafile (solo Windows®)	.emf
'svg'	SVG (gráficos vectoriales escalables)	.svg

Nota

Solo el formato PDF utiliza la propiedad PaperOrientation de la figura y los elementos left y bottom de la propiedad PaperPosition. Otros formatos ignoran estos valores.

Sugerencias

• Para controlar el tamaño o la resolución cuando guarda una figura, use la función print en su lugar.

• La función saveas y el cuadro de diálogo Save As (al que puede acceder desde el menú File), no dan resultados idénticos. El cuadro de diálogo Save As produce imágenes según la resolución y el tamaño de la pantalla. La función saveas usa una resolución de 150 DPI y usa las propiedades PaperPosition y PaperPositionMode de la figura para determinar el tamaño de la imagen.

• Algunos detalles de las figuras imprimidas y guardadas pueden tener un aspecto diferente de los de la figura en la pantalla. Para obtener una salida que sea más coherente con la visualización en la pantalla, consulte Guardar figura con color de fondo, resolución y tamaño específicos.

Funcionalidad alternativa

Utilice la función exportgraphics para guardar los contenidos de cualquier eje, figura o gráfica que pueden ser secundarios de una figura, de un diseño de gráfica en mosaico o de un contenedor, como por ejemplo un panel. Esta función proporciona una alternativa mejor a la función saveas cuando desee:

• Guardar gráficas que se muestran en una app o en MATLAB Online™

• Minimizar el espacio en blanco alrededor del contenido

• Guardar un fragmento PDF con fuentes embebibles

• Guardar un subconjunto del contenido en la figura

• Controlar el color de fondo sin tener que modificar las propiedades de la figura

Historial de versiones

Introducido antes de R2006a

R2025a: El contenido de la figura se reduce para ajustarse al tamaño de la página

La función saveas ya no recorta el contenido de una figura grande cuando la página es más pequeña que la figura, sino que reduce el contenido para que se ajuste a la página y conserva la relación de aspecto de la figura.

R2025a: Las propiedades de las figuras Renderer y InvertHardCopy ya no afectan la salida

La propiedad Renderer de una figura ya no tiene efecto en el gráfico guardado.

La propiedad InvertHardCopy de una figura no tiene efecto. Ahora, el color de fondo predeterminado corresponde al tema de la figura. El fondo es blanco si la figura tiene el tema claro. El fondo es gris oscuro (casi negro) si la figura tiene el tema oscuro. Si establece la propiedad Color de la figura antes de llamar a saveas, la salida usa el color que especifique independientemente del tema.

R2025a: Los componentes de la IU ya no se admiten

La función saveas ya no permite guardar componentes de la IU en figuras.

Para exportar una figura que contenga componentes de la IU, llame a la función exportapp. Por ejemplo, cree una app simple que contenga dos botones y un control deslizante. Exporte los contenidos de la figura como un archivo PDF llamando a la función exportapp.

% Create figure with three UI components
f = uifigure;
button1 = uibutton(f,Position=[150 300 100 50]);
button2 = uibutton(f,Position=[300 300 100 50]);
slider1 = uislider(f,Position=[150 250 250 3]);

% Export the contents of the figure
exportapp(f,"myapp.pdf")

De forma alternativa, llame a la función getframe para capturar los contenidos de la figura. A continuación, llame a la función imwrite para guardar el contenido. Esta vez, guarde el contenido como un archivo JPEG.

F = getframe(f);
imwrite(F.cdata,"myapp.jpg");

Este cambio se anunció en la versión R2022b. En las versiones de la R2023b a la R2024b, la función saveas emite una advertencia cuando se exporta una figura que contiene componentes de la IU.

R2025a: Los archivos PostScript (.ps) ya no se admiten

La función saveas ya no permite crear archivos de página completa PostScript (.ps). Para exportar archivos de gráficos vectoriales, use uno de los siguientes métodos:

Llame a la función exportgraphics. Especifique una extensión de archivo .svg, .eps, .pdf o .emf y establezca el argumento de par nombre-valor ContentType en "vector". Esta función captura contenido que se reduce estrictamente a la gráfica y no crea salida de página completa. Por ejemplo, cree una gráfica y guarde los contenidos de la figura actual como un archivo PDF que contiene gráficos vectoriales.

plot([0 3 2 4 1]);
exportgraphics(gcf,"myplot.pdf",ContentType="vector")

Como alternativa, llame a la función saveas y especifique una extensión de archivo .pdf, .eps, .emf o .svg. Por ejemplo, cree una gráfica y guarde los contenidos de la figura actual como un archivo EPS.

plot([0 3 2 4 1]);
saveas(gcf,"myplot.eps","epsc")

Antes de R2025a: Consulte saveas (R2022a) para obtener información sobre las opciones PostScript compatibles en versiones anteriores.

Este cambio se anunció en la versión R2022b. En las versiones de la R2023b a la R2024b, la función saveas emite una advertencia cuando se exporta una figura a un archivo PostScript.

R2025a: Los archivos BMP, HDF, PBM, PCX, PGM, y PPM ya no se admiten

Los formatos de archivos BMP, HDF, PBM, PCX, PGM, y PPM ya no se admiten.

Para exportar gráficas usando uno de estos formatos use la función imwrite en su lugar. Por ejemplo, cree una gráfica de línea y capture los contenidos de la figura actual utilizando la función getframe. Después, guarde el contenido como un archivo BMP.

plot([0 3 2 4 1]);
F = getframe(gcf);
imwrite(F.cdata,"myplot.bmp");

Antes de R2025a: Consulte saveas (R2022a) para ver las opciones de formatos de archivo compatibles en versiones anteriores.

Este cambio se anunció en la versión R2022b. En las versiones de la R2023b a la R2024b, la función saveas emite una advertencia cuando se exporta una figura a uno de estos formatos de archivo.

R2016a: Las figuras guardadas coinciden con el tamaño en pantalla

De forma predeterminada, las figuras guardadas coinciden con el tamaño de la figura que se muestra en pantalla. Anteriormente, las figuras guardadas tenían 8 por 6 pulgadas de forma predeterminada.

Consulte también

savefig | copygraphics | print | exportgraphics | open

Temas

• Compare Ways to Export Graphics from Figures
• Guardar gráfica como una imagen o archivo gráfico de vectores