print

Imprimir figura o guardarla en un formato de archivo específico

Sintaxis

print(filename,formattype)

print(filename,formattype,formatoptions)

print

print(printer)

print(driver)

print(printer,driver)

print("-clipboard",clipboardformat)

print(resize,___)

print(resolution,___)

print(contenttype,___)

print(fig,___)

cdata = print("-RGBImage");

Descripción

print(filename,formattype) guarda la figura actual en un archivo utilizando el formado de archivo especificado, como print("BarPlot","-dpng"). Si el nombre del archivo no incluye una extensión, print añade la extensión adecuada.

print(filename,formattype,formatoptions) especifica opciones adicionales que están disponibles para algunos formatos.

print imprime la figura actual en la impresora predeterminada.

print(printer) especifica la impresora. Especifique la impresora como un vector de caracteres o cadena que contenga el nombre de la impresora precedido por -P, por ejemplo, "-Pmy printer". La impresora debe estar configurada en su sistema.

print(driver) especifica el driver. Utilice esta opción si desea garantizar que la salida impresa sea en blanco y negro o en color.

print(printer,driver) especifica la impresora y el driver.

print("-clipboard",clipboardformat) copia la figura actual al portapapeles con el formato especificado por clipboardformat. Puede pegar la figura copiada en otras aplicaciones.

print(resize,___) maximiza el tamaño de la figura para que se ajuste a la página. Especifique resize como "-bestfit" para mantener la relación de aspecto de la figura o "-fillpage" para ignorar la relación de aspecto. Estas opciones son solo válidas cuando se guardan en formato de página (PDF y PS) o se imprimen en una impresora. Utilice esta opción con cualquiera de los argumentos de entrada de las sintaxis anteriores.

print(resolution,___) utiliza la resolución especificada. Especifique la resolución como una cadena que contenga un valor entero precedido por "-r"; por ejemplo, "-r200". Utilice esta opción con cualquiera de los argumentos de entrada de las sintaxis anteriores.

print(contenttype,___) especifica el tipo de contenido que se desea crear como "-vector" (para gráficos vectoriales) o "-image" (para imágenes).

print(fig,___) guarda o imprime la figura o el diagrama de bloques de Simulink^® especificado por fig.

cdata = print("-RGBImage"); devuelve los datos de imagen RGB de la figura actual. Esta opción difiere de las capturas de pantalla en que todas las funcionalidades de impresión se aplican a la salida. También puede especificar las opciones resolution, contenttype y fig con esta sintaxis. Sin embargo, no puede especificar un diagrama de bloques de Simulink.

Ejemplos

Imprimir copia en papel de la figura

Cree una gráfica de barras e imprímala en la impresora predeterminada del sistema. Si no especifica la figura que desea imprimir, print utiliza la figura actual.

bar(1:10)
print

Copiar figura en el portapapeles

Cree una gráfica y cópiela en el portapapeles del sistema.

plot(1:10)
print("-clipboard","-dmeta")

Puede pegar la gráfica copiada en otras aplicaciones.

Guardar figura como archivo de imagen

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

bar(1:10)
print("BarPlot","-dpng")

print guarda la gráfica como BarPlot.png.

Guardar figura como archivo de gráficos vectoriales

Cree una gráfica y guárdela como un archivo Encapsulated PostScript^®.

bar(1:10)
print("BarPlot","-depsc")

print guarda la gráfica como BarPlot.eps.

Añadir vista previa TIFF a un archivo EPS

Guarde la figura actual como un archivo Encapsulated PostScript y añada una vista previa TIFF.

surf(peaks)
print("SurfacePlot","-depsc","-tiff")

Especificar la figura que desea guardar

Guarde una figura específica pasando su variable de objeto a print.

fig = figure;
plot(1:10)
print(fig,"MySavedPlot","-dpng")

Alternativamente, haga referencia a una figura utilizando el valor de su propiedad Number, que es el valor entero que se muestra en la barra de título de la ventana de figura. Por ejemplo, guarde la figura que muestra Figure 2 en la barra de título. El valor entero debe ir precedido de -f.

figure(2);
plot(1:10)
print("-f2","MySavedPlot","-dpng")

Guardar figura con el tamaño y la resolución de la pantalla

Guarde una gráfica de superficie en un archivo PNG. Establezca la propiedad PaperPositionMode de la figura en "auto" para que se guarde con el tamaño mostrado en la pantalla. Use "-r0" para guardarla con la resolución de la pantalla.

surf(peaks)
set(gcf,"PaperPositionMode","auto")
print("PeaksSurface","-dpng","-r0")

Guardar figura que se ajuste a la página

Guarde una figura que se ajuste a la página usando la opción "-fillpage".

bar([1 10 7 8 2 2 9 3 6])
print("FillPageFigure","-dpdf","-fillpage")

