Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

imwrite

Escribir imagen en un archivo de gráficos

Sintaxis

imwrite(A,filename)

imwrite(A,map,filename)

imwrite(___,fmt)

imwrite(___,Name,Value)

Descripción

imwrite(A,filename) escribe los datos de imagen A en el archivo especificado por filename, infiriendo el formato de archivo de la extensión. imwrite crea el nuevo archivo en la carpeta actual. La profundidad de bits de la imagen de salida depende del tipo de datos de A y del formato de archivo. Para la mayoría de los formatos:

• Si A es de tipo de datos uint8, imwrite emite valores de 8 bits.

• Si A es de tipo de datos uint16 y el formato de archivo de salida admite datos de 16 bits (JPEG, PNG y TIFF), imwrite emite valores de 16 bits. Si el formato de archivo de salida no admite datos de 16 bits, imwrite devuelve un error.

• Si A es una imagen en escala de grises o en color RGB del tipo de datos double o single, entonces imwrite asume que el rango dinámico es [0,1] y escala automáticamente los datos por 255 antes de escribirlos en el archivo como valores de 8 bits. Si los datos de A son single, convierta A en double antes de escribir en un archivo GIF o TIFF.

• Si A es de tipo de datos logical, a continuación, imwrite supone que los datos son una imagen binaria y lo escribe en el archivo con una profundidad de bits de 1, si el formato lo permite. Los formatos BMP, PNG o TIFF aceptan imágenes binarias como matrices de entrada.

Si A contiene datos de imagen indizados, debe especificar además el argumento de entrada map .

imwrite(A,map,filename) escribe la imagen indexada en A y su colores asociado, map, al archivo especificado por filename.

• Si A es una imagen indizada de tipo de datos double o single, entonces imwrite convierte los índices a índices basados en cero restando 1 de cada elemento y, a continuación, escribe los datos como uint8. Si los datos de A son single, convierta A en double antes de escribir en un archivo GIF o TIFF.

imwrite(___,fmt) escribe la imagen en el formato especificado por fmt, independientemente de la extensión de archivo en filename. Puede especificar fmt después de los argumentos de entrada en cualquiera de las sintaxis anteriores.

imwrite(___,Name,Value) especifica parámetros adicionales para los archivos GIF, HDF, JPEG, PBM, PGM, PNG, ppm y TIFF de salida, utilizando uno o varios argumentos de par nombre-valor. Puede especificar Name,Value después de los argumentos de entrada en cualquiera de las sintaxis anteriores.

Ejemplos

Escribir imagen de escala de grises en PNG

Escriba una matriz 50-by-50 de valores de escala de grises en un archivo PNG de la carpeta actual.

A = rand(50);
imwrite(A,'myGray.png')

Escribir datos de imágenes indizadas en PNG

Escriba un array de imagen indexado y su colores asociado a un archivo PNG.

Cargue los datos de imagen de ejemplo del archivo, clown.mat.

load clown.mat

La matriz de imágenes X y su colores asociado, map, se cargan en el espacio de trabajo MATLAB^® .

Escriba los datos en un nuevo archivo PNG.

imwrite(X,map,'myclown.png')

imwrite crea el archivo, myclown.png, en la carpeta actual.

Vea el nuevo archivo abriéndolo fuera de MATLAB.

Escribir imagen indizada con MATLAB colores

Escriba datos de imagen en un nuevo archivo PNG con el MATLAB colores, copperintegrado.

Cargue los datos de imagen de ejemplo del archivo clown.mat.

load clown.mat

La matriz de imágenes X y su colores asociado, map, se cargan en el espacio de trabajo MATLAB . map es una matriz de vectores 81 RGB.

Defina un colores de tono de cobre con 81 vectores RGB. A continuación, escriba los datos de la imagen en un archivo PNG utilizando el nuevo colores.

newmap = copper(81);
imwrite(X,newmap,'copperclown.png');

imwrite crea el archivo, copperclown.png, en la carpeta actual.

Vea el nuevo archivo abriéndolo fuera de MATLAB.

Escribir truecolor imagen a JPEG

Crear y escribir datos de imagen truecolor en un archivo JPEG.

Cree una matriz 49-by-49-by-3 de valores RGB aleatorios.

A = rand(49,49);
A(:,:,2) = rand(49,49);
A(:,:,3) = rand(49,49);

Escriba los datos de la imagen en un archivo JPEG, especificando el formato de salida mediante 'jpg'. Agregue un comentario al archivo mediante el argumento 'Comment' name-value Pair.

imwrite(A,'newImage.jpg','jpg','Comment','My JPEG file')

Ver información sobre el nuevo archivo.

imfinfo('newImage.jpg')

ans = 

           Filename: 'S:\newImage.jpg'
        FileModDate: '25-Jan-2013 16:18:41'
           FileSize: 2339
             Format: 'jpg'
      FormatVersion: ''
              Width: 49
             Height: 49
           BitDepth: 24
          ColorType: 'truecolor'
    FormatSignature: ''
    NumberOfSamples: 3
       CodingMethod: 'Huffman'
      CodingProcess: 'Sequential'
            Comment: {'My JPEG file'}

