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.

imshow

Sintaxis

imshow(I)
imshow(I,[low high])
imshow(I,[])
imshow(RGB)
imshow(BW)
imshow(X,map)
imshow(filename)
imshow(___,Name,Value)
himage = imshow(___)
imshow(I,RI)
imshow(X,RX,map)
imshow(gpuarrayIM,___)

Descripción

ejemplo

imshow(I) muestra la imagen de escala de grises I en una figura. imshow optimiza la figura, los ejes y las propiedades de los objetos de imagen para la visualización de imágenes.

imshow(I,[low high]) muestra la imagen de escala de grises I, especificando el rango de visualización como un vector de dos elementos, [low high]. Para obtener más información, consulte el parámetro DisplayRange .

imshow(I,[]) muestra la Ide imagen de escala de grises, ampliando la visualización basándose en el intervalo de valores de píxel de I. imshow utiliza [min(I(:)) max(I(:))] como rango de visualización. imshow muestra el valor mínimo en I como negro y el valor máximo como blanco. Para obtener más información, consulte el parámetro DisplayRange .

ejemplo

imshow(RGB) muestra la imagen truecolor RGB en una figura.

ejemplo

imshow(BW) muestra la imagen binaria BW en una figura. Para las imágenes binarias, imshow muestra los píxeles con el valor 0 (cero) como negro y 1 como blanco.

ejemplo

imshow(X,map) muestra la imagen indexada X con el colores map. Una matriz colores puede tener cualquier número de filas, pero debe tener exactamente 3 columnas. Cada fila se interpreta como un color, con el primer elemento que especifica la intensidad de rojo, el segundo verde, y el tercer azul. La intensidad del color se puede especificar en el intervalo 0,0 a 1,0.

ejemplo

imshow(filename) muestra la imagen almacenada en el archivo gráfico especificado por filename.

imshow(___,Name,Value) muestra una imagen, utilizando pares nombre-valor para controlar los aspectos de la operación.

himage = imshow(___) Devuelve el objeto Image creado por imshow.

imshow(I,RI) muestra la imagen I con el objeto de referencia espacial 2-D asociado RI.

imshow(X,RX,map) muestra la imagen indexada X con el objeto de referencia espacial 2-D asociado RX y colores map.

imshow(gpuarrayIM,___) muestra la imagen contenida en un gpuArray. Esta sintaxis requiere el Parallel Computing Toolbox™.

Ejemplos

contraer todo

Muestra una imagen en escala de grises, RGB, indexada o binaria utilizando imshow. MATLAB incluye un archivo TIF, denominado corn.tif, que contiene tres imágenes: una imagen en escala de grises, una imagen indexada y una imagen TrueColor (RGB).

Mostrar una imagen en escala de grises

Lea la imagen en escala de grises del archivo corn.tif en el espacio de trabajo de MATLAB. La versión en escala de grises de la imagen es la tercera imagen del archivo.

corn_gray = imread('corn.tif',3);

Visualice la imagen en escala de grises utilizando imshow.

imshow(corn_gray)

Mostrar una imagen indexada

Lea la imagen indexada del archivo corn.tif en el espacio de trabajo de MATLAB. La versión indexada de la imagen es la primera imagen del archivo.

[corn_indexed,map] = imread('corn.tif',1);

Visualice la imagen en escala de grises utilizando imshow.

imshow(corn_indexed,map)

Mostrar una imagen de TrueColor (RGB)

Lea la imagen TrueColor (RGB) del archivo corn.tif en el espacio de trabajo de MATLAB. La versión TrueColor (RGB) de la imagen es la segunda imagen del archivo.

[corn_rgb] = imread('corn.tif',2);

Visualice la imagen en escala de grises utilizando imshow.

imshow(corn_rgb)

Mostrar una imagen binaria

Lea la imagen en escala de grises del archivo corn.tif en el espacio de trabajo de MATLAB y utilice umbrales para convertirla en una imagen binaria. La versión en escala de grises de la imagen es la tercera imagen del archivo.

[corn_gray] = imread('corn.tif',3);

Determine el valor medio de los píxeles en la imagen en escala de grises.

meanIntensity = mean(corn_gray(:));

Cree una imagen binaria mediante umbrales, utilizando el valor de intensidad media como umbral.

