im2single

Convert image to single precision

Syntax

J = im2single(I)

J = im2single(I,'indexed')

Description

J = im2single(I) converts the grayscale, RGB, or binary image I to single, rescaling or offsetting the data as necessary.

If the input image is of class single, then the output image is identical. If the input image is of class logical, then im2single changes true-valued elements to 65535.

J = im2single(I,'indexed') converts the indexed image I to single, offsetting the data if necessary.

Examples

Convert Array to Data Type Single

This example shows how to convert an array of data type uint8 into data type single.

Create a numeric array of data type uint8.

I = reshape(uint8(linspace(1,255,25)),[5 5])

I = 5×5 uint8 matrix

     1    54   107   160   213
    12    65   117   170   223
    22    75   128   181   234
    33    86   139   192   244
    43    96   149   202   255

Convert the array to data type single.

I2 = im2single(I)

I2 = 5×5 single matrix

    0.0039    0.2118    0.4196    0.6275    0.8353
    0.0471    0.2549    0.4588    0.6667    0.8745
    0.0863    0.2941    0.5020    0.7098    0.9176
    0.1294    0.3373    0.5451    0.7529    0.9569
    0.1686    0.3765    0.5843    0.7922    1.0000

Input Arguments

I — Input image

numeric array | logical array

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

• If I is a grayscale or RGB image, then it can be uint8, uint16, double, logical, single, or int16.

• If I is an indexed image, then it can be uint8, uint16, double or logical.

• If I is a binary image, then it must be logical.

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

Output Arguments

J — Image with class single

numeric array

Image with class single, returned as a numeric array of the same size as the input image I.

Data Types: single

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

im2single supports the generation of C and C++ code (requires MATLAB^® Coder™). For more information, see Code Generation for Image Processing.

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

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

This function fully supports GPU arrays. For more information, see Image Processing on a GPU.

Version History

Introduced before R2006a

R2021b: Support for thread-based environments

im2single now supports thread-based environments.