editor / stretchToSize

Function: stretchToSize()

stretchToSize(points, size): readonly Point[]

Defined in: geometry/stretch-to-size.ts:21

Stretches a set of points to a width and a height, each axis by its own factor, the top-left of their box fixed (DERIV-free-shape-stretch, SVG's viewBox transform with align = none).

Computed as o + width · (p − o) / span, multiplying first, so that the far edge lands exactly on the width asked while width · span and the far coordinate stay below 2⁵³ (integers). At its own size (width = span) an axis is kept as stored, bit for bit, fractions included. The points must span both axes (span > 0): a size of 0 puts every point on the fixed side, and the stored points are never changed.

Parameters

points

readonly Point[]

points spanning both axes, in drawing order

size

Size

width and height asked, >= 0

Returns

readonly Point[]

the points stretched, in the same order

Kind

geometry

See

DERIV-free-shape-stretch