regionInsertYline

Name

regionInsertYline - insert yline into newly created region

Syntax

 #include <xite/region.h>

 yline *regionInsertYline( region* reg, int y,
    int xmin, int xmax );

Description

Insert an yline, the line xmin..xmax on line y, into region reg. After all ylines have been inserted into the region, regionEndInsert should be called.

Notice that if the new yline segment overlaps with two or more existing ylines, the superfluous yline objects will be freed.

Restrictions

The new yline must be connected to the existing region, with the neighborhod connectedness of the region (4 or 8). The new yline must lie within the ymin..ymax interval of the region object.

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

 Warning 2: y less than ymin
 Warning 3: y greater than ymax
 Warning 4: Object not connected

Return value

The inserted or updated yline object if ok, nil otherwise.

Author

Tor L|nnestad, BLAB, ifi, UiO

Id

$Id: regionInsert.c,v 1.15 1997/01/29 10:45:10 svein Exp $