print

Imprimir figura o guardar en 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(renderer,___)

print('-noui',___)

print(fig,___)

cdata = print('-RGBImage');

Descripción

print(filename,formattype) guarda la figura actual de Figura actual en un archivo utilizando el formato de archivo especificado, como print('BarPlot','-dpng'). Si el nombre del archivo no incluye una extensión, print anexa la correspondiente.

print(filename,formattype,formatoptions) especifica opciones adicionales disponibles para algunos formatos.

print imprime la cifra actual en la impresora predeterminada.

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

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

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

print('-clipboard',clipboardformat) copia la figura actual en el Portapapeles utilizando el formato especificado por clipboardformat. Puede pegar la figura copiada en otras aplicaciones.

print(resize,___) maximiza el tamaño de la figura para rellenar la página. Especifique resize como '-bestfit' para preservar la relación de aspecto de la figura o '-fillpage' para ignorar la proporción de aspecto. Estas opciones sólo son válidas cuando se guardan en un formato de página (PDF y PS) o se imprime 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 un vector o cadena de caracteres 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(renderer,___) utiliza el renderizador especificado. Especifique el renderizador como '-painters' o '-opengl'.

print('-noui',___) excluye los controles de interfaz de usuario, como los botones de pulsación y los deslizadores, de la salida guardada o impresa. No excluye los objetos de interfaz de usuario que pueden contener un eje, como un uitab o UIPanel.

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

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

Ejemplos

Copia impresa en papel de la figura

Cree un gráfico de barras e imprima a la impresora predeterminada del sistema. Si no especifica la figura que se imprimirá, print utiliza la cifra actual.

bar(1:10)
print

Copiar figura en el portapapeles

Cree una trama y copiela en el Portapapeles del sistema.

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

Puede pegar la trama copiada en otras aplicaciones.

Guardar figura como archivo de imagen

Cree un diagrama y guárdelo como un archivo de imagen PNG.

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

print guarda la trama como BarPlot.png.

Guardar figura como archivo de gráficos vectoriales

Cree un trazado y guárdelo como un archivo PostScript^® encapsulado.

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

print guarda la trama como BarPlot.eps.

Agregar vista previa TIFF al archivo EPS

Guarde la figura actual como un archivo encapsuladoPostScript^® y agregue una vista previa TIFF.

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

Especificar figura para guardar

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

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

Como alternativa, consulte 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 la figura. Por ejemplo, guarde la figura con Figure 2 que se muestra en la barra de título. Precede el valor entero por -f.

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

Guardar figura en tamaño de pantalla y resolución

Guarde una trama de superficie en un archivo PNG. Establezca la propiedad PaperPositionMode para la figura en 'auto' para que se guarde en el tamaño que se muestra en la pantalla. Utilice '-r0' para guardarlo con resolución de pantalla.

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

Guardar figura que rellena la página

Guarde una cifra que rellena la página mediante la opción '-fillpage' .

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

Guardar cifra sin guardar UIControls

Crear una figura con un pulsador que borra los ejes. Guarde la figura en un archivo JPEG sin guardar el botón pulsador.

surf(peaks)
uicontrol('Style','pushbutton','String','Clear',...
    'Position',[20 20 50 20],'Callback','cla');
print('SurfacePlot','-djpeg','-noui')

Devolver datos de imagen RGB para la figura

Devuelve los datos de imagen RGB de una cifra.

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

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

figure
imshow(cdata)

Argumentos de entrada

filename — Nombre de archivo

Vector de caracteres | Cadena

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

Ejemplo: 'My Saved Chart'

Ejemplo: 'Folder\My Saved Chart'

Ejemplo: "My Saved Chart"

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

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 de mapa de bits

Las imágenes de mapa de bits 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 del sistema. Las imágenes de mapa de bits son ampliamente utilizadas por los navegadores web y otras aplicaciones que muestran gráficos. Sin embargo, no se escalan bien y no se pueden modificar objetos gráficos individuales, como líneas y texto, en otras aplicaciones gráficas.

En esta tabla se muestran los formatos de imagen de mapa de bits compatibles.