Escribir varias imágenes en el archivo TIFF

Escriba varias imágenes en un solo archivo TIFF multipágina.

Cree dos conjuntos de datos de imagen aleatorios, im1 y im2.

im1 = rand(50,40,3);
im2 = rand(50,50,3);

Escriba la primera imagen en un archivo TIFF nuevo. A continuación, añada la segunda imagen al mismo archivo.

imwrite(im1,'myMultipageFile.tif')
imwrite(im2,'myMultipageFile.tif','WriteMode','append')

Escribir GIF animado

Dibuje una serie de gráficas, capturelas como imágenes y escribirlas en un archivo GIF animado.

Plot para .

x = 0:0.01:1;
n = 3;
y = x.^n;
plot(x,y,'LineWidth',3)
title(['y = x^n,  n = ' num2str(n) ])

Capture una serie de parcelas para aumentar los valores de .

n = 1:0.5:5;
nImages = length(n);

fig = figure;
for idx = 1:nImages
    y = x.^n(idx);
    plot(x,y,'LineWidth',3)
    title(['y = x^n,  n = ' num2str( n(idx)) ])
    drawnow
    frame = getframe(fig);
    im{idx} = frame2im(frame);
end
close;

Mostrar la serie de imágenes en una sola figura.

figure;
for idx = 1:nImages
    subplot(3,3,idx)
    imshow(im{idx});
end

Guarde las nueve imágenes en un archivo GIF. Dado que los datos de tres dimensiones no son compatibles con los archivos GIF, llame a rgb2ind para convertir los datos RGB de la imagen en una imagen indizada A con un colores map. Para anexar varias imágenes a la primera imagen, llame a imwrite con el argumento name-value Pair 'WriteMode','append'.

filename = 'testAnimated.gif'; % Specify the output file name
for idx = 1:nImages
    [A,map] = rgb2ind(im{idx},256);
    if idx == 1
        imwrite(A,map,filename,'gif','LoopCount',Inf,'DelayTime',1);
    else
        imwrite(A,map,filename,'gif','WriteMode','append','DelayTime',1);
    end
end

imwrite escribe el archivo GIF en la carpeta actual. Par nombre-valor 'LoopCount',Inf hace que la animación se bucle continuamente. 'DelayTime',1 especifica un retardo de 1 segundo entre la visualización de cada imagen de la animación.

Argumentos de entrada

A — Datos de imagen para escribir

Matriz

Datos de imagen para escribir, especificados como una matriz completa (no Sparse).

• Para las imágenes en escala de grises, A puede ser m-by-n.

• Para las imágenes indizadas, A puede ser m-by-n. Especifique el colores asociado en el argumento de entrada map .

• Para las imágenes truecolor, A debe ser m-by-n-by-3. imwrite no admite la escritura de imágenes RGB en archivos GIF.

Para los archivos TIFF, A puede ser un array m-by-n-by-4 que contiene datos de color que utiliza el espacio de color CMYK.

Para archivos GIF multiframe, A puede ser un array m-by-n-by-1-by-p que contiene imágenes en escala de grises o indexadas, donde p es el número de fotogramas que se deben escribir. En este caso no se admiten imágenes RGB.

Tipos de datos: double | single | uint8 | uint16 | logical

filename — Nombre del archivo de salida

Vector de caracteres

Nombre del archivo de salida, incluida la extensión de archivo, especificada como vector de caracteres. Para obtener una lista de los tipos de imagen que imwrite puede escribir, vea la descripción del argumento de entrada fmt .

Ejemplo: 'myFile.gif'

Tipos de datos: char

map — Colores de la imagen indexada

m -por-3 array

Colores se asoció a datos de imagen indexados en A, especificado como un array m-by-3. map debe ser un colores MATLAB válido. Vea colormap para obtener una lista de MATLAB colormaps. La mayoría de los formatos de archivo de imagen no admiten colormaps con más de 256 entradas.

Ejemplo: [0,0,0;0.5,0.5,0.5;1,1,1]

Ejemplo: jet(60)

Tipos de datos: double

fmt — Formato del archivo de salida

'bmp' | 'gif' | 'hdf' | 'jpg' | 'jp2' | ...

Formato del archivo de salida, especificado como uno de los formatos de esta tabla.

Esta tabla también resume los tipos de imágenes que imwrite puede escribir. El registro de formato de archivo MATLAB determina qué formatos de archivo se admiten. Vea imformats para obtener más información acerca de este registro.

Para ciertos formatos, imwrite puede aceptar argumentos adicionales de pares de nombre y valor. Para ver estos argumentos, haga clic en los nombres de formato vinculados a continuación.

