PointArea

Espacio de nombres: Digi21.DigiNG.Entities.Relations
Ensamblado: Digi21.DigiNG

Métodos que analizan la relación entre un punto y un área.

public static class PointArea

El primer parámetro, point, es un ReadOnlyPoint. El segundo, area, es un ReadOnlyPolygon o una ReadOnlyLine cerrada; cada método tiene una sobrecarga para cada tipo. Los métodos no comprueban que la ReadOnlyLine esté cerrada; si no lo está, ningún punto está dentro de ella.

El paquete NuGet de referencia llama area al segundo parámetro. En el ensamblado instalado se llama polygon en las sobrecargas con ReadOnlyPolygon y line en las sobrecargas con ReadOnlyLine; ese es el nombre que devuelve ArgumentNullException.ParamName.

Para cada punto y área se cumple exactamente una de estas tres relaciones:

Métodos estáticos

Todos los métodos lanzan ArgumentNullException si un argumento es null.

Ejemplo

Este programa crea en memoria un polígono con un hueco y tres puntos y analiza la relación de cada punto con el polígono:

using Digi21.DigiNG.Entities;
using Digi21.DigiNG.Entities.Relations;
using Digi21.Math;

static Point Punto(string código, double x, double y) => new Point(new Code(código)) { Coordinate = new Point3D(x, y, 0) };

var parcela = new Polygon(new Code("PARCELA"));
parcela.Points.Add(new[]
{
    new Point3D(0, 0, 0), new Point3D(10, 0, 0), new Point3D(10, 10, 0), new Point3D(0, 10, 0), new Point3D(0, 0, 0),
});

var hueco = new Line(new Code("PARCELA"));
hueco.Points.Add(new[]
{
    new Point3D(4, 4, 0), new Point3D(6, 4, 0), new Point3D(6, 6, 0), new Point3D(4, 6, 0), new Point3D(4, 4, 0),
});
parcela.Holes.Add(hueco);

var interior = Punto("INTERIOR", 2, 2);
var enHueco = Punto("HUECO", 5, 5);
var vértice = Punto("VERTICE", 4, 4);

Console.WriteLine($"Within(INTERIOR): {PointArea.Within(interior, parcela)}");     // True
Console.WriteLine($"Within(HUECO): {PointArea.Within(enHueco, parcela)}");         // False
Console.WriteLine($"Disjoint(HUECO): {PointArea.Disjoint(enHueco, parcela)}");     // True
Console.WriteLine($"Coincident(VERTICE): {PointArea.Coincident(vértice, parcela)}"); // True