bwunpack (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Unpack binary image

Syntax

```
BW = bwunpack(BWP,M)
```

Description

BW = bwunpack(BWP,M) unpacks the packed binary image BWP. BWP is a uint32 array. When it unpacks BWP, bwunpack 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. BW is M-by-N, where N is the number of columns of BWP. If M is omitted, its default value is 32*size(BWP,1).

Binary image packing is used to accelerate some binary morphological operations, such as dilation and erosion. If the input to imdilate or imerode is a packed binary image, the functions use a specialized routine to perform the operation faster.

bwpack is used to create packed binary images.

Class Support

BWP is of class uint32 and must be real, 2-D, and nonsparse. The return value BW is of class uint8.

Example

Pack, dilate, and unpack a binary image.

bw = imread('text.png');
bwp = bwpack(bw);
bwp_dilated = imdilate(bwp,ones(3,3),'ispacked');
bw_dilated = bwunpack(bwp_dilated, size(bw,1));

See Also

bwpack, imdilate, imerode

bwulterode checkerboard