flatten-js
Version:
Javascript library for 2d geometry
638 lines (545 loc) • 52.8 kB
HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>algorithms/distance.js - Documentation</title>
<script src="scripts/prettify/prettify.js"></script>
<script src="scripts/prettify/lang-css.js"></script>
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<link type="text/css" rel="stylesheet" href="https://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
<link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
<link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
</head>
<body>
<input type="checkbox" id="nav-trigger" class="nav-trigger" />
<label for="nav-trigger" class="navicon-button x">
<div class="navicon"></div>
</label>
<label for="nav-trigger" class="overlay"></label>
<nav>
<li class="nav-link nav-home-link"><a href="index.html">Home</a></li><li class="nav-heading">Classes</li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Arc.html">Arc</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#breakToFunctional">breakToFunctional</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#chordHeight">chordHeight</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#middle">middle</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#reverse">reverse</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#split">split</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#tangentInEnd">tangentInEnd</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#tangentInStart">tangentInStart</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#toJSON">toJSON</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#transform">transform</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Arc.html#translate">translate</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Box.html">Box</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#equal_to">equal_to</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#less_than">less_than</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#merge">merge</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#not_intersect">not_intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#set">set</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Box.html#svg">svg</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Circle.html">Circle</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#toArc">toArc</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Circle.html#toJSON">toJSON</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Edge.html">Edge</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Edge.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Edge.html#middle">middle</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Edge.html#setInclusion">setInclusion</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Edge.html#setOverlap">setOverlap</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Face.html">Face</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#append">append</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#area">area</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#insert">insert</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#isEmpty">isEmpty</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#isSimple">isSimple</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#orientation">orientation</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#remove">remove</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#reverse">reverse</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#setArcLength">setArcLength</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#signedArea">signedArea</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Face.html#svg">svg</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Image.html">Image</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Line.html">Line</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#incidentTo">incidentTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#parallelTo">parallelTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Line.html#toJSON">toJSON</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Matrix.html">Matrix</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#equalTo">equalTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#multiply">multiply</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#scale">scale</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#transform">transform</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Matrix.html#translate">translate</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html">PlanarSet</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#add">add</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#clear">clear</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#delete">delete</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#hit">hit</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#search">search</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.PlanarSet.html#svg">svg</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Point.html">Point</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#equalTo">equalTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#leftTo">leftTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#lessThan">lessThan</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#on">on</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#projectionOn">projectionOn</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#toJSON">toJSON</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#transform">transform</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Point.html#translate">translate</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Polygon.html">Polygon</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#addFace">addFace</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#addVertex">addVertex</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#area">area</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#deleteFace">deleteFace</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#isEmpty">isEmpty</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#isValid">isValid</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#removeChain">removeChain</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#toJSON">toJSON</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#transform">transform</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Polygon.html#translate">translate</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Ray.html">Ray</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Ray.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Ray.html#intersect">intersect</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Segment.html">Segment</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#contains">contains</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#distanceTo">distanceTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#equalTo">equalTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#intersect">intersect</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#isZeroLength">isZeroLength</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#middle">middle</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#reverse">reverse</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#split">split</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#svg">svg</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#tangentInEnd">tangentInEnd</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#tangentInStart">tangentInStart</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#toJSON">toJSON</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#transform">transform</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Segment.html#translate">translate</a></span></li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Flatten.Vector.html">Vector</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#add">add</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#angleTo">angleTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#clone">clone</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#cross">cross</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#dot">dot</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#equalTo">equalTo</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#invert">invert</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#multiply">multiply</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#normalize">normalize</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#projectionOn">projectionOn</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#rotate">rotate</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#rotate90CCW">rotate90CCW</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#rotate90CW">rotate90CW</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#subtract">subtract</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Flatten.Vector.html#toJSON">toJSON</a></span></li><li class="nav-heading"><a href="global.html">Globals</a></li><li class="nav-item"><span class="nav-item-type type-member">M</span><span class="nav-item-name"><a href="global.html#DP_TOL">DP_TOL</a></span></li>
</nav>
<div id="main">
<h1 class="page-title">algorithms/distance.js</h1>
<section>
<article>
<pre class="prettyprint source linenums"><code>"use strict";
let IntervalTree = require('flatten-interval-tree');
module.exports = function(Flatten) {
let {Polygon, Point, Segment, Arc, Circle, Line, Ray, Vector} = Flatten;
let {vector} = Flatten;
Flatten.Distance = class Distance {
/**
* Calculate distance and shortest segment between points
* @param pt1
* @param pt2
* @returns {Number | Segment} - distance and shortest segment
*/
static point2point(pt1, pt2) {
return pt1.distanceTo(pt2);
}
/**
* Calculate distance and shortest segment between point and line
* @param pt
* @param line
* @returns {Number | Segment} - distance and shortest segment
*/
static point2line(pt, line) {
let closest_point = pt.projectionOn(line);
let vec = vector(pt, closest_point);
return [vec.length, new Segment(pt, closest_point)];
}
/**
* Calculate distance and shortest segment between point and circle
* @param pt
* @param circle
* @returns {Number | Segment} - distance and shortest segment
*/
static point2circle(pt, circle) {
let [dist2center, shortest_dist] = pt.distanceTo(circle.center);
if (Flatten.Utils.EQ_0(dist2center)) {
return [circle.r, new Segment(pt, circle.toArc().start)];
}
else {
let dist = Math.abs(dist2center - circle.r);
let v = vector(circle.pc, pt).normalize().multiply(circle.r);
let closest_point = circle.pc.translate(v);
return [dist, new Segment(pt, closest_point)];
}
}
/**
* Calculate distance and shortest segment between point and segment
* @param pt
* @param segment
* @returns {Number | Segment} - distance and shortest segment
*/
static point2segment(pt, segment) {
/* Degenerated case of zero-length segment */
if (segment.start.equalTo(segment.end)) {
return Distance.point2point(pt, segment.start);
}
let v_seg = new Flatten.Vector(segment.start, segment.end);
let v_ps2pt = new Flatten.Vector(segment.start, pt);
let v_pe2pt = new Flatten.Vector(segment.end, pt);
let start_sp = v_seg.dot(v_ps2pt);
/* dot product v_seg * v_ps2pt */
let end_sp = -v_seg.dot(v_pe2pt);
/* minus dot product v_seg * v_pe2pt */
let dist;
let closest_point;
if (Flatten.Utils.GE(start_sp, 0) && Flatten.Utils.GE(end_sp, 0)) { /* point inside segment scope */
let v_unit = segment.tangentInStart(); // new Flatten.Vector(v_seg.x / this.length, v_seg.y / this.length);
/* unit vector ||v_unit|| = 1 */
dist = Math.abs(v_unit.cross(v_ps2pt));
/* dist = abs(v_unit x v_ps2pt) */
closest_point = segment.start.translate(v_unit.multiply(v_unit.dot(v_ps2pt)));
return [dist, new Segment(pt, closest_point)];
}
else if (start_sp < 0) { /* point is out of scope closer to ps */
return pt.distanceTo(segment.start);
}
else { /* point is out of scope closer to pe */
return pt.distanceTo(segment.end);
}
};
/**
* Calculate distance and shortest segment between point and arc
* @param pt
* @param arc
* @returns {Number | Segment} - distance and shortest segment
*/
static point2arc(pt, arc) {
let circle = new Flatten.Circle(arc.pc, arc.r);
let dist_and_segment = [];
let dist, shortest_segment;
[dist, shortest_segment] = Distance.point2circle(pt, circle);
if (shortest_segment.end.on(arc)) {
dist_and_segment.push(Distance.point2circle(pt, circle));
}
dist_and_segment.push( Distance.point2point(pt, arc.start) );
dist_and_segment.push( Distance.point2point(pt, arc.end) );
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
/**
* Calculate distance and shortest segment between segment and line
* @param seg
* @param line
* @returns {Number | Segment}
*/
static segment2line(seg, line) {
let ip = seg.intersect(line);
if (ip.length > 0) {
return [0, new Segment(ip[0],ip[0])]; // distance = 0, closest point is the first point
}
let dist_and_segment = [];
dist_and_segment.push(Distance.point2line(seg.start, line));
dist_and_segment.push(Distance.point2line(seg.end, line));
Distance.sort( dist_and_segment );
return dist_and_segment[0];
}
/**
* Calculate distance and shortest segment between two segments
* @param seg1
* @param seg2
* @returns {Number | Segment} - distance and shortest segment
*/
static segment2segment(seg1, seg2) {
let ip = Segment.intersectSegment2Segment(seg1, seg2);
if (ip.length > 0) {
return [0, new Segment(ip[0],ip[0])]; // distance = 0, closest point is the first point
}
// Seg1 and seg2 not intersected
let dist_and_segment = [];
dist_and_segment.push(Distance.point2segment(seg2.start, seg1));
dist_and_segment.push(Distance.point2segment(seg2.end, seg1));
dist_and_segment.push(Distance.point2segment(seg1.start, seg2));
dist_and_segment.push(Distance.point2segment(seg1.end, seg2));
Distance.sort( dist_and_segment );
return dist_and_segment[0];
}
/**
* Calculate distance and shortest segment between segment and circle
* @param seg
* @param circle
* @returns {Number | Segment} - distance and shortest segment
*/
static segment2circle(seg, circle) {
/* Case 1 Segment and circle intersected. Return the first point and zero distance */
let ip = seg.intersect(circle);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
// No intersection between segment and circle
/* Case 2. Distance to projection of center point to line bigger than radius
* And projection point belong to segment
* Then measure again distance from projection to circle and return it */
let line = new Flatten.Line(seg.ps, seg.pe);
let [dist, shortest_segment] = Distance.point2line(circle.center, line);
if (Flatten.Utils.GE(dist, circle.r) && shortest_segment.end.on(seg)) {
return Distance.point2circle(shortest_segment.end, circle);
}
/* Case 3. Otherwise closest point is one of the end points of the segment */
else {
let [dist_from_start, shortest_segment_from_start] = Distance.point2circle(seg.start, circle);
let [dist_from_end, shortest_segment_from_end] = Distance.point2circle(seg.end, circle);
return Flatten.Utils.LT(dist_from_start, dist_from_end) ?
[dist_from_start, shortest_segment_from_start] :
[dist_from_end, shortest_segment_from_end];
}
}
/**
* Calculate distance and shortest segment between segment and arc
* @param seg
* @param arc
* @returns {Number | Segment} - distance and shortest segment
*/
static segment2arc(seg, arc) {
/* Case 1 Segment and arc intersected. Return the first point and zero distance */
let ip = seg.intersect(arc);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
// No intersection between segment and arc
let line = new Flatten.Line(seg.ps, seg.pe);
let circle = new Flatten.Circle(arc.pc, arc.r);
/* Case 2. Distance to projection of center point to line bigger than radius AND
* projection point belongs to segment AND
* distance from projection point to circle belongs to arc =>
* return this distance from projection to circle */
let [dist_from_center, shortest_segment_from_center] = Distance.point2line(circle.center, line);
if (Flatten.Utils.GE(dist_from_center, circle.r) && shortest_segment_from_center.end.on(seg)) {
let [dist_from_projection, shortest_segment_from_projection] =
Distance.point2circle(shortest_segment_from_center.end, circle);
if (shortest_segment_from_projection.end.on(arc)) {
return [dist_from_projection, shortest_segment_from_projection];
}
}
/* Case 3. Otherwise closest point is one of the end points of the segment */
let dist_and_segment = [];
dist_and_segment.push(Distance.point2arc(seg.start, arc));
dist_and_segment.push(Distance.point2arc(seg.end, arc));
let dist_tmp, segment_tmp;
[dist_tmp, segment_tmp] = Distance.point2segment(arc.start, seg);
dist_and_segment.push([dist_tmp, segment_tmp.reverse()]);
[dist_tmp, segment_tmp] = Distance.point2segment(arc.end, seg);
dist_and_segment.push([dist_tmp, segment_tmp.reverse()]);
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
/**
* Calculate distance and shortest segment between two circles
* @param circle1
* @param circle2
* @returns {Number | Segment} - distance and shortest segment
*/
static circle2circle(circle1, circle2) {
let ip = circle1.intersect(circle2);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
// Case 1. Concentric circles. Convert to arcs and take distance between two arc starts
if (circle1.center.equalTo(circle2.center)) {
let arc1 = circle1.toArc();
let arc2 = circle2.toArc();
return Distance.point2point(arc1.start, arc2.start);
}
else {
// Case 2. Not concentric circles
let line = new Line(circle1.center, circle2.center);
let ip1 = line.intersect(circle1);
let ip2 = line.intersect(circle2);
let dist_and_segment = [];
dist_and_segment.push(Distance.point2point(ip1[0], ip2[0]));
dist_and_segment.push(Distance.point2point(ip1[0], ip2[1]));
dist_and_segment.push(Distance.point2point(ip1[1], ip2[0]));
dist_and_segment.push(Distance.point2point(ip1[1], ip2[1]));
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
}
/**
* Calculate distance and shortest segment between two circles
* @param circle
* @param line
* @returns {Number | Segment} - distance and shortest segment
*/
static circle2line(circle, line) {
let ip = circle.intersect(line);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let [dist_from_center, shortest_segment_from_center] = Distance.point2line(circle.center, line);
let [dist, shortest_segment] = Distance.point2circle(shortest_segment_from_center.end, circle);
shortest_segment = shortest_segment.reverse();
return [dist, shortest_segment];
}
/**
* Calculate distance and shortest segment between arc and line
* @param arc
* @param line
* @returns {Number | Segment} - distance and shortest segment
*/
static arc2line(arc, line) {
/* Case 1 Line and arc intersected. Return the first point and zero distance */
let ip = line.intersect(arc);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let circle = new Flatten.Circle(arc.center, arc.r);
/* Case 2. Distance to projection of center point to line bigger than radius AND
* projection point belongs to segment AND
* distance from projection point to circle belongs to arc =>
* return this distance from projection to circle */
let [dist_from_center, shortest_segment_from_center] = Distance.point2line(circle.center, line);
if (Flatten.Utils.GE(dist_from_center, circle.r)) {
let [dist_from_projection, shortest_segment_from_projection] =
Distance.point2circle(shortest_segment_from_center.end, circle);
if (shortest_segment_from_projection.end.on(arc)) {
return [dist_from_projection, shortest_segment_from_projection];
}
}
else {
let dist_and_segment = [];
dist_and_segment.push( Distance.point2line(arc.start, line) );
dist_and_segment.push( Distance.point2line(arc.end, line) );
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
}
/**
* Calculate distance and shortest segment between arc and circle
* @param arc
* @param circle2
* @returns {Number | Segment} - distance and shortest segment
*/
static arc2circle(arc, circle2) {
let ip = arc.intersect(circle2);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let circle1 = new Flatten.Circle(arc.center, arc.r);
let [dist, shortest_segment] = Distance.circle2circle(circle1, circle2);
if (shortest_segment.start.on(arc)) {
return [dist, shortest_segment];
}
else {
let dist_and_segment = [];
dist_and_segment.push(Distance.point2circle(arc.start, circle2));
dist_and_segment.push(Distance.point2circle(arc.end, circle2));
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
}
/**
* Calculate distance and shortest segment between two arcs
* @param arc1
* @param arc2
* @returns {Number | Segment} - distance and shortest segment
*/
static arc2arc(arc1, arc2) {
let ip = arc1.intersect(arc2);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let circle1 = new Flatten.Circle(arc1.center, arc1.r);
let circle2 = new Flatten.Circle(arc2.center, arc2.r);
let [dist, shortest_segment] = Distance.circle2circle(circle1, circle2);
if (shortest_segment.start.on(arc1) && shortest_segment.end.on(arc2)) {
return [dist, shortest_segment];
}
else {
let dist_and_segment = [];
let dist_tmp, segment_tmp;
[dist_tmp, segment_tmp] = Distance.point2arc(arc1.start, arc2);
if (segment_tmp.end.on(arc2)) {
dist_and_segment.push([dist_tmp, segment_tmp]);
}
[dist_tmp, segment_tmp] = Distance.point2arc(arc1.end, arc2);
if (segment_tmp.end.on(arc2)) {
dist_and_segment.push([dist_tmp, segment_tmp]);
}
[dist_tmp, segment_tmp] = Distance.point2arc(arc2.start, arc1);
if (segment_tmp.end.on(arc1)) {
dist_and_segment.push([dist_tmp, segment_tmp.reverse()]);
}
[dist_tmp, segment_tmp] = Distance.point2arc(arc2.end, arc1);
if (segment_tmp.end.on(arc1)) {
dist_and_segment.push([dist_tmp, segment_tmp.reverse()]);
}
[dist_tmp, segment_tmp] = Distance.point2point(arc1.start, arc2.start);
dist_and_segment.push([dist_tmp, segment_tmp]);
[dist_tmp, segment_tmp] = Distance.point2point(arc1.start, arc2.end);
dist_and_segment.push([dist_tmp, segment_tmp]);
[dist_tmp, segment_tmp] = Distance.point2point(arc1.end, arc2.start);
dist_and_segment.push([dist_tmp, segment_tmp]);
[dist_tmp, segment_tmp] = Distance.point2point(arc1.end, arc2.end);
dist_and_segment.push([dist_tmp, segment_tmp]);
Distance.sort(dist_and_segment);
return dist_and_segment[0];
}
}
/**
* Calculate distance and shortest segment between point and polygon
* @param point
* @param polygon
* @returns {Number | Segment} - distance and shortest segment
*/
static point2polygon(point, polygon) {
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Segment()];
for (let edge of polygon.edges) {
let [dist, shortest_segment] = (edge.shape instanceof Segment) ?
Distance.point2segment(point, edge.shape) : Distance.point2arc(point, edge.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
return min_dist_and_segment;
}
static shape2polygon(shape, polygon) {
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Segment()];
for (let edge of polygon.edges) {
let [dist, shortest_segment] = shape.distanceTo(edge.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
return min_dist_and_segment;
}
/*
static arc2polygon(arc, polygon) {
let ip = arc.intersect(polygon);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Segment()];
for (let edge of polygon.edges) {
let [dist, shortest_segment] = arc.distanceTo(edge.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
return min_dist_and_segment;
}
static line2polygon(line, polygon) {
let ip = line.intersect(polygon);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Segment()];
for (let edge of polygon.edges) {
let [dist, shortest_segment] = line.distanceTo(edge.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
return min_dist_and_segment;
}
static circle2polygon(circle, polygon) {
let ip = circle.intersect(polygon);
if (ip.length > 0) {
return [0, new Segment(ip[0], ip[0])];
}
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Segment()];
for (let edge of polygon.edges) {
let [dist, shortest_segment] = circle.distanceTo(edge.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
return min_dist_and_segment;
}
*/
/**
* Calculate distance and shortest segment between two polygons
* @param polygon1
* @param polygon2
* @returns {Number | Segment} - distance and shortest segment
*/
static polygon2polygon(polygon1, polygon2) {
let min_dist_and_segment = [Number.POSITIVE_INFINITY, new Flatten.Segment()];
for (let edge1 of polygon1.edges) {
for (let edge2 of polygon2.edges) {
let [dist, shortest_segment] = edge1.shape.distanceTo(edge2.shape);
if (Flatten.Utils.LT(dist, min_dist_and_segment[0])) {
min_dist_and_segment = [dist, shortest_segment];
}
}
}
return min_dist_and_segment;
}
/**
* Returns [mindist, maxdist] array of squared minimal and maximal distance between boxes
* Minimal distance by x is
* (box2.xmin - box1.xmax), if box1 is left to box2
* (box1.xmin - box2.xmax), if box2 is left to box1
* 0, if box1 and box2 are intersected by x
* Minimal distance by y is defined in the same way
*
* Maximal distance is estimated as a sum of squared dimensions of the merged box
*
* @param box1
* @param box2
* @returns {Number | Number} - minimal and maximal distance
*/
static box2box_minmax(box1, box2) {
let mindist_x = Math.max( Math.max(box1.xmin - box2.xmax, 0), Math.max(box2.xmin - box1.xmax, 0) );
let mindist_y = Math.max( Math.max(box1.ymin - box2.ymax, 0), Math.max(box2.ymin - box1.ymax, 0) );
let mindist = mindist_x*mindist_x + mindist_y*mindist_y;
let box = box1.merge(box2);
let dx = box.xmax - box.xmin;
let dy = box.ymax - box.ymin;
let maxdist = dx*dx + dy*dy;
return [mindist, maxdist];
}
static minmax_tree_process_level(shape, level, min_stop, tree) {
// Calculate minmax distance to each shape in current level
// Insert result into the interval tree for further processing
// update min_stop with maxdist, it will be the new stop distance
let mindist, maxdist;
for (let node of level) {
// [mindist, maxdist] = Distance.box2box_minmax(shape.box, node.max);
// if (Flatten.Utils.GT(mindist, min_stop))
// continue;
// Estimate min-max dist to the shape stored in the node.item, using node.item.key which is shape's box
[mindist, maxdist] = Distance.box2box_minmax(shape.box, node.item.key);
if (node.item.value instanceof Flatten.Edge) {
tree.insert([mindist, maxdist], node.item.value.shape);
}
else {
tree.insert([mindist, maxdist], node.item.value);
}
if (Flatten.Utils.LT(maxdist, min_stop)) {
min_stop = maxdist; // this will be the new distance estimation
}
}
if (level.length === 0)
return min_stop;
// Calculate new level from left and right children of the current
let new_level_left = level.map(node => node.left.isNil() ? undefined : node.left ).filter(node => node !== undefined);
let new_level_right = level.map(node => node.right.isNil() ? undefined : node.right).filter(node => node !== undefined);
// Merge left and right subtrees and leave only relevant subtrees
let new_level = [...new_level_left, ...new_level_right].filter( node => {
// Node subtree quick reject, node.max is a subtree box
let [mindist, maxdist] = Distance.box2box_minmax(shape.box, node.max);
return (Flatten.Utils.LE(mindist, min_stop));
});
min_stop = Distance.minmax_tree_process_level(shape, new_level, min_stop, tree);
return min_stop;
}
/**
* Calculates sorted tree of [mindist, maxdist] intervals between query shape
* and shapes of the planar set.
* @param shape
* @param set
*/
static minmax_tree(shape, set, min_stop) {
let tree = new IntervalTree();
let level = [set.index.root];
let squared_min_stop = min_stop < Number.POSITIVE_INFINITY ? min_stop*min_stop : Number.POSITIVE_INFINITY;
squared_min_stop = Distance.minmax_tree_process_level(shape, level, squared_min_stop, tree);
return tree;
}