regionCreate

Name

regionCreate - create a new region

Syntax

 #include <xite/region.h>

 region *regionCreate( int objnr, int regnr,
    int nc, int ymin, int ymax );

Description

Creates a new region object, and initializes the attributes corresponding to the routine arguments. The "ylines" vector is allocated and indexable on ymin..ymax, but all pointers are set to nil, no yline objects are created. The region is thus not in a consistent state. Use regionInsertYline repeatedly and end with regionEndInsert to get the region object in a consistent state.

Restrictions

nc==4 or nc==8, ymin <= ymax

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

Diagnostics

 Error 2: Malloc failed

Return value

the newly created region. Nil if error

Author

Tor L|nnestad, BLAB, ifi, UiO

Id

$Id: regionCreate.c,v 1.22 1995/10/27 10:49:34 svein Exp $