Valor de fmt	Formato del archivo de salida	Descripción
'bmp'	Windows mapa de bits De ® (BMP)	imágenes sin comprimir de 1 bit, 8 bits y 24 bits
'gif'	GIF — formato de intercambio de gráficos	imágenes de 8 bits
'hdf'	HDF4 — formato de datos jerárquicos	conjuntos de datos de imágenes rasterizadas de 8 bits con o sin colores asociados, conjuntos de datos de imagen rasterizada de 24 bits
o	JPEG — grupo mixto de expertos en fotografía	imágenes JPEG de base de 8 bits, 12 bits y 16 bits Nota imwrite convierte imágenes indexadas en RGB antes de escribir datos en archivos JPEG, ya que el formato JPEG no admite imágenes indizadas.
o	JPEG 2000 — grupo de expertos fotográficos conjuntos 2000	imágenes de 1 bits, 8 bits y JPEG 2000 de 16 bits
'pbm'	Mapa de bits portátil (PBM)	Cualquier imagen de PBM de 1 bit, codificación ASCII (simple) o RAW (binario)
'pcx'	Windows pincel ® (PCX)	imágenes de 8 bits
'pgm'	Graymap portable (PGM)	Cualquier imagen estándar de PGM; ASCII (llano) codificado con la profundidad de color arbitraria; RAW (binario) codificado con hasta 16 bits por valor de gris
'png'	PNG: gráficos de red portátiles	imágenes en escala de grises de 1, 2 bits, 4 bits, 8 bits y 16 bits; imágenes en escala de grises de 8 y 16 bits con canales alfa; imágenes indexadas de 1, 2 bits, 4 bits y 8 bits; imágenes truecolor de 24 bits y 48 bits; imágenes truecolor de 24 bits y 48 bits con canales alfa
'pnm'	AnyMap portable (PNM)	Cualquiera de los formatos ppm/PGM/PBM, elegidos automáticamente
'ppm'	Pixmap portable (ppm)	Cualquier imagen estándar de ppm: ASCII (llano) codificado con profundidad de color arbitraria o RAW (binario) codificado con hasta 16 bits por componente de color
'ras'	Sun ™ Raster (RAS)	Cualquier imagen de Ras, incluyendo un mapa de bits de 1 bit, un índice de 8 bits indexado, un truecolor de 24 bits y un truecolor de bits de 32 con Alpha
o	Formato de archivo de imagen etiquetado (TIFF)	Imágenes TIFF de base, que incluyen: imágenes y imágenes sin comprimir de 1 bit, 8 bits, 16 bits, 24 bits y 48 bits con compresión Packbits, LZW o desinflar imágenes de 1 bit con la compresión CCITT 1D, grupo 3 y grupo 4 Imágenes CIELAB, ICCLAB y CMYK
'xwd'	X volcado de Windows (XWD)	8-bit ZPixmaps

Argumentos de par nombre-valor

Ejemplo: imwrite(A,'myFile.png','BitDepth',8) escribe los datos en A utilizando 8 bits para representar cada píxel.

GIF — formato de intercambio de gráficos

'BackgroundColor' — Color a utilizar como color de fondo

entero escalar

Color que se utiliza como color de fondo para la imagen indizada, especificada como el par separado por comas consistente en 'BackgroundColor' y un entero escalar correspondiente al índice colores.

El color de fondo se utiliza para algunos métodos de eliminación en GIFs animados.

• Si los datos de imagen A son uint8 o logical, el índice colores se basa en cero.

• Si los datos de imagen A son double, el índice colores se basa en uno.

El color de fondo predeterminado corresponde al primer color del colores.

Ejemplo: 'BackgroundColor',15

'Comment' — Comentario para agregar a la imagen

Vector de caracteres | matriz de celdas de vectores de caracteres

Comentario para agregar a la imagen, especificada como el par separado por comas consistente en 'Comment' y un vector de caracteres o una matriz de celdas de 1 porn de vectores de caracteres. Para una matriz de vectores de caracteres, imwrite agrega un retorno de carro después de cada vector de carácter.

Ejemplo: 'Comment',{'Sample #314','January 5, 2013'}

Tipos de datos: char | cell

'DelayTime' — Demora antes de mostrar la siguiente imagen

0.5 (predeterminado) | valor escalar en el rango [0655]

Demora antes de mostrar la siguiente imagen, en segundos, especificada como el par separado por comas consistente en 'DelayTime' y un valor escalar en el intervalo [0655]. Un valor de 0 muestra las imágenes tan rápido como el hardware lo permite.

Ejemplo: 'DelayTime',60

'DisposalMethod' — Método de eliminación de GIF animado

'doNotSpecify' (predeterminado) | 'leaveInPlace' | 'restoreBG' | 'restorePrevious'

Método de eliminación de un GIF animado, especificado como el par separado por comas consistente en 'DisposalMethod' y uno de los métodos de esta tabla.

Valor de DisposalMethod	Resultado
'doNotSpecify' (valor predeterminado)	Reemplace un marco de tamaño completo y no transparente con otro.
'leaveInPlace'	Los píxeles que no estén cubiertos por el siguiente fotograma seguirán mostrandose.
'restoreBG'	El color de fondo o el azulejo de fondo muestra a través de píxeles transparentes.
'restorePrevious'	Restaurar al estado de un marco anterior, no dispuesto.

Ejemplo: 'DisposalMethod','restoreBG'

'Location' — Desplazamiento de la pantalla en relación con la imagen

[0,0] (predeterminado) | Vector de dos elementos

Desplazamiento de la pantalla en relación con la imagen, medida desde la esquina superior izquierda de cada una, especificada como el par separado por comas consistente en 'Location' y un vector de dos elementos. El primer elemento vectorial especifica el desvío desde la parte superior, y el segundo elemento especifica el desvío de la izquierda, en píxeles.