Devolver datos de imagen RGB de una figura

Devuelva los datos de imagen RGB de una figura.

surf(peaks)
cdata = print("-RGBImage");

Muestre los datos de imagen con resolución completa mediante imshow.

imshow(cdata)

Crear un fotograma de vídeo de alta resolución

Cree una gráfica de superficie. Devuelva los datos de imagen RGB de la figura y especifique la resolución de imagen. Luego, convierta los datos de imagen en un fotograma de vídeo, F.

surf(peaks)
cdata = print("-RGBImage","-r120");
F = im2frame(cdata);

Argumentos de entrada

filename — Nombre de archivo

vector de caracteres | cadena

Nombre de archivo, especificado como cadena o vector de caracteres que contiene el nombre de archivo y la ruta deseados.

Ejemplo: "My Saved Chart"

Ejemplo: "Folder\My Saved Chart"

Ejemplo: "My Saved Chart"

La longitud máxima del nombre de archivo, incluyendo la ruta, es específica del sistema operativo y el formato del archivo. Normalmente, el nombre de archivo no debe tener más de 126 caracteres o, si se incluye la ruta, no más de 128.

Tipos de datos: char | string

formattype — Formato de archivo

"-djpeg" | "-dpng" | "-dtiff" | "-dpdf" | "-deps" | ...

Formato de archivo, especificado como una de las opciones de estas tablas.

Archivo de imagen

Un archivo de imágenes contiene 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.

En esta tabla se enumeran los formatos de imagen compatibles.

Opción	Formato de imagen	Extensión de archivo correspondiente
"-djpeg"	JPEG de 24 bits	.jpg
"-dpng"	PNG de 24 bits	.png
"-dtiff"	TIFF de 24 bits (comprimido)	.tif
"-dtiffn"	TIFF de 24 bits (no comprimido)	.tif
"-dmeta"	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. No obstante, otras aplicaciones solo admiten el cambio de tamaño de los gráficos. En general, intente hacer todos los cambios necesarios mientras la figura esté en MATLAB^®.

Normalmente, print 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 garantizar que print cree todo el contenido de gráficos vectoriales, especifique el argumento de entrada "-vector".

Si desea que la salida tenga transparencia, cree un archivo de gráficos vectoriales con un formato de metarchivo, PDF o SVG. Si utiliza un formato EPS, la transparencia solo se admite para el fondo de la figura y los ejes. Los archivos de imagen no admiten la transparencia, pero se asemejarán en gran medida a lo que se muestra en la pantalla para dar la apariencia de transparencia.

En esta tabla se enumeran los formatos de gráficos vectoriales compatibles.

Opción	Formato de gráficos vectoriales	Extensión de archivo correspondiente
"-dpdf"	Página completa de formato de documento portátil (PDF) color	.pdf
"-deps"	Encapsulated PostScript (EPS) nivel 3 blanco y negro	.eps
"-depsc"	Encapsulated PostScript (EPS) nivel 3 color	.eps
"-deps2"	Encapsulated PostScript (EPS) nivel 2 blanco y negro	.eps
"-depsc2"	Encapsulated PostScript (EPS) nivel 2 color	.eps
"-dmeta"	Enhanced Metafile (solo Windows®)	.emf
"-dsvg"	SVG (Scalable Vector Graphics)	.svg

No puede guardar diagramas de bloques de Simulink como archivos EPS.

Nota

Solo el formato PDF utiliza los primeros dos elementos de la propiedad PaperPosition. Otros formatos ignoran estos valores.

formatoptions — Otras opciones de formato

"-tiff" | "-loose" | "-cmyk"

Otras opciones de formato compatibles con algunos formatos de archivo, especificadas como uno o varios de estos valores:

• "-tiff": incluye una vista previa TIFF (solo archivos EPS).

• "-loose": utiliza un cuadro delimitador sin ajuste al contorno (solo archivos EPS).

• "-cmyk": utiliza colores CMYK en lugar de colores RGB (solo archivos EPS).

Nota

Se ha eliminado la opción "-append" para archivos .PS. (desde R2025a)

Ejemplo: print("myfile","-deps","-tiff","-loose") guarda la figura actual en el archivo myfile.eps utilizando un cuadro delimitador sin ajuste al contorno e incluye una vista previa TIFF.

printer — Nombre de impresora

vector de caracteres | cadena

Nombre de impresora, especificado como vector de caracteres o cadena que contiene -P y el nombre de la impresora.

Ejemplo: "-Pmy local printer"

Ejemplo: "-Pmy local printer"

Si no especifica una impresora, print utiliza la impresora predeterminada del sistema. Si desea configurar una impresora nueva o seleccionar una impresora predeterminada diferente, utilice las utilidades de gestión de impresoras del sistema operativo. Reinicie MATLAB si no ve ninguna impresora ya configurada.

