Main Content

im2uint8

Convert image to 8-bit unsigned integers

所有的页面崩溃

Syntax

J = im2uint8(I)
J = im2uint8(I,'indexed')

Description

example

J= im2uint8(I)converts the grayscale, RGB, or binary imageItouint8, rescaling or offsetting the data as necessary.

If the input image is of classuint8, then the output image is identical. If the input image is of classlogical, thenim2uint8changes true-valued elements to 255.

J= im2uint8(I,'indexed')converts the indexed imageItouint8, offsetting the data if necessary.

Examples

collapse all

Open Live Script

Create an array of classuint16.

I = reshape(uint16(linspace(0,65535,25)),[5 5])
I =5x5 uint16 matrix0 13653 27306 40959 54613 2731 16384 30037 43690 57343 5461 19114 32768 46421 60074 8192 21845 35498 49151 62804 10923 24576 38229 51882 65535

Convert the array to classuint8.

I2 = im2uint8(I)
I2 =5x5 uint8 matrix0 53 106 159 213 11 64 117 170 223 21 74 128 181 234 32 85 138 191 244 43 96 149 202 255

Input Arguments

collapse all

Input image, specified as a numeric array or logical array of any size and dimension.

  • IfIis a grayscale or RGB image, then it can beuint8,uint16,double,logical,single, orint16. The intensity values for input image of classsingleordoublemust be in the range [0, 1].

    Note

    IfIis of classsingleordoublewith values outside the range [0, 1] then you can userescalefunction to rescale values to the expected range.

  • IfIis an indexed image, then it can beuint8,uint16,doubleorlogical.

    Note

    It is not always possible to convert an indexed image touint8. If the indexed image is of classdouble, then the maximum value must be 256 or less. If the indexed image is of classuint16, then the maximum value must be 255 or less.

  • IfIis a binary image, then it must belogical.

Data Types:single|double|int16|uint8|uint16|logical

Output Arguments

collapse all

Image with classuint8, returned as a numeric array of the same size as the input imageI.

Data Types:uint8

Extended Capabilities

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

Introduced before R2006a

See Also

||||