MAN page from RedHat Other XITE-3.3-3.i386.rpm
REGIONYLINE
Section: C Library Functions (3)
Updated: 16 Mar 1998
Index
NAME
regionYline - split an image into homogenous regions
SYNTAX
#include <
xite/region.h>
BiffStatus regionYline( IBAND input,
region*** regions, int nc, int sort,
int split, int* size );
DESCRIPTION
Makes a yline representation of the regions in theinput image. At return, the
regionspointer willpoint at an array of region pointers, indexable from0 to
size.Element 0 will always be nil, the otherelements will point at region objects. The input imagedefines regions by the pixel values. All pixels withthe same value belongs to the same object. A
regionis a connected (4- or 8-) set of pixels from the sameobject.
Every region struct has a pointer "ylines" to an arrayof yline pointers. This array is indexable on theinterval region->ymin .. region->ymax. The ylinepointers point to a list of yline structs, the listends when yline->next == nil. Every such list representsall yline segments on the actual line in the inputimage, belonging to this region.
ncis neighbour connectedness - should be 4 or 8. Ifthere is an object in the image with object number(pixel value) 0, the object is supposed to be thebackground, and the opposite nc value is applied tothat object.
sort- sort the regions with respect to object number.The regionsarray will then point at the first regionfound in every object, the region->next pointer can befollowed to see the other regions in the object. Theregionsarray may have a lot of nil pointers, as it isindexed with object numbers.
split- split all objects, except an eventualbackgroud object with object number 0, so that everyregion of an object will form an individual object.Useful for thresholded images.
RESTRICTIONS
inputmust have pixel type unsigned byte.
RETURN VALUE
0 => ok
1 => Bad pixel type input band
2 => Bad neighbour type, should be 4 or 8
3 => Can't alloc enough virtual memory, too many regions
EXAMPLE
IBAND i;
region **regs;
int size;
if (regionYline(i, ®s, 4, FALSE, TRUE, &size))
ERROR(..);
SEE ALSO
regionAnalyse(1),
regionArea(3),
regionConvexHull(3),
regionCreate(3),
regionDraw(3),
regionFree(3),
regionHisto(3),
regionHistoUpdate(3),
regionImoment(3),
regionInsertYline(3),
regionDeleteYline(3)
regionEndInsert(3),
regionXmean(3),
regionYmean(3),
regionMean(3),
regionXmin(3),
regionXmax(3),
regionYmin(3),
regionYmax(3),
regionMinMax(3),
regionCMoment(3),
regionPMoment(3),
regionMoment(3),
regionPerform(3),
regionPerimeter(3),
regionIsPoint(3),
regionPoint(3),
regionSearch(3),
regionSort(3),
regionCopy(3),
regionUnion(3),
regionOverlap(3),
regionNeighbor(3),
regionVolume(3)
AUTHOR
Tor Lønnestad, BLAB, Ifi, UiO
ID
$Id: regionYline.c,v 1.33 1997/05/05 12:38:37 tor Exp $
Index
- NAME
- SYNTAX
- DESCRIPTION
- RESTRICTIONS
- RETURN VALUE
- EXAMPLE
- SEE ALSO
- AUTHOR
- ID
This document was created byman2html,using the manual pages.