Tipos de datos: char | string

driver — Driver de la impresora

"-dwin" | "-dwinc" | "-dprn" | "-dprnc"

Driver de la impresora, especificado como "-dwin", "-dwinc", "-dprn" o "-dprnc". Si no especifica un driver, print utiliza el driver predeterminado del sistema operativo.

La opción utilizada depende del sistema, por ejemplo:

Sistema	Driver	Salida
Windows	"-dwin"	Blanco y negro
	"-dwinc"	Color
Linux® o Mac	"-dprn"	Blanco y negro
	"-dprnc"	Color

clipboardformat — Formato copiado al portapapeles

-dmeta | -dbitmap | -dpdf

Formato copiado al portapapeles, especificado como una de las siguientes opciones:

• "-dmeta": metarchivo mejorado (solo Windows)

• "-dbitmap": archivo de imagen (Windows y macOS)

• "-dpdf": archivo PDF (Windows y macOS)

resize — Opción para expandir la figura para que se ajuste a la página

"-fillpage" | "-bestfit"

Opción para expandir la figura para que se ajuste a la página, especificada como uno de estos valores:

• "-fillpage": maximiza el tamaño de la figura para que se ajuste a la página. Deja un margen de 0,25 pulgadas en todos los lados de la página. Las marcas de graduación, el diseño y la relación de aspecto de la figura pueden cambiar.

• "-bestfit": maximiza el tamaño de la figura para que se ajuste a la página, pero mantiene la relación de aspecto de la figura. Es posible que la figura no se ajuste a la página. Esta opción deja un margen de página mínimo de 0,25 pulgadas.

Estas opciones son solo válidas cuando se imprime una figura en una impresora o se guarda en un formato de página como PDF y PS. No son válidas para diagramas de bloques de Simulink.

resolution — Resolución

vector de caracteres | cadena

Resolución, especificada como vector de caracteres o cadena que contiene -r y un valor entero que indica la resolución en puntos por pulgada. Por ejemplo, "-r300" establece la resolución de salida en 300 puntos por pulgada. Para especificar la resolución de la pantalla, utilice "-r0".

En general, si se utiliza un valor de mayor resolución, se obtiene una salida de mayor calidad, pero a costa de un mayor uso de la memoria y archivos de salida más grandes. Cuanto mayor sea el ajuste de resolución, más se tardará en renderizar la figura.

Especificar la resolución resulta útil cuando se crea una imagen y, en algunos casos, cuando se crea un archivo de gráficos vectoriales. Algunos archivos de gráficos vectoriales incluyen contenido de imágenes que puede verse afectado por la resolución. Si el contenido incluye únicamente gráficos vectoriales, por ejemplo, si especifica la opción "-vector", la resolución no tiene ningún efecto.

Nota

La impresión en Simulink no admite la opción de resolución. Para una salida de mayor calidad en modelos de Simulink, utilice un formato vectorial como SVG o PDF.

Tipos de datos: char | string

contenttype — Tipo de contenido

"-image" | "-vector"

Tipo de contenido, especificado como "-image" o "-vector".

• "-image": utilice esta opción cuando guarde imágenes.

• "-vector": crea todo el contenido del archivo de salida como gráficos vectoriales. Especifique este valor para guardar archivos de gráficos vectoriales. Por ejemplo:

  print("-vector","-deps","myVectorFile")

Nota

Si guarda un archivo con la opción "-vector", podría producirse uno o varios de los siguientes problemas:

• Tiempos de renderizado más largos

• Disposición incorrecta de objetos de gráficas en vistas 3D

• Líneas sueltas

• Líneas que desaparecen si tienen un grosor inferior a un píxel

Si no especifica el tipo de contenido, print selecciona un tipo de contenido para producir el formato de salida solicitado. Algunos formatos de gráficos vectoriales, como PDF y EPS, pueden incluir contenido no vectorial (imagen).

fig — Figura, diagrama de bloques de Simulink

objeto de figura | diagrama de bloques de Simulink

Objeto de figura o diagrama de bloques de Simulink. Puede hacer referencia a una figura utilizando su nombre de variable de objeto o el número de figura precedido por -f. Por ejemplo, -f2 hace referencia a la figura con un valor de 2 en la propiedad Number. Cuando especifica un diagrama de bloques de Simulink, el nombre del modelo debe ir precedido de -s. Especifique el modelo actual utilizando "-s".

No puede guardar diagramas de bloques de Simulink como archivos EPS.

Argumentos de salida

cdata — Datos de imágenes

arreglo de n por m por 3

Datos de imágenes, devueltos como un arreglo de n por m por 3. El tamaño del arreglo de los datos de imágenes depende de la propiedad PaperPosition de la figura y de la resolución de salida.

Limitaciones

