You are here: Start » FIL.NET » Function Reference » Geometry 2D » Geometry 2D Spatial Transforms » FIL.SplitSegment

FIL.SplitSegment

Splits a segment into several parts of equal length.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void SplitSegment
(
	FilNet.Segment2D inSegment,
	int inCount,
	IList<FilNet.Segment2D> outSegments
)

Parameters

Name Type Range Default Description
inSegmentFilNet.Segment2D
inCountint<1, INF>2Number of segments after segment split. Default value: 2.
outSegmentsSystem.Collections.Generic.IList<FilNet.Segment2D>

Description

Filter computes outSegments using following formulas: $$\mathbf {outSegments}[0].x_{begin} = \mathbf {inSegment}.x_{begin}$$ $$\mathbf {outSegments}[0].y_{begin} = \mathbf {inSegment}.y_{begin}$$ $$\mathbf {outSegments}[0].x_{end} = \mathbf {inSegment}.x_{begin} + \Delta x$$ $$\mathbf {outSegments}[0].y_{end} = \mathbf {inSegment}.y_{begin} + \Delta y$$ $$\mathbf {outSegments}[i].x_{begin} = \mathbf{outSegments}[i-1].x_{begin} + \Delta x $$ $$\mathbf {outSegments}[i].y_{begin} = \mathbf{outSegments}[i-1].y_{begin} + \Delta y $$ $$\mathbf {outSegments}[i].x_{end} = \mathbf{outSegments}[i-1].x_{end} + \Delta x $$ $$\mathbf {outSegments}[i].y_{end} = \mathbf{outSegments}[i-1].y_{end} + \Delta y $$ $$ i = 1, 2, .., \mathbf {inCount} - 1 $$ where $$\Delta x = \frac {\mathbf{inSegment}.x_{end} - \mathbf{inSegment}.x_{begin} }{\mathbf{inCount} }$$ $$\Delta y = \frac {\mathbf{inSegment}.y_{end} - \mathbf{inSegment}.y_{begin} }{\mathbf{inCount} }$$

Examples

Assume segment described with two points:
  • Start point P(0, 0)
  • End point Q(3, 6).
To split segment into three parts of equal length, set inCount = 3.
Result will be as follows:
$$\mathbf {outSegments}[0]=\vec{P_1Q_1}=[1, 2] \quad \mathbf {outSegments}[1]=\vec{P_2Q_2}=[1, 2] \quad \mathbf {outSegments}[2]=\vec{P_3Q_3}=[1, 2]$$

See also