SYSreplaceStringSections

Cut of polygon.

Cuts out the external segments internal concerning the clip polygon of the line train.

With an open line train they are extinguished according to topology or are substituted, with the compensation will come in case of that two segments of the clip polygon to question the shorter one electively.

With a closed line train they are substituted, as with the parametre input_insert described, with segments of the clip polygon.

Parametre

input_poly (const PSTRING_ELEMENT) [IN]

The line train which is disassembled by the clip polygon.

input_clip (const PSTRING_ELEMENT) [IN]

The clip polygon determines at which places the line train is divided.

input_inside (const BOOLEAN) [IN]

Possible values are: TRUE if the internal segments are substituted. FALSE if the external segments are substituted.

input_bounds (const BOOLEAN) [IN]

Possible values are: TRUE if the segments of the line train which lie on the clip polygon should be substituted. FALSE if the segments of the line train which lie on the clip polygon, should not be substituted.

input_insert (const BOOLEAN) [IN]

Choice of the segments to be used of the clip polygon if the line train is a surface. Should the internal segments of the line train be substituted, they are substituted with TRUE with the internal ones of the clip polygon, the result is the surface of the line train without those of the clip polygon. With FALSE they are substituted with the external ones, the result is the union surface. With the replacement of the external segments they are substituted with TRUE with the external ones, the result is the surface of the clip polygon without those of the line train. With FALSE they are substituted with the internal ones, the result is the cut surface.

Result

(int) [OUT]

With a mistake becomes–1 zurückgeliefert, but the number of the generated string elements.

Declaration

#include "system.h"

int DLLENTRY SYSreplaceStringSections (

const PSTRING_ELEMENT input_poly,

const PSTRING_ELEMENT input_clip,

const BOOLEAN input_inside,

const BOOLEAN input_bounds,

const BOOLEAN input_insert

);

Related functions

SYSlocationOfString

Remarks

The clip polygon may not cut itself in an intersection by the line train.

An open line train with a DKA <>0 is automatically closed.

If the line train lies completely in the area to be cut out, he is extinguished.