• En MATLAB Online™, print imprime en un PDF en lugar de imprimir en una impresora. No obstante, puede guardar la figura como otro tipo de archivo especificando un argumento filename.

• Cuando MATLAB no está en un modo de visualización, todas las funcionalidades de impresión de Simulink, incluyendo la impresión en un archivo, están desactivadas.

Más acerca de

Figura actual

Normalmente, la figura actual es la última figura creada o la última figura en la que ha hecho clic con el ratón. La interacción del usuario puede modificar cuál es la figura actual.

Para imprimir una figura determinada, especifique la figura como primer argumento de entrada. Si no especifica una figura, la función print actúa sobre la figura devuelta por gcbf. Si gcbf no devuelve ningún resultado, print actúa sobre la figura devuelta por gcf.

Sugerencias

• Puede establecer las propiedades de la figura para controlar algunos parámetros de impresión y almacenamiento. En esta tabla se enumeran las propiedades de la figura relacionadas con la impresión y el almacenamiento.

  Propiedad de la figura	Descripción
  PaperPosition	Tamaño de la figura impresa o guardada. Cuando imprima en una impresora o un formato de salida de página completa, esta propiedad también determina la ubicación de la figura en la página.
  PaperPositionMode	Especifica si se usa la propiedad PaperPosition o el tamaño de la figura en la pantalla para establecer el tamaño de la figura impresa o guardada.
  PaperOrientation	Orientación de la figura en la página impresa.
  PaperType	Tamaño de papel estándar de la impresora.
  PaperSize	Ancho y altura personalizados del papel de la impresora.
  PaperUnits	Unidades para las propiedades PaperSize y PaperPosition.

• Si utiliza un sistema Linux o Mac y obtiene un error sobre una impresora no válida o no reconocida, guarde el contenido de la figura como archivo PDF. Por ejemplo:

  print("MyPlot.pdf","-dpdf")

  Después, imprima el archivo PDF usando un visualizador PDF externo.

Funcionalidad alternativa

La función exportgraphics guarda el contenido 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.

exportgraphics es una alternativa mejor a la función print 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 PDF multipágina (desde R2021b)

• Guardar un subconjunto del contenido en la figura

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

La función copygraphics proporciona características muy similares a la función exportgraphics, excepto que copia el contenido al portapapeles del sistema en lugar de guardarlo en un archivo. Utilice esta función para copiar y pegar contenido de MATLAB en otras aplicaciones.

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 print 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 no tiene efecto sobre la salida producida por la función print.

La propiedad InvertHardCopy de una figura no tiene efecto. Si llama a la función print para guardar una figura en un archivo o copiarla en el portapapeles, 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 print, la salida usa el color que especifique independientemente del tema.

Si llama a la función print para imprimir una copia en formato físico, el color de fondo es blanco (sin tinta) de forma predeterminada. Si establece la propiedad Color de la figura, la salida usa ese color.

R2025a: El callback SizeChangedFcn de la figura ya no se ejecuta

Si escribe un callback SizeChangedFcn para una figura, el callback ya no se ejecuta cuando llama a la función print.

R2025a: Los componentes de la IU y los contenedores ya no se admiten

La función print ya no admite figuras que contengan componentes de la IU, como botones y controles deslizantes, o contenedores, como paneles y pestañas.

Para exportar una figura que contenga componentes de la IU o contenedores, 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 JPG.

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 print 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 print 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")

También puede utilizar la función exportgraphics para añadir la salida a un archivo PDF existente.

exportgraphics(gcf,"existingfile.pdf",Append=true)

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

plot([0 3 2 4 1]);
print("myplot.eps","-depsc")

Antes de R2025a: Consulte print (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 print 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

La función print ya no admite los formatos de archivo BMP, HDF, PBM, PCX, PGM, y PPM.

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 print (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 print emite una advertencia cuando se exporta una figura a uno de estos formatos de archivo.

R2021b: Entre las opciones print, no se recomienda -opengl ni -painters

Las siguientes opciones print ya no se recomiendan. No hay planes para eliminar los valores y seguirán comportándose de la misma manera que en versiones anteriores. En la siguiente tabla se enumeran las opciones de sustitución recomendadas.

No recomendado	Opción de sustitución
Opción de renderizador -opengl. Por ejemplo: print("-opengl","-dpdf","myfigure.pdf")	Utilice la opción -image. Por ejemplo: print("-image","-dpdf","myfigure.pdf")
Opción de renderizador -painters. Por ejemplo: print("-painters","-dpdf","myfigure.pdf")	Utilice la opción -vector. Por ejemplo: print("-vector","-dpdf","myfigure.pdf")

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

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

Consulte también

savefig | saveas | copygraphics | exportgraphics | getframe | sprintf

Temas

• Compare Ways to Export Graphics from Figures