ArrayFire: regions (original) (raw)
Find blobs in given image. More...
| Functions | |
|---|---|
| AFAPI array | regions (const array &in, const af::connectivity connectivity=AF_CONNECTIVITY_4, const dtype type=f32) |
| C++ Interface for getting regions in an image. More... | |
| AFAPI af_err | af_regions (af_array *out, const af_array in, const af_connectivity connectivity, const af_dtype ty) |
| C Interface for regions in an image. More... | |
Find blobs in given image.
Given a binary image (with zero representing background pixels), regions computes a floating point image where each connected component is labeled from 1 to N, the total number of components in the image.
A component is defined as one or more nonzero pixels that are connected by the specified connectivity (either 4-way(AF_CONNECTIVITY_4) or 8-way(AF_CONNECTIVITY_8)) in two dimensions.
An example input and output for 8-connectivity
The default connectivity is AF_CONNECTIVITY_4.
◆ af_regions()
C Interface for regions in an image.
Parameters
| [out] | out | array will have labels indicating different regions |
|---|---|---|
| [in] | in | array should be binary image of type b8 |
| [in] | connectivity | can take one of the following [AF_CONNECTIVITY_4 | AF_CONNECTIVITY_8] |
| [in] | ty | is type of output array |
Returns
AF_SUCCESS if the regions are identified successfully, otherwise an appropriate error code is returned.
C++ Interface for getting regions in an image.
Below given are sample input and output for each type of connectivity value for type
| Example for type == AF_CONNECTIVITY_8 | Example for type == AF_CONNECTIVITY_4 |
|---|---|
| array in(8, 8, input); A multi dimensional data container. @ AF_CONNECTIVITY_8Connectivity includes 4-connectivity neigbors and also those on Northeast, Northwest,... AFAPI array regions(const array &in, const af::connectivity connectivity=AF_CONNECTIVITY_4, const dtype type=f32)C++ Interface for getting regions in an image. | array in(8, 8, input); @ AF_CONNECTIVITY_4Connectivity includes neighbors, North, East, South and West of current pixel. |
Parameters
Returns
returns array with labels indicating different regions. Throws exceptions if any issue occur.