Ejemplo: 'Location',[10,15]

Tipos de datos: double

'LoopCount' — Número de veces para repetir la animación

Inf (predeterminado) | entero en el intervalo [0,65535]

Número de veces para repetir la animación, especificada como el par separado por comas que consiste en 'LoopCount' y un entero en el intervalo [0,65535]o el valor Inf. Si especifica 0, la animación se reproducirá una vez. Si especifica el valor 1, la animación se reproducirá dos veces, y así sucesivamente. Un valor de LoopCount de Inf hace que la animación se bucle continuamente.

Para habilitar la animación dentro de Microsoft^® PowerPoint^® , especifique un valor para 'LoopCount' dentro del intervalo [1, 65535]. Algunas aplicaciones de Microsoft interpretan el valor 0 para significar no bucle en absoluto.

Ejemplo: 'LoopCount',3

'ScreenSize' — Altura y anchura del bastidor

altura y anchura de la imagen de entrada (predeterminado) | Vector de dos elementos

Altura y anchura del marco, especificado como el par separado por comas consistente en 'ScreenSize' y un vector de dos elementos. Cuando se utiliza el argumento ScreenSize con 'Location', se proporciona una forma de escribir marcos en la imagen que son más pequeñas que el marco completo. 'DisposalMethod' determina el valor de relleno para los píxeles situados fuera del marco.

Ejemplo: 'ScreenSize',[1000 1060]

Tipos de datos: double

'TransparentColor' — Color a utilizar como color transparente

entero escalar

Color que se utiliza como color transparente para la imagen, especificado como el par separado por comas consistente en 'TransparentColor' y un entero escalar correspondiente al índice colores.

• Si los datos de imagen A son uint8 o logical, la indización comienza en 0.

• Si los datos de imagen A son double, la indización comienza en 1.

Ejemplo: 'TransparentColor',20

'WriteMode' — Modo de escritura

'overwrite' (predeterminado) | 'append'

Modo de escritura, especificado como el par separado por comas consistente en 'WriteMode' y 'overwrite' o 'append'. En el modo overwrite , imwrite sobrescribe un archivo existente,filename. En el modo append , imwrite agrega un único fotograma al archivo existente.

Ejemplo: 'WriteMode','append'

HDF4 — formato de datos jerárquicos

'Compression' — Esquema de compresión

'none' (predeterminado) | 'jpeg' | 'rle'

Esquema de compresión, especificado como el par separado por comas consistente en 'Compression' y una de las opciones de esta tabla.

Valor de Compression	Resultado
'none' (valor predeterminado)	Sin compresión
'jpeg'	Compresión JPEG. Válido sólo para imágenes en escala de grises y RGB.
'rle'	Codificación de longitud de ejecución. Válido sólo para imágenes en escala de grises e indizadas.

Ejemplo: 'Compression','jpeg'

'Quality' — Calidad de archivos comprimidos JPEG

75 (predeterminado) | escalar en el rango [0100]

Calidad del archivo comprimido JPEG, especificado como el par separado por comas consistente en 'Quality' y un escalar en el rango [0100], donde 0 es de menor calidad y mayor compresión, y 100 es de mayor calidad y menor compresión. Este parámetro sólo se aplica si 'Compression' es 'jpeg'.

Ejemplo: 'Quality',25

'WriteMode' — Modo de escritura

'overwrite' (predeterminado) | 'append'

Modo de escritura, especificado como el par separado por comas consistente en 'WriteMode' y 'overwrite' o 'append'. En el modo overwrite , imwrite sobrescribe un archivo existente,filename. En el modo append , imwrite agrega un único fotograma al archivo existente.

Ejemplo: 'WriteMode','append'

JPEG — grupo mixto de expertos en fotografía

'BitDepth' — Número de bits por píxel

8 (predeterminado) | Escalar

Número de bits por píxel, especificado como el par separado por comas consistente en 'BitDepth' y un escalar.

• En las imágenes en escala de grises, el valor de BitDepth puede ser 8, 12 o 16. El valor por defecto es 8. Para las imágenes de 16 bits, el argumento 'Mode' name-value Pair debe ser 'lossless'.

• Para las imágenes en color, el valor de BitDepth es el número de bits por plano y puede ser 8 o 12. El valor predeterminado es de 8 bits por plano.

Ejemplo: 'BitDepth',12

'Comment' — Comentario para agregar a la imagen

Vector de caracteres | array de caracteres | n matriz de celdas -by-1 de vectores de caracteres

Comentario para agregar a la imagen, especificada como el par separado por comas que consiste en 'Comment' y un vector de caracteres, una matriz de caracteres o una matriz de celdas n-by-1 de vectores de caracteres. imwrite escribe cada fila de entrada como un Comentario en el archivo JPEG.

Ejemplo: 'Comment',{'First line';'second line';'third line'}

Tipos de datos: char | cell

'Mode' — Tipo de compresión

'lossy' (predeterminado) | 'lossless'

Tipo de compresión, especificada como el par separado por comas consistente en 'Mode' y una de estas opciones:

• 'lossy'

