bwunpack

Unpack binary image

Syntax

BW = bwunpack(BWP,m)

Description

BW = bwunpack(BWP,m) unpacks the packed binary image BWP into binary image BW with m rows.

Examples

Pack, Dilate, and Unpack Binary Image

Read binary image into the workspace.

BW = imread('text.png');
imshow(BW)

Pack the image.

BWp = bwpack(BW);

Dilate the packed image.

BWp_dilated = imdilate(BWp,ones(3,3),'ispacked');

Unpack the dilated image and display it.

BW_dilated = bwunpack(BWp_dilated, size(BW,1));
imshow(BW_dilated)

Input Arguments

BWP — Packed binary image

2-D numeric matrix

Packed binary image, specified as a 2-D numeric array of data type uint32.

Data Types: uint32

m — Number of image rows

positive integer

Number of image rows, specified as a positive integer. The default value of m is 32*size(BWP,1).

Data Types: uint32

Output Arguments

BW — Unpacked binary image

m-by-n logical matrix

Unpacked binary image, returned as a logical matrix with m rows.

Data Types: logical

Algorithms

When bwunpack unpacks BWP, the function maps the least significant bit of the first row of BWP to the first pixel in the first row of BW. The most significant bit of the first element of BWP maps to the first pixel in the 32nd row of BW, and so on.

Extended Capabilities

C/C++ Code Generation

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

Usage notes and limitations:

• bwunpack supports the generation of C code (requires MATLAB^® Coder™). Note that if you choose the generic MATLAB Host Computer target platform, bwunpack generates code that uses a precompiled, platform-specific shared library. Use of a shared library preserves performance optimizations but limits the target platforms for which code can be generated. For more information, see Types of Code Generation Support in Image Processing Toolbox.

• When generating code, all input arguments must be compile-time constants.

GPU Code Generation

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

Usage notes and limitations:

• When generating code, all input arguments must be compile-time constants.

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.

Version History

Introduced before R2006a

R2022b: Support for thread-based environments

bwunpack now supports thread-based environments.