eyes regions Tracks regions in an image.

Converts an image to a list of regions. Tracks these regions over time. Calculates location, size velocity, extents, age. Matches regions from one frame to the next.

Inlets & Arguments:
#
Name
Arg
Description
1
image
n/a
Eyes Image, standard operator messages see: eyes messages
2
threshold 1
t,lo
Turns adaptive backgrounding on and off.
0=off
1=on.
3
threshold 2
t2,hi
Attempts to preserve the image intensity values. (Doesn't work well in practice)
4
operator
op
Number of frames used to integrate in order to obtain a background.
c = (f[0] + f[1] + ... + f[n])/n. Where c is the integrated background and f[x] is a frame in time, and n is the number of frames to integrate.
5
maximum number of regions
max
Once frames are integrated, this is the percentage of that image that is integrated into the current background.
Greator =1
Lower =2
Inside =3
Outside =4
NotEqual =5
6
minimum region size
mns
Minimum size of regions to track.
7
maximum region size
mxs
Maximum size of regions to track.
8
connectivity
c
Determines how regions are constructed. Specifies how neighboring pixels are grouped together to form blobs.
4 = 4-connected (left, right, top, and bottom pixels are grouped if within threshold)
8 = 8-connected (4-connected but with corner pixels included)
-1 through -8 = one direction trace in one of eight directions:
-1 -2 -3
-4 pix -5
-6 -7 -8
0 or any other value: use inlet 9 to determine a window around the pixel to search for like pixels to group into a blob.
9
window
w
If connectivity is 0, use this value to determine the size of an area around each pixel to find like pixels to group into blobs.
10
matching on/off
m
Turns region matching on or off. Region matching is used to match blobs from the previous frame to the current frame. Matching is based upon how close blobs are spatially.
0 = off
1 = on
11
matching window
mw
Percentage of the frame size represnting how far away matching regions can be matched.
12
region latency
l
Helps with blob matching. If a region/blob doesn't match in the current frame, it can be made to "hang around" for a little bit in case a match happens to crop up. Region latency determines how long a blob will hang around when it doesn't match any blobs in the current frame.

Outlets:
#
Name Description
1
region marked image Image with regions marked with id colors.
2
region sizes and locations Size and location of each region found as a Max list of integers.
3
region list Region list data type. Represents a list of regions and values associated with them such as size, location, velocity, etc.

Messages:

Standard messages
Accepts all messages sent to the eyes object. See eyes messages.

Argument messages
Accepts all inlet arguments as messages.

Example:

See Also:
rsizesel, rparse, color, compact, background, threshold