• 'lossless'

Ejemplo: 'Mode','lossless'

'Quality' — Calidad del archivo de salida

75 (predeterminado) | escalar en el rango [0100]

Calidad del archivo de salida, especificado como el par separado por comas consistente en 'Quality' y un escalar en el rango [0100], donde 0 es de menor calidad y mayor compresión, y 100 es de mayor calidad y menor compresión. Un valor de Quality de 100 no escribe una imagen JPEG sin pérdida. En su lugar, utilice el argumento 'Mode','lossless' name-value Pair.

Ejemplo: 'Quality',100

JPEG 2000 — grupo de expertos fotográficos conjuntos 2000

'Comment' — Comentario para agregar a la imagen

Vector de caracteres | array de caracteres | matriz de celdas de vectores de caracteres

Comentario para agregar a la imagen, especificada como el par separado por comas consistente en 'Comment' y un vector de caracteres, una matriz de caracteres o una matriz de vectores de caracteres. imwrite escribe cada fila de entrada como un Comentario en el archivo JPEG 2000.

Ejemplo: 'Comment',{'First line';'second line';'third line'}

Ejemplo: 'Comment',{'First line','second line','third line'}

Tipos de datos: cell | char

'CompressionRatio' — Ratio de compresión de destino

1 (predeterminado) | Escalar

Ratio de compresión de destino, especificado como el par separado por comas consistente en 'CompressionRatio' y un escalar real mayor o igual a 1. La relación de compresión es la relación entre el tamaño de la imagen de entrada y el tamaño de la salida comprimida. Por ejemplo, un valor de 2,0 implica que el tamaño de la imagen de salida es la mitad del tamaño de la imagen de entrada o menos. Un valor más alto implica un tamaño de archivo más pequeño y una calidad de imagen reducida. La relación de compresión no tiene en cuenta el tamaño del encabezado.

La especificación de CompressionRatio sólo es válida cuando 'Mode' es 'lossy'.

Ejemplo: 'CompressionRatio',3

'Mode' — Tipo de compresión

'lossy' (predeterminado) | 'lossless'

Tipo de compresión, especificada como el par separado por comas consistente en 'Mode' y una de estas opciones:

• 'lossy'

• 'lossless'

Ejemplo: 'Mode','lossless'

'ProgressionOrder' — Orden de los paquetes en la secuencia de código

'LRCP' (predeterminado) | 'RLCP' | 'RPCL' | 'PCRL' | 'CPRL'

Orden de los paquetes en la secuencia de código, especificado como el par separado por comas consistente en 'ProgressionOrder' y una de estas opciones:

• 'LRCP'

• 'RLCP'

• 'RPCL'

• 'PCRL'

• 'CPRL'

Los caracteres representan lo siguiente: L = Layer, R = Resolution, C = Component y P = position.

Ejemplo: 'ProgressionOrder','RLCP'

'QualityLayers' — Número de capas de calidad

1 (predeterminado) | entero en el intervalo [1, 20]

Número de capas de calidad, especificadas como pares separados por comas que consisten en 'QualityLayers' y un entero en el intervalo [1, 20].

Ejemplo: 'QualityLayers',8

'ReductionLevels' — Número de niveles de reducción

4 (predeterminado) | entero en el intervalo [1,8]

Número de niveles de reducción, o niveles de descomposición de onda, especificados como pares separados por comas que consisten en 'ReductionLevels' y un entero en el intervalo [1,8].

Ejemplo: 'ReductionLevels',6

'TileSize' — Altura y anchura del azulejo

tamaño de la imagen (predeterminado) | Vector de dos elementos

Altura y anchura del azulejo, especificada como el par separado por comas consistente en 'TileSize' y un vector de dos elementos. El tamaño mínimo que puede especificar es [128 128].

Ejemplo: 'TileSize',[130 130]

PBM-, PGM-y ppm: mapa de bits portátil, Graymap, Pixmap

'Encoding' — Codificación

'rawbits' (predeterminado) | 'ASCII'

Codificación, especificada como el par separado por comas que consiste en 'Encoding' y 'rawbits' para la codificación binaria, o 'ASCII' para la codificación simple.

Ejemplo: 'Encoding','ASCII'

'MaxValue' — Valor máximo del gris o del color

Escalar

Valor máximo de gris o color, especificado como el par separado por comas consistente en 'MaxValue' y un escalar.

Disponible sólo para archivos PGM y ppm. Para los archivos de PBM, este valor es siempre 1.

Si la matriz de imágenes es uint16, el valor predeterminado de MaxValue es 65535. De lo contrario, el valor predeterminado es 255.

Ejemplo: 'MaxValue',510

PNG: gráficos de red portátiles

'Alpha' — Transparencia de cada píxel

matriz de valores en el intervalo [0,1]

Transparencia de cada píxel, especificado como el par separado por comas conformado por 'Alpha' y una matriz de valores en el intervalo [0,1]. Las dimensiones de fila y columna de la matriz Alpha deben ser las mismas que las de la matriz de datos de la imagen. Puede especificar Alpha sólo para datos de imagen en escala de grises de (m-por-n) y TrueColor de (m-por-n-por-3).

Nota

