im2uint8

Convertir imágenes en enteros sin signo de 8 bits

Sintaxis

J = im2uint8(I)

J = im2uint8(I,"indexed")

Descripción

J = im2uint8(I) convierte una imagen en escala de grises, RGB o binaria, I a uint8, cambiando la escala o desplazando los datos según sea necesario.

Si la imagen de entrada es del tipo de datos uint8, la imagen de salida es idéntica. Si la imagen de entrada es del tipo de datos logical, im2uint8 cambia los elementos de valor verdadero a 255.

J = im2uint8(I,"indexed") convierte la imagen indexada I en uint8, desplazando los datos si es necesario.

Ejemplos

Convertir un arreglo uint16 en un arreglo uint8

Cree un arreglo de tipo de datos uint16.

I = reshape(uint16(linspace(0,65535,25)),[5 5])

I = 5×5 uint16 matrix

       0   13653   27306   40959   54613
    2731   16384   30037   43690   57343
    5461   19114   32768   46421   60074
    8192   21845   35498   49151   62804
   10923   24576   38229   51882   65535

Convierta el arreglo en el tipo de datos uint8.

I2 = im2uint8(I)

I2 = 5×5 uint8 matrix

     0    53   106   159   213
    11    64   117   170   223
    21    74   128   181   234
    32    85   138   191   244
    43    96   149   202   255

Argumentos de entrada

I — Imagen de entrada

Arreglo numérico | Arreglo lógico

Imagen de entrada, especificada como arreglo numérico o lógico de cualquier tamaño y dimensión.

• Si I es una imagen en escala de grises o RGB, puede ser del tipo de datos uint8, uint16, int16, double, single o logical. La función im2uint8 espera que las imágenes del tipo de datos double y single tengan valores en el intervalo [0, 1]. Si I tiene valores que se sitúan fuera del intervalo [0, 1], puede usar la función rescale para volver a escalar los valores al intervalo previsto.

• Si I es una imagen indexada, puede ser del tipo de datos uint8, uint16, double o logical. Si la imagen indexada es del tipo de datos double, el valor máximo debe ser 256 o menos. Si la imagen indexada es del tipo de datos uint16, el valor máximo debe ser 255 o menos.

• Si I es una imagen binaria, debe ser logical.

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

Argumentos de salida

J — Imagen con tipo de datos uint8

Arreglo numérico

Imagen con tipo de datos uint8, devuelta como arreglo numérico del mismo tamaño que la imagen de entrada I.

Tipos de datos: uint8

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• im2uint8 es compatible con la generación de código C (requiere MATLAB^® Coder™). Tenga en cuenta que, si selecciona la plataforma objetivo genérica MATLAB Host Computer, im2uint8 genera código que utiliza una biblioteca compartida precompilada específica de la plataforma. El uso de una biblioteca compartida mantiene las optimizaciones de rendimiento, pero limita las plataformas objetivo para las que se puede generar código. Para obtener más información, consulte Types of Code Generation Support in Image Processing Toolbox.

Generación de código de GPU
Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos de GPU. Para obtener más información, consulte Procesamiento de imágenes en una GPU.

Historial de versiones

Introducido antes de R2006a

R2021b: Compatibilidad con entornos basados en hilos

Ahora im2uint8 es compatible con los entornos basados en hilos.

Consulte también

im2double | im2int16 | im2single | im2uint16 | uint8