NAME
t2_segment_image - Segments the image into regions
SYNOPSIS
#include "t2/t2_segment.h"
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-I/home/kobus/include
-L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
int t2_segment_image
(
const KJB_image *ip,
Segmentation_t2 **segment_info_ptr_ptr
);
DESCRIPTION
This routine segments an image into regions. The segmentation is done under
the control of a large number of options normally exposed to the user, and
also accessable using kjb_set(). The routine makes minor changes to the image
to ensure consistency between the segmentation and the image. If you do not
want the image to be changed, you MUST make a copy. The routine fills a
structure which includes:
The number of segments
An image size integer array with the segment number at each (i,j)
An array of segments (Type Segment_t2*).
Each segment contains (among other things!):
Pixel count
A list of pixels (values and their coordinates)
Boundary pixel count
A list of boundary pixels
A matrix of outer boudary coordinates IN ORDER
Segment averge R, G, B, r, g, sum_RGB
An array of segment numbers of neighbours
Coordinates of segment center of mass
Coordinates of a pixel inside the segment
RETURNS
The number of image segments on sucess and ERROR on failure.
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTER
Kobus Barnard