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

REGIONPERFORM

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

NAME

regionPerform - perform any procedure for each point in region

SYNTAX

#include <xite/region.h>

BiffStatus regionPerform( void* data,
region* reg, int loop,
regionfunc performproc, void* performdata );

DESCRIPTION

regionPerformcalls the specified procedure performprocfor every point (x,y) in the region reg. The procedurecall syntax is

  performproc(data, x, y, performdata)
  void *data;
  int x, y;
  void *performdata;

The specified procedure should thus match this syntax.data is typically, but need not be, a band or an image.performdata is pointer to any other data structure neededby performproc. data and/or performdata may be nil.

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),regionPerimeter(3), regionIsPoint(3), regionPoint(3),regionSearch(3), regionSort(3), regionCopy(3), regionUnion(3),regionOverlap(3), regionNeighbor(3), regionVolume(3),regionYline(3)

RETURN VALUE

Status, 0 => ok. See below for error numbers and messages.

DIAGNOSTICS

Warning 2: region argument nil
Warning 3: performproc argument nil

EXAMPLE

To measure the "volume" under a region:

   int volumeproc(band, x, y, vol)
   IBAND band;
   int x, y;
   int *vol;
   {
     *vol += band[y][x];
     return(0);
   }

   region *reg;
   int volume=0;
   <create reg>

regionPerform(band, reg, 0, volumeproc, &volume);

AUTHOR

Tor L|nnestad, BLAB, ifi, UiO

ID

$Id: regionPerform.c,v 1.18 1995/10/27 10:49:44 svein Exp $

This document was created byman2html,using the manual pages.