corn_binary = corn_gray > meanIntensity;

Muestra la imagen binaria usando imshow.

imshow(corn_binary)

Mostrar una imagen almacenada en un archivo.

imshow('peppers.png');

Lea una imagen de ejemplo indexada, corn.tif, en el espacio de trabajo y, a continuación, mostrarla.

[X,map] = imread('corn.tif'); imshow(X,map)

Cambie el colores de la imagen mediante la función colormap y especifique los ejes de destino como el primer argumento de entrada. Utilice el colores original sin el componente rojo.

newmap = map; newmap(:,1) = 0; colormap(gca,newmap)

Lea la imagen en el espacio de trabajo.

I = imread('pout.tif');

Mostrar la imagen. Nota los límites de los ejes reflejan el tamaño de la imagen.

figure; imshow(I)

Crear un objeto de referencia espacial asociado a la imagen. Utilice el objeto de referencia para establecer los límites de los ejes x e y en el sistema de coordenadas mundial.

RI = imref2d(size(I)); RI.XWorldLimits = [0 3]; RI.YWorldLimits = [2 5];

Mostrar la imagen, especificando el objeto de referencia espacial. Tenga en cuenta el cambio en los límites de los ejes x e y.

figure; imshow(I,RI);

Lea la imagen en un gpuArray.

X = gpuArray(imread('pout.tif')); 

Mostrarlo.

figure; imshow(X)

Argumentos de entrada

contraer todo

Imagen de escala de grises de entrada, especificada como matriz. Una imagen en escala de grises puede ser cualquier tipo de datos numérico.

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

Input truecolor Image, especificada como un array m-por-n-por-3.

Tipos de datos: single | double | uint8 | uint16

Entrada de imagen binaria, especificada como una matriz.

Tipos de datos: logical

Imagen indexada, especificada como una matriz en 2-D de valores numéricos reales. Los valores en X son índices en el colores especificado por map.

Tipos de datos: single | double | uint8 | logical

Colores, especificada como un array m-por-3 de tipo single o double en el rango [0 1], o una matriz m-por-3 de tipo uint8. Cada fila especifica un valor de color RGB.

Tipos de datos: single | double | uint8

Nombre de archivo, especificado como un vector de carácter. La imagen debe ser legible por imread. La función imshow muestra la imagen, pero no almacena los datos de la imagen en el espacio de trabajo MATLAB® . Si el archivo contiene varias imágenes, imshow muestra la primera imagen del archivo.

Ejemplo: imshow('peppers.png')

Tipos de datos: char

Rango de visualización de imágenes en escala de grises, especificado como vector de dos elementos. Para obtener más información, vea el argumento 'DisplayRange' name-value Pair.

Ejemplo: [50 250]

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

objeto de referencia espacial 2-D asociado a la imagen de entrada, especificada como un objeto imref2d .

objeto de referencia espacial 2-D asociado a una imagen indizada, especificada como un objeto imref2d .

Imagen que se procesará en una unidad de procesamiento de gráficos (GPU), especificada como gpuArray.

Argumentos de par nombre-valor

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

Ejemplo: imshow('board.tif','Border','tight')

Figura espacio de borde de ventana, especificado como el par separado por comas consistente en 'Border' y 'tight' o 'loose'. Cuando se establece en 'loose', la ventana de la figura incluye espacio alrededor de la imagen en la figura. Cuando se establece en 'tight', la ventana de la figura no incluye ningún espacio alrededor de la imagen en la figura.

Si la imagen es muy pequeña o si la figura contiene otros objetos además de una imagen y sus ejes, imshow podría utilizar un borde independientemente de cómo se establezca este parámetro.

Ejemplo: imshow('board.tif','Border','tight')

Tipos de datos: char

Colores, especificada como el par separado por comas consistente en 'Colormap' y una matriz de mpor 3. imshow utiliza esto para establecer el colores de los ejes. Utilice este parámetro para ver imágenes en escala de grises en color falso. Si especifica un colores vacío ([]), imshow omite este parámetro.

Nota

A partir de R2016b, imshow cambia el colores de los ejes que contiene la imagen en lugar de la figura.

Ejemplo: newmap = copper; imshow('board.tif','Colormap',newmap)

Tipos de datos: double

