im2uint8 — Convert images to uint8 in MATLAB and RunMat.
im2uint8(I) converts image data to uint8 using MATLAB image-scaling rules. Floating data in [0, 1] maps to [0, 255].
Syntax
J = im2uint8(I)
J = im2uint8(I, "indexed")Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
I | Any | Yes | — | Image data to convert. |
I | Any | Yes | — | Indexed image data to convert. |
indexed | StringScalar | Yes | — | The literal "indexed", selecting indexed-image offset semantics. |
Returns
| Name | Type | Description |
|---|---|---|
J | NumericArray | Converted image data in uint8 class. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:im2uint8:TooManyInputs | More than two input arguments are supplied. | im2uint8: too many input arguments |
RunMat:im2uint8:InvalidInput | Input cannot be gathered or interpreted for image conversion. | im2uint8: invalid input |
RunMat:im2uint8:UnsupportedInputType | Input type is outside supported numeric/logical image classes. | im2uint8: unsupported input type |
RunMat:im2uint8:Internal | Internal conversion step fails while building output tensor. | im2uint8: internal conversion failure |
How im2uint8 works
- Floating-point inputs are clamped to [0,1], multiplied by 255, and rounded.
- uint16 inputs are rescaled from [0,65535] to [0,255].
Example
Convert Double Image
J = im2uint8(I);Expected output:
% J is uint8 image dataUsing im2uint8 with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how im2uint8 changes the result.
Run a small im2uint8 example, explain the result, then change one input and compare the output.
Related Image functions
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how im2uint8 is executed, line by line, in Rust.
- View the source for im2uint8 in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.