Back to FabImage Library website

You are here: Start » Function Reference » Geometry 2D » Geometry 2D Interpolations » LerpSegments

LerpSegments


Header: FIL.h
Namespace: fil
Module: FoundationLite

Linearly interpolates between two segments.

Syntax

C++
C#
 
void fil::LerpSegments
(
	const fil::Segment2D& inSegment0,
	const fil::Segment2D& inSegment1,
	float inLambda,
	bool inIgnoreOrientation,
	fil::Segment2D& outSegment
)

Parameters

Name Type Range Default Description
Input value
 inSegment0 const Segment2D&
Input value
 inSegment1 const Segment2D&
Input value
 inLambda float - - 0.5f Interpolation between the input segments where 0.0 value is equal to inSegment0 and 1.0 to inSegment1
Input value
 inIgnoreOrientation bool
Output value
 outSegment Segment2D&

In-place Processing

This function supports in-place data processing - you can pass the same reference to inSegment1 and outSegment

Read more about In-place Computation.

Examples

LerpSegments performed on red inSegment0 and blue inSegment1 with inLambda = 0,25. Green is the resulting outSegment.

LerpSegments performed on red inSegment0 and blue inSegment1 with inLambda = -1,0. Green is the resulting outSegment.

Remarks

Please note that:
  • interpolation begins at inSegment0,
  • for positive inLambda values interpolation is performed in the direction of inSegment1 while for negative - in the direction of a segment which is the result of the following operation: (inSegment0 - inSegment1), in example a segment consisting of inSegment1 points mirrored by the corresponding inSegment0 points.
Hence when inLambda = 0,0, outSegment is equal to inSegment0, while for inLambda = 1,0 it's the same as inSegment1 and for inLambda = -1,0 - as (inSegment0 - inSegment1). Other inLambda values interpolate between the input segments and beyond.