Rango de visualización de una imagen en escala de grises, especificada como un vector de dos elementos del formulario [low high]. La función imshow muestra el valor low (y cualquier valor menor que low) como negro, y muestra el valor high (y cualquier valor mayor que high) como blanco. Los valores entre low y high se muestran como sombras intermedias de gris, utilizando el número predeterminado de niveles de grises. Si especifica una matriz vacía ([]), imshow utiliza [min(I(:)) max(I(:))]. En otras palabras, utilice el valor mínimo en I como negro, y el valor máximo como blanco.

Nota

Incluir el nombre de parámetro es opcional, excepto cuando la imagen se especifica mediante un nombre de archivo. La sintaxis imshow(I,[low high]) equivale a imshow(I,'DisplayRange',[low high]). Si llama a imshow con un nombre de archivo, debe especificar el parámetro 'DisplayRange' .

Ejemplo: h = imshow(I,'DisplayRange',[0 80]);

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

Aumento inicial de la visualización de la imagen, especificada como el par separado por comas consistente en 'InitialMagnification' y un escalar numérico o 'fit'. Si se establece en 100, entonces imshow muestra la imagen a 100% de ampliación (un píxel de pantalla para cada píxel de imagen). Si se establece en 'fit', entonces imshow escala toda la imagen para que quepa en la ventana.

Inicialmente, imshow siempre muestra toda la imagen. Si el valor de ampliación es tan grande que la imagen es demasiado grande para mostrarla en la pantalla, imshow advierte y muestra la imagen en la ampliación más grande que encaja en la pantalla.

Si la imagen se muestra en una figura con su propiedad 'WindowStyle' establecida en 'docked', imshow advierte y muestra la imagen en el aumento más grande que encaja en la figura.

Nota: Si especifica la posición de los ejes (mediante subplot o axes), imshow omite cualquier aumento inicial que haya especificado y por defecto el comportamiento 'fit' .

Cuando se utiliza imshow con el parámetro 'Reduce' , el aumento inicial debe ser 'fit'.

Ejemplo: h = imshow(I,'InitialMagnification','fit');

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

Ejes primarios del objeto Image, especificados como pares separados por comas que consisten en 'Parent' y un objeto de ejes. Utilice el argumento 'Parent' name-value para crear una interfaz de usuario que le proporcione el control de las propiedades de la figura y de los ejes.

Indicador para la imagen de submuestreo, especificada como el par separado por comas consistente en 'Reduce' y true, false, 1o 0. Este argumento sólo es válido cuando se utiliza con el nombre de un archivo TIFF. Utilice el argumento Reduce para mostrar vistas previas de imágenes muy grandes.

Tipos de datos: logical

Límites del eje X del sistema de coordenadas no predeterminados, especificados como pares separados por comas que consisten en 'XData' y un vector de dos elementos. Este argumento establece un sistema de coordenadas espaciales no predeterminados especificando la imagen XData. El valor puede tener más de dos elementos, pero imshow utiliza sólo los elementos primero y último.

Ejemplo: 'XData',[100 200]

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

Límites del eje Y del sistema de coordenadas no predeterminados, especificados como pares separados por comas que consisten en 'YData' y un vector de dos elementos. El valor puede tener más de dos elementos, pero imshow utiliza sólo los elementos primero y último.

Ejemplo: 'YData',[100 200]

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

Argumentos de salida

contraer todo

Imagen creada por imshow, especificada como un objeto Image.

Sugerencias

  • Para cambiar el colores después de crear la imagen, utilice el comando colormap . Especifique los ejes que contienen la imagen como el primer argumento de entrada y el colores que desea como el segundo argumento de entrada. Para obtener un ejemplo, consulte Cambiar colores de imagen visualizada.

  • Puede mostrar varias imágenes con diferentes colormaps en la misma figura utilizando imshow con la función subplot .

  • Si tiene Image Processing Toolbox™, puede utilizar la aplicación Image Viewer como un entorno integrado para mostrar imágenes y realizar tareas comunes de procesamiento de imágenes.

  • Si tiene Image Processing Toolbox, puede utilizar la función iptsetpref para establecer las preferencias del cuadro de herramientas que modifican el comportamiento de imshow.

  • La función imshow no se admite cuando se inicia MATLAB con la opción -nojvm .

Consulte también

| | | | |

Introducido antes de R2006a