Opción	Formato de imagen de mapa de bits	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 (sólo para Windows)	.emf
'-dbmpmono'	BMP monocromo	.bmp
'-dbmp'	BMP de 24 bits	.bmp
'-dbmp16m'	BMP de 24 bits	.bmp
'-dbmp256'	BMP de 8 bits (256 color, utiliza un colores fijo)	.bmp
'-dhdf'	HDF 24-bit	.hdf
'-dpbm'	PBM (formato llano) de 1 bit	.pbm
'-dpbmraw'	PBM (formato RAW) de 1 bit	.pbm
'-dpcxmono'	PCX 1-bit	.pcx
'-dpcx24b'	PCX de 24 bits de color (tres planos de 8 bits)	.pcx
'-dpcx256'	PCX de 8 bits más nuevo color (256 color)	.pcx
'-dpcx16'	PCX más viejo color (EGA/VGA 16-color)	.pcx
'-dpgm'	PGM (formato llano)	.pgm
'-dpgmraw'	PGM (formato RAW)	.pgm
'-dppm'	PPM (formato llano)	.ppm
'-dppmraw'	PPM (formato RAW)	.ppm

Archivo de gráficos vectoriales

Los archivos gráficos vectoriales almacenan comandos que redibujan la figura. Este tipo de formato escala bien, pero puede resultar en un archivo grande. También, puede ser que no produzca la disposición tridimensional correcta de objetos en ciertos casos. Algunas aplicaciones soportan la edición extensiva de formatos de gráficos vectoriales. Sin embargo, algunas aplicaciones no admiten la edición más allá de cambiar el tamaño del gráfico. En general, intente realizar todos los cambios necesarios mientras su figura sigue en MATLAB^®.

Si establece la propiedad Renderer para la figura, print utiliza ese renderizador al generar el resultado. De lo contrario, print elige el renderizador adecuado. Normalmente, print utiliza el renderizador de pintores al generar archivos gráficos vectoriales. Para algunas cifras complejas, print utiliza en su lugar el renderizador OpenGL^® . Si utiliza el representador OpenGL , el archivo de gráficos vectoriales contiene una imagen incrustada, que podría limitar el grado en que puede editar la imagen en otras aplicaciones. Para asegurarse de que print utiliza el renderizador de pintores, establezca la propiedad Renderer para la figura en 'painters' o especifique '-painters' como argumento de entrada para print.

Nota

El renderizador de figura predeterminado es OpenGL. Si el renderizador de figuras difiere del renderizador usado al generar la salida, algunos detalles de la figura guardada pueden diferir de la figura en la pantalla. Si es necesario, puede hacer que la figura mostrada y la figura guardada utilicen el mismo renderizador. Establezca la propiedad Renderer para la figura o especifique el argumento de entrada renderer en la función print .

Esta tabla muestra los formatos de gráficos vectoriales soportados.

Opción	Formato de gráficos vectoriales	Extensión de archivo correspondiente
'-dpdf'	Formato de documento portable de la página completa (pdf) color	.pdf
'-deps'	Encapsulado PostScript (EPS) nivel 3 blanco y negro	.eps
'-depsc'	Color de nivel 3 encapsulado PostScript (EPS)	.eps
'-deps2'	Encapsulado PostScript (EPS) nivel 2 blanco y negro	.eps
'-depsc2'	Color de nivel 2 encapsulado PostScript (EPS)	.eps
'-dmeta'	Metarchivo mejorado (sóloWindows® )	.emf
'-dsvg'	SVG (gráficos vectoriales escalables)	.svg
'-dps'	Página completa PostScript (PS) nivel 3 blanco y negro	.ps
'-dpsc'	Color de nivel 3 de página completa PostScript (PS)	.ps
'-dps2'	Full-page PostScript (PS) nivel 2 blanco y negro	.ps
'-dpsc2'	Color de nivel 2 de página completa PostScript (PS)	.ps

No se pueden guardar los diagramas de bloque Simulink en los formatos PostScript o EPS.

Nota

Sólo los formatos PDF y PS utilizan la propiedad PaperOrientation de la figura y los elementos left y bottom de la propiedad PaperPosition . Otros formatos ignoran estos valores.

formatoptions — Opciones de formato adicionales

'-tiff' | '-loose' | '-cmyk' | '-append'

Opciones de formato adicionales admitidas por algunos formatos de archivo, especificados como uno o más de estos valores:

• '-tiff' : Incluye una vista previa de TIFF. Sólo archivos EPS.

• '-loose' : Utilice un cuadro delimitador suelto. Sólo archivos EPS y PS.

• '-cmyk' : Utilice colores CMYK en lugar de colores RGB. Sólo archivos EPS y PS.

• '-append' : Anexar la figura a un archivo PS existente. Sólo archivos PS.

Ejemplo: print('my file','-deps','-tiff','-loose') guarda la figura actual en el archivo my file.eps mediante un cuadro delimitador suelto e incluye una vista previa TIFF.