No se pueden especificar tanto 'Alpha' como 'Transparency' al mismo tiempo.

Tipos de datos: double | uint8 | uint16

'Author' — Información del autor

Vector de caracteres

Información del autor, especificada como el par separado por comas consistente en 'Author' y un vector de caracteres.

Ejemplo: "Author','Ann Smith'

Tipos de datos: char

'Background' — Color de fondo al composición de píxeles transparentes

escalar en el intervalo [0,1] | entero en el intervalo [1,P] | Vector de 3 elementos en el intervalo [0,1]

Color de fondo cuando se componen píxeles transparentes, se especifica como el par separado por comas consistente en 'Background' y un valor dependiente de los datos de la imagen, como se indica a continuación.

Tipo de imagen	Forma del valor de Background
Imágenes en escala de grises	Escalar en el intervalo [0,1].
Imágenes indexadas	Entero en el intervalo [1,P], donde P es la longitud colores. Por ejemplo, 'Background',50 establece el color de fondo en el color especificado por el índice 50 del colores.
Imágenes truecolor	Vector de tres elementos de intensidades RGB en la gama [0,1]. Por ejemplo, 'Background',[0 1 1] establece el color de fondo en cian.

Tipos de datos: double

'BitDepth' — Número de bits por píxel

Escalar

Número de bits por píxel, especificado como el par separado por comas consistente en 'BitDepth' y un escalar. Dependiendo de la imagen de salida, el escalar puede ser uno de los siguientes valores.

Tipo de imagen	Valores permitidos para BitDepth
Imágenes en escala de grises	o
Imágenes en escala de grises con un canal alfa	o
Imágenes indexadas	o
Imágenes truecolor	o

• Si la imagen es de clase double o uint8, la profundidad de bits predeterminada es de 8 bits por píxel.

• Si la imagen es uint16, el valor predeterminado es 16 bits por píxel.

• Si la imagen es logical, el valor predeterminado es 1 bit por píxel.

Ejemplo: 'BitDepth',4

'Chromaticities' — Referencia punto blanco y cromáticas primarias

Vector de 8 elementos

Punto blanco de referencia y cromáticas primarias, especificados como pares separados por comas que consisten en 'Chromaticities' y un vector de 8 elementos, [wx wy rx ry gx gy bx by]. Los elementos wx y gx wy son las coordenadas cromáticas del punto blanco, y los elementos rx, ry, , gy, bxy by son las coordenadas cromáticas de los tres colores primarios.

Si especifica Chromaticities, también debe especificar el argumento par nombre-valor de Gamma .

Ejemplo: 'Chromaticities',[0.312,0.329,0.002,0.002,0.001,0.001,0.115,0.312]

Tipos de datos: double

'Comment' — Comentario para agregar a la imagen

Vector de caracteres

Comentario para agregar a la imagen, especificada como el par separado por comas consistente en 'Comment' y un vector de caracteres.

'Copyright' — Aviso de copyright

Vector de caracteres

Aviso de copyright, especificado como el par separado por comas consistente en 'Copyright' y un vector de caracteres.

'CreationTime' — Tiempo de creación de imágenes originales

Vector de caracteres

Época de la creación original de la imagen, especificada como vector del carácter.

'Description' — Descripción de la imagen

Vector de caracteres

Descripción de la imagen, especificada como el par separado por comas consistente en 'Description' y un vector de caracteres.

'Disclaimer' — Aviso legal

Vector de caracteres

Descargo de responsabilidad legal, especificado como el par separado por comas consistente en 'Disclaimer' y un vector de caracteres.

'Gamma' — Gamma de archivos

Escalar

Gamma de archivos, especificado como el par separado por comas consistente en 'Gamma' y un escalar.

Ejemplo: 'Gamma',2.2

'ImageModTime' — Hora de la última modificación de la imagen

número de fecha de serie | Vector de carácter de una fecha

Hora de la última modificación de la imagen, especificada como el par separado por comas consistente en 'ImageModTime' y un número de fecha de serie MATLAB o un vector de carácter de una fecha que se puede convertir en un vector de fecha mediante el función datevec . Los valores deben estar en la hora universal coordinada (UTC).

El valor predeterminado de ImageModTime es el momento en el que se llama a imwrite.

Ejemplo: 'ImageModTime','17-Jan-2013 11:23:10'

Tipos de datos: double | char

'InterlaceType' — Esquema entrelazado

'none' (predeterminado) | 'adam7'

Esquema de entrelazado, especificado como el par separado por comas consistente en 'InterlaceType' y 'none' para ningún entrelazado, o 'adam7' para utilizar el algoritmo Adam7.

Ejemplo: 'InterlaceType','adam7'

'ResolutionUnit' — Unidad para la resolución de la imagen

'unknown' (predeterminado) | 'meter'

Unidad para la resolución de imagen, especificada como el par separado por comas consistente en 'ResolutionUnit' y 'unknown' o 'meter'. Si especifica ResolutionUnit, debe incluir al menos uno de los argumentos de par de valor de nombre XResolution y YResolution . Cuando el valor de ResolutionUnit es 'meter', los valores de XResolution y YResolution se interpretan en píxeles por metro.

