MAN page from RedHat Other XITE-3.3-3.i386.rpm

REGIONHISTO

Section: C Library Functions (3)
Updated: 16 Mar 1998
Index

NAME

regionHisto, regionHistoUpdate - make a histogram of pixelsin a region

SYNTAX

#include <xite/region.h>
#include <xite/region.h>

int regionHisto( IBAND band, region* reg,
int loop, histogram histo );

int regionHistoUpdate( IBAND band,
region* reg, int loop, histogram histo );

DESCRIPTION

regionHistocreates a histogram over the pixels in "band"that are inside region "reg". If "loop" is true,the next pointer in "reg" is followed until NIL,and the pixels in all regions are included inthe histogram. If "reg" contains pixels that arenot inside "band", these pixels will not influencethe output histogram. If reg== NULL the histogramif filled with 0.

regionHistoUpdateupdates a histogram over the pixels inbandthat are inside region "reg". If "loop" is true,the next pointer in "reg" is followed until NIL,and the pixels in all regions are included inthe histogram. If "reg" contains pixels that arenot inside "band", these pixels will not influencethe output histogram.

RETURN VALUE

0 => OK
1 => bad pixel type in "band", accepts only UNS_BYTE.
2 => reg points to NIL

regionAnalyse(1), regionArea(3),regionConvexHull(3), regionCreate(3),regionDraw(3), regionFree(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),regionYline(3)

AUTHOR

Tor L|nnestad, BLAB, ifi, UiO

EXAMPLE 1

Compute the histogram of a region:
IBAND b;
region *reg;
histogram h;
..create reg..
regionHisto(b, reg, FALSE, h);

EXAMPLE 2

Compute the histogram of all regions with objectnr == 2
IBAND b;
region *reg;
histogram h;
..create reg..
regionHisto(b, NULL, FALSE, h);  / * Zero histogram * /
for (rnr=1; rnr<=rsize; r++)
   if (regs[rnr]->objectnr == 2)
     regionHistoUpdate(b, regs[rnr], FALSE, h);

ID

$Id: regionHisto.c,v 1.19 1995/10/27 10:49:37 svein Exp $

This document was created byman2html,using the manual pages.