printer — Nombre de la impresora

Vector de caracteres | Cadena

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

Ejemplo: '-Pmy local printer'

Ejemplo: "-Pmy local printer"

Para ver una lista de impresoras disponibles, utilice este comando:

[~,printers] = findprinters

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 administración de impresoras del sistema operativo. Reinicie MATLAB si no ve una impresora que ya está configurada.

Tipos de datos: char | string

driver — Controlador de impresora

'-dwin' | '-dwinc' | '-dprn' | '-dprnc'

Controlador de impresora, especificado como '-dwin', '-dwinc', '-dprn'o '-dprnc'. Si no especifica un controlador, print utiliza el controlador devuelto por la función printopt .

La opción que utilice dependerá de su sistema, por ejemplo:

Sistema	Conductor	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 en el portapapeles, especificado como una de estas opciones:

• '-dmeta' : Metarchivo mejorado (sóloWindows )

• '-dbitmap' : Imagen de mapa de bits (Windows y Mac OS X)

• '-dpdf' — Archivo PDF (Windows y Mac OS X)

resize — Opción para expandir la figura para rellenar página

'-fillpage' | '-bestfit'

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

• '-fillpage' : Maximiza el tamaño de la figura para rellenar la página. Deje un margen de .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 podrían cambiar.

• '-bestfit' : Maximiza el tamaño de la figura para rellenar la página, pero conserva la proporción de aspecto de la figura. Es posible que la cifra no rellene toda la página. Esta opción deja un margen de página mínimo de. 25 pulgadas.

Ambas opciones son válidas sólo cuando se imprime una figura en una impresora o se guarda en un formato de página como PDF y PS. No son válidos para los diagramas de bloque de Simulink .

resolution — Resolución

Vector de caracteres | Cadena

Resolución, especificada como un vector de caracteres o una 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, el uso de un valor de resolución más alto rinde una salida de mayor calidad, pero a costa de un mayor uso de memoria y archivos de salida más grandes. Cuanto mayor sea el ajuste de resolución, más tardará en renderizar su figura. Por defecto, la resolución es 90 dpi para los modelos Simulink y 150 dpi para las cifras. Para la salida típica de la impresora láser, la resolución predeterminada de 150 dpi para las cifras es normalmente adecuada. Sin embargo, si usted está preparando las cifras para la impresión de alta calidad, como un libro de texto o folletos de color, es posible que desee utilizar 200 dpi o 300 dpi. La resolución puede ser limitada por las capacidades de la impresora.

La especificación de la resolución resulta útil al crear una imagen de mapa de bits o al utilizar el representador OpenGL con un formato de archivo de gráficos vectoriales (dado que OpenGL produce una imagen de mapa de bits incluso con formatos vectoriales). La especificación de la resolución no tiene ningún efecto cuando se utiliza el renderizador de pintores con un formato de archivo de gráficos vectoriales, ya que los pintores producen un verdadero archivo de gráficos vectoriales que contiene los comandos que redibujan la figura.

Tipos de datos: char | string

renderer — Renderizador de gráficos

'-opengl' | '-painters'

Renderizador de gráficos, especificado como '-opengl' o '-painters'.

• '-opengl' : OpenGL renderizador. Utilice este renderizador cuando guarde imágenes de mapa de bits. OpenGL produce una imagen de mapa de bits incluso con formatos vectoriales, lo que podría limitar el grado en que se puede editar la imagen en otras aplicaciones.

• '-painters' — Pintores renderizadores. Utilice este renderizador cuando guarde archivos gráficos vectoriales. Si guarda en un archivo de gráficos vectoriales y si la propiedad figura RendererMode se establece en 'auto', print intenta utilizar automáticamente el renderizador de pintores. Si desea asegurarse de que el formato de salida es un verdadero archivo de gráficos vectoriales, especifique el renderizador de pintores. Por ejemplo, este programa genera un número entero al azar, y si es par lo divide por 2:

  print('-painters','-deps','myVectorFile')

Nota

A veces, guardar un archivo con la opción '-painters' puede causar tiempos de procesamiento más largos y, en raras ocasiones, puede que no organice con precisión objetos gráficos en vistas 3D. Además, el renderizador de pintores no puede imprimir o guardar líneas más delgadas que un píxel.

Si no especifica el renderizador, print utiliza automáticamente el renderizador apropiado para producir el formato de salida solicitado. Sin embargo, si establece la propiedad Renderer para la figura, print utiliza ese renderizador al generar el resultado.