Ejemplo: 'ResolutionUnit','meter','XResolution',1000

'SignificantBits' — Número de bits a considerar como significativos

[] (predeterminado) | Escalar | Vector

Número de bits del array de datos a considerar como significativos, especificados como pares separados por comas que consisten en 'SignificantBits' y un escalar o un vector en el intervalo [1,BitDepth]. Dependiendo del tipo de imagen de salida, el valor debe estar en el siguiente formulario.

Tipo de imagen	Forma del valor de SignificantBits
Imagen en escala de grises sin canal alfa	Escalar
Imagen en escala de grises con un canal alfa	Vector de 2 elementos
Imagen indexada	Vector de 3 elementos
Imagen truecolor sin canal alfa	Vector de 3 elementos
Imagen truecolor con un canal alfa	Vector de 4 elementos

Ejemplo: 'SignificantBits',[2,3]

'Software' — Software utilizado para crear la imagen

Vector de caracteres

Software utilizado para crear la imagen, especificada como el par separado por comas consistente en 'Software' y un vector de caracteres.

'Source' — Dispositivo utilizado para crear la imagen

Vector de caracteres

Dispositivo utilizado para crear la imagen, especificada como el par separado por comas que consta de 'Source' y un vector de carácter.

'Transparency' — Píxeles para considerar transparente

[] (predeterminado) | escalar en el rango [0,1] | Vector

Píxeles que se deben considerar transparentes cuando no se utiliza ningún canal alfa, especificados como pares separados por comas que consisten en 'Transparency' y un escalar o un vector. Dependiendo de la imagen de salida, el valor debe estar en el siguiente formulario.

Tipo de imagen	Forma del valor de Transparency
Imágenes en escala de grises	Escalar en el rango [0,1], indicando que el color de grises se considerará transparente.
Imágenes indexadas	Q- Vector de elemento de valores del intervalo [0,1], donde Q no es mayor que la longitud de colores y cada valor indica la transparencia asociada a la entrada colores correspondiente. En la mayoría de los casos, Q = 1.
Imágenes truecolor	Vector de 3 elementos de intensidades RGB en el rango [0,1], indicando el color truecolor a considerar transparente.

Nota

No se pueden especificar tanto 'Transparency' como 'Alpha' al mismo tiempo.

Ejemplo: 'Transparency',[1 1 1]

Tipos de datos: double

'Warning' — ADVERTENCIA de la naturaleza del contenido

Vector de caracteres

ADVERTENCIA de la naturaleza del contenido, especificada como el par separado por comas consistente en 'Warning' y un vector de caracteres.

'XResolution' — Resolución de imagen en dirección horizontal

Escalar

Resolución de imagen en la dirección horizontal, en píxeles/unidad, especificada como el par separado por comas consistente en 'XResolution' y un escalar. Defina la unidad especificando el argumento ResolutionUnit name-value Pair.

Si no especifica también YResolution, el valor de XResolution se aplica tanto a las direcciones horizontales como verticales.

Ejemplo: 'XResolution',900

'YResolution' — Resolución de imagen en dirección vertical

Escalar

Resolución de imagen en la dirección vertical, en píxeles/unidad, especificada como el par separado por comas consistente en 'XResolution' y un escalar. Defina la unidad especificando el argumento ResolutionUnit name-value Pair.

Si no especifica también XResolution, el valor de YResolution se aplica tanto a las direcciones horizontales como verticales.

Ejemplo: 'YResolution',900

Además de los argumentos del par nombre-valor enumerados para PNG, puede utilizar cualquier nombre de parámetro que satisfaga la especificación PNG para las palabras clave. Es decir, el nombre sólo utiliza caracteres imprimibles, contiene 80 o menos caracteres, y no contiene espacios de interlineado o de finalización. El valor correspondiente a estos nombres especificados por el usuario debe ser un vector de caracteres que no contenga caracteres de control distintos de salto.

RAS — gráfico de trama Sun

'Alpha' — Transparencia de cada píxel

[] (predeterminado) | Matriz

Transparencia de cada píxel, especificado como el par separado por comas consistente en 'Alpha' y una matriz con cotas de fila y columna iguales a las de la matriz de datos de imagen.

Válido sólo para datos de imagen de TrueColor (m-by-n-by-3).

Tipos de datos: double | single | uint8 | uint16

'Type' — Tipo de imagen

'standard' (predeterminado) | 'rgb' | 'rle'

Tipo de imagen, especificado como el par separado por comas consistente en 'Type' y una de las opciones de esta tabla.

Valor de Type	Descripción
'standard' (valor predeterminado)	Descomprimido, orden del color de B-G-R para las imágenes truecolor
'rgb'	No comprimido, orden del color de R-G-B para las imágenes truecolor
'rle	Codificación de longitud de ejecución de imágenes de 1 y 8 bits

Ejemplo: 'Type','rgb'

TIFF: formato de archivo de imagen etiquetado

'ColorSpace' — Espacio de color que representa los datos de color

'rgb' (predeterminado) | 'cielab' | 'icclab'

Espacio de color que representa los datos de color, especificados como pares separados por comas que consisten en 'ColorSpace' y una de estas opciones:

• 'rgb'

