This page has not been translated yet and is shown in Spanish.

DigitalTerrainModelCollection

Espacio de nombres: Digi21.DigiNG.Dtm
Ensamblado: Digi21.DigiNG.Dtm

Conjunto de modelos digitales del terreno (MDT) con una etiqueta cada uno, que devuelve la coordenada Z del terreno en un punto. Consulta los modelos que tienen la etiqueta pedida o, si la etiqueta pedida es null o está vacía, los modelos con cualquier etiqueta, y devuelve la primera coordenada Z que no es null.

La colección reproduce las etiquetas de los MDT cargados en Digi3D.AI, que se configuran en la topología y en las reglas de Z de sus códigos.

public sealed class DigitalTerrainModelCollection

La colección no es propietaria de los modelos: llama a Dispose en cada DigitalTerrainModel después de la última llamada a Project.

Constructores

public DigitalTerrainModelCollection()

Crea una colección vacía.

Propiedades

Propiedad Descripción
int Count Número de modelos que se han añadido.

Métodos

Add

public void Add(DigitalTerrainModel model, string tag)

Añade un modelo con una etiqueta.

Parámetro Descripción
model Modelo digital del terreno.
tag Etiqueta del modelo. Una etiqueta null se guarda como etiqueta vacía.

Lanza ArgumentNullException si model es null. No llames a Add mientras otro hilo llama a Project.

Project

public double? Project(Point3D groundPoint, string tag)

Devuelve la coordenada Z del terreno en la X y la Y de un punto, del primer modelo consultado según tag que devuelve una coordenada Z.

Parámetro Descripción
groundPoint Punto en coordenadas del terreno. Project ignora la coordenada Z de groundPoint.
tag Etiqueta de los modelos que se consultan. La comparación distingue mayúsculas de minúsculas (comparación ordinal). Si tag es null o está vacía, Project consulta todos los modelos, agrupados por etiqueta en el orden ordinal de la etiqueta y, dentro de cada etiqueta, en el orden en que se añadieron.

Devuelve el valor que devuelve DigitalTerrainModel.Project para el primer modelo que devuelve una coordenada Z. Devuelve null si ningún modelo consultado devuelve una coordenada Z. Una etiqueta null o vacía selecciona los modelos con cualquier etiqueta.

Lanza ObjectDisposedException si algún modelo consultado se ha liberado con Dispose.

Varios hilos pueden llamar a Project a la vez. La firma coincide con el parámetro projectZ de TopologyAnalyzer.CreatePolygon y CreatePolygons, por lo que se puede pasar coleccion.Project como projectZ.

Ejemplo

Este programa carga un MDT con la etiqueta MDT y otro con la etiqueta MDS, y consulta la Z de un punto con cada etiqueta y sin etiqueta:

using Digi21.DigiNG.Dtm;
using Digi21.Math;

if (args.Length != 4)
{
    Console.WriteLine("Uso: ConsultaZ <terreno.mdt> <superficie.mdt> <x> <y>");
    return 1;
}

using var terreno = DigitalTerrainModel.Open(args[0]);
using var superficie = DigitalTerrainModel.Open(args[1]);

var modelos = new DigitalTerrainModelCollection();
modelos.Add(terreno, "MDT");
modelos.Add(superficie, "MDS");

var punto = new Point3D(
    double.Parse(args[2], System.Globalization.CultureInfo.InvariantCulture),
    double.Parse(args[3], System.Globalization.CultureInfo.InvariantCulture),
    0);

Console.WriteLine($"{modelos.Count} modelos.");
Console.WriteLine($"Etiqueta MDT: {modelos.Project(punto, "MDT")?.ToString("F2") ?? "sin coordenada Z calculada"}");
Console.WriteLine($"Etiqueta MDS: {modelos.Project(punto, "MDS")?.ToString("F2") ?? "sin coordenada Z calculada"}");
Console.WriteLine($"Cualquier etiqueta: {modelos.Project(punto, "")?.ToString("F2") ?? "sin coordenada Z calculada"}");
return 0;