fig — Figura, diagrama de bloque de Simulink

Figura (objeto) | diagrama de bloques

Figura objeto o diagrama de bloque de Simulink . Puede hacer referencia a una figura utilizando el nombre de la variable de objeto o utilizando el número de la figura precedido por -f. Por ejemplo, -f2 hace referencia a la figura con un valor de la propiedad Number de 2. Al especificar un diagrama de bloque Simulink , preceda el nombre del modelo con -s. Especifique el modelo actual mediante '-s'.

No se pueden guardar los diagramas de bloque Simulink en los formatos PostScript o EPS.

Argumentos de salida

cdata — Datos de imágenes

matriz n-por-m-por-3

Datos de imagen, devueltos como una matriz n-por-m-por-3. El tamaño de la matriz de datos de imagen depende de la propiedad PaperPosition de la figura y de la resolución de salida.

Nota

A partir de R2015b, si utiliza print con la opción '-r0' en un sistema de alta resolución, el tamaño de la matriz de salida cdata es mayor que en las versiones anteriores o en otros Sistemas. Además, el número de elementos en cdata podrían no coincidir con el tamaño de la figura en píxeles basándose en la propiedad PaperPositionde y la propiedad ScreenPixelsPerInch de la raíz. Para obtener más información, vea Comportamiento consciente de DPI enMATLAB.

Limitaciones

• print no admite la captura de controles ActiveX^® .

• Al iniciar MATLAB en ningún modo de visualización en Linux o mediante la opción de inicio -noFigureWindows de cualquier plataforma, las limitaciones de printson:

  • Imprimir o guardar figuras con errores uicontrols visibles. Para imprimir o guardar la figura, oculte el uicontrols estableciendo sus propiedades Visible en 'off'o utilice la opción '-noui' con la función print .

  • Siempre utiliza el renderizador de pintores, incluso si especifica la opción '-opengl' .

Más acerca de

Figura actual

La cifra actual es típicamente la última figura que se crea o se hace clic con el mouse. La interacción del usuario puede cambiar la cifra actual.

Para imprimir una figura específica, especifique la figura como el primer argumento de entrada. Si no especifica una figura, la función print actúa sobre la figura devuelta por gcbf. Si gcbf devuelve vacío, print actúa sobre la cifra devuelta por gcf.

Consideraciones sobre compatibilidad

Comenzando en R2016a, las figuras imprimidas y guardadas emparejan el tamaño de la figura en la pantalla por defecto. Anteriormente, las figuras impresas y guardadas eran de 8 por 6 pulgadas por defecto.

Sugerencias

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

  Figure (propiedad)	Descripción
  PaperPosition	Tamaño de la figura impresa o guardada. Si se imprime en una impresora o en 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 utiliza la propiedad PaperPosition o el tamaño de la figura de la pantalla para establecer el tamaño de la figura impresa o guardada.
  InvertHardcopy	Especifica si se debe utilizar el color de fondo actual de la figura o cambiar el color de fondo a blanco al imprimir o guardar la figura.
  PaperOrientation	Figura orientación en la página impresa.
  PaperType	Tamaño estándar del papel de la impresora.
  PaperSize	Anchura y altura de encargo del papel de la impresora.
  PaperUnits	Unidades para las propiedades PaperSize y PaperPosition .

• Si utiliza un sistema Linux o Mac y obtiene un error acerca de una impresora no válida o no reconocida, a continuación, intente especificar un controlador PostScript para la opción driver . Si la impresora admite PostScript Level 3, pruebe '-dps' para blanco y negro o '-dpsc' para el color. Si la impresora admite PostScript nivel 2, pruebe '-dps2' para blanco y negro o '-dps2c' para el color. Por ejemplo, este programa genera un número entero al azar, y si es par lo divide por 2:

  print('-dpsc','-Pmy printer')

  Para utilizar este controlador como controlador predeterminado, edite el archivo printopt . Como alternativa, imprima la figura en un archivo PDF. A continuación, imprima el PDF desde un visor externo de PDF.

• Si imprime una cifra que tiene una devolución de llamada definida para la propiedad SizeChangedFcn y si el tamaño de salida difiere del tamaño de la figura de la pantalla, la función print muestra un mensaje de advertencia. Para evitar el mensaje de advertencia, establezca la propiedad PaperPositionMode para la figura en 'auto'.

Consulte también

getframe | saveas | savefig

Introducido antes de R2006a