• 'cielab'

• 'icclab'

Válido sólo cuando la matriz de datos de imagen, A, es TrueColor (m-by-n-by-3). Para utilizar el espacio de color CMYK en un archivo TIFF, no utilice el argumento 'ColorSpace' name-value Pair. En su lugar, especifique una matriz de datos de imagen m-by-n-by-4.

imwrite puede escribir datos de imagen de color que utilicen el espacio de color L * a * b * en archivos TIFF. La especificación 1976 CIE l * a * b * define valores numéricos que representan información de luminancia (l *) y crominancia (a * y b *). Para almacenar los datos de color de L * a * b * en un archivo TIFF, los valores deben codificarse para que quepan en almacenamiento de información de 8 o 16 bits. imwrite puede almacenar datos de color de L * a * b * en un archivo TIFF mediante las siguientes codificaciones:

• Codificaciones CIELAB: codificaciones de 8 bits y 16 bits definidas por la especificación TIFF

• Codificaciones ICCLAB: codificaciones de 8 bits y 16 bits definidas por el consorcio internacional de color

La clase de salida y la codificación utilizadas por imwrite dependen de la clase de la matriz de datos de imagen de entrada y del valor de ColorSpace , como se muestra en la tabla siguiente. (las codificaciones CIELAB de 8 y 16 bits no pueden ser matrices de entrada porque utilizan una mezcla de valores firmados y no firmados y no se pueden representar como una única matriz MATLAB .)

Clase de entrada y codificación	Valor de ColorSpace	Clase de salida y codificación
8-bit ICCLAB Los valores son enteros en el intervalo [0 255]. Los valores L * se multiplican por 255/100. 128 se agrega a los valores a * y b * .	'icclab'	8-bit ICCLAB
	'cielab'	8-bit CIELAB
ICCLAB de 16 bits Los valores son enteros en el intervalo [0, 65280]. Los valores L * se multiplican por 65280/100. 32768 se agrega a los valores a * y b * , que se representan como enteros en el intervalo [0, 65535].	'icclab'	ICCLAB de 16 bits
	'cielab'	CIELAB de 16 bits
Valores de doble precisión 1976 CIE L * a * b * L * está en el rango dinámico [0, 100]. a * y b * pueden tomar cualquier valor. Al establecer a * y b * a 0 (cero) se produce un color neutro (gris).	'icclab'	8-bit ICCLAB
	'cielab'	8-bit CIELAB

Ejemplo: 'ColorSpace','cielab'

'Compression' — Esquema de compresión

'packbits' | 'none' | 'lzw' | 'deflate' | 'jpeg' | 'ccitt' | 'fax3' | 'fax4'

Esquema de compresión, especificado como el par separado por comas consistente en 'Compression' y una de estas opciones:

• 'packbits' (predeterminado para imágenes no binarias)

• 'none'

• 'lzw'

• 'deflate'

• 'jpeg'

• 'ccitt' (sólo imágenes binarias y el valor predeterminado de dichas imágenes)

• 'fax3' (sólo imágenes binarias)

• 'fax4' (sólo imágenes binarias)

'jpeg' es un esquema de compresión con pérdida; otros modos de compresión son sin pérdida. Además, si especifica 'jpeg' compression, debe especificar el parámetro 'RowsPerStrip' y el valor debe ser un múltiplo de 8.

Ejemplo: 'Compression','none'

'Description' — Descripción de la imagen

Vector de caracteres

Descripción de la imagen, especificada por el par separado por comas consistente en 'Description' y un vector de caracteres. Este es el texto que imfinfo devuelve en el campo ImageDescription de la imagen de salida.

Ejemplo: 'Description','Sample 2A301'

'Resolution' — Resolución X y y

72 (predeterminado) | Escalar | Vector de dos elementos

Resolución x y y, especificada como el par separado por comas consistente en 'Resolution' y un escalar que indica la resolución, o un vector de dos elementos que contiene la resolución X y la resolución y.

Ejemplo: 'Resolution',80

Ejemplo: 'Resolution',[320,72]

Tipos de datos: double

'RowsPerStrip' — Número de filas que se incluirán en cada tira

Escalar

Número de filas que se incluirán en cada tira, especificada como el par separado por comas consistente en 'RowsPerStrip' y un escalar. El valor predeterminado es tal que cada franja es de aproximadamente 8 kilobytes.

Debe especificar RowsPerStrip si especifica la compresión 'jpeg' . El valor debe ser múltiplo de 8.

Ejemplo: 'RowsPerStrip',16

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'WriteMode' — Modo de escritura

'overwrite' (predeterminado) | 'append'

Modo de escritura, especificado como el par separado por comas consistente en 'WriteMode' y 'overwrite' o 'append'. En el modo overwrite , imwrite sobrescribe un archivo existente. En el modo append , imwrite agrega una página al archivo existente.

Ejemplo: 'WriteMode','append'

Sugerencias

• Para obtener información sobre derechos de autor, vea el archivo libtiffcopyright.txt .

Introducido antes de R2006a

×

Open Example (es)

A modified version of this example exists on your system. Do you want to open this version instead? (es)

No, overwrite the modified version (es) Yes (es)