Shp

Espacio de nombres: Digi21.DigiNG.IO.Shp
Ensamblado: Digi21.DigiNG.IO.Shp

Archivo de dibujo en formato Shapefile de ESRI. Un Shp representa una carpeta: cada archivo .shp de la carpeta es una capa, con su índice .shx, su tabla de atributos .dbf y su sistema de referencia de coordenadas .prj.

public class Shp : IDrawingFile, IDisposable

Implementa: IDrawingFile, que a su vez implementa IReadOnlyDrawingFile, IEnumerable<Entity> e IWindow3D.

La relación entre los códigos de Digi3D.AI y las capas la define la tabla de códigos: cada código tiene, en su traducción al formato Shapefile, el nombre de la capa en la que se guarda. Para escribir entidades hace falta, por tanto, una tabla de códigos con esa traducción.

El funcionamiento del formato en Digi3D.AI está descrito en Archivos Shapefile de ESRI.

Llama a Dispose (o usa using) para cerrar las capas.

Constructores

public Shp(string path)
public Shp(string path, CodePage codePage)
public Shp(string path, bool readOnly)
public Shp(string path, bool readOnly, CodePage codePage)
public Shp(string path, DelegateGetWkt GetWkt)
public Shp(string path, DelegateGetWkt GetWkt, CodePage codePage)
public Shp(string path, DelegateGetWkt GetWkt, bool readOnly)
public Shp(string path, DelegateGetWkt GetWkt, bool readOnly, CodePage codePage)
public Shp(string path, DigiTab digiTab)
public Shp(string path, DigiTab digiTab, CodePage codePage)
public Shp(string path, DigiTab digiTab, bool readOnly)
public Shp(string path, DigiTab digiTab, bool readOnly, CodePage codePage)
public Shp(string path, DigiTab digiTab, DelegateGetWkt GetWkt)
public Shp(string path, DigiTab digiTab, DelegateGetWkt GetWkt, CodePage codePage)
public Shp(string path, DigiTab digiTab, DelegateGetWkt GetWkt, bool readOnly)
public Shp(string path, DigiTab digiTab, DelegateGetWkt GetWkt, bool readOnly, CodePage codePage)

Al abrir, se cargan todas las capas de la carpeta que tienen archivo .shx. Las sobrecargas de esta clase no muestran el cuadro de diálogo de selección de capas.

Las coordenadas se guardan sin redondear (el parámetro Decimales de precisión del formato vale 0).

Los constructores lanzan Exception, con el mensaje del error, si falla la apertura de la carpeta; por ejemplo, si en la tabla de códigos varios códigos de la misma capa no tienen condición.

Propiedades

Métodos

Al guardar, una entidad no se escribe, y se notifica un mensaje con ResultsAdded (una sola vez por código), si su código no tiene traducción al formato Shapefile, no tiene nombre de capa o su tabla de base de datos no existe en el esquema de la tabla de códigos. Un código con la traducción desactivada no se escribe y no genera mensaje.

Excepciones de Add y Delete:

Eventos

CodePage

public enum CodePage : byte

Identificador de controlador de idioma (LDID) que se escribe en la cabecera de las tablas .dbf. Los valores siguen la tabla de páginas de códigos de ESRI.

CurrentANSICP y ANSI valen 0x57 (87), la página de códigos ANSI actual (1252). El ensamblado de referencia del paquete NuGet 26.0.0 declara CurrentANSICP = 0x51, que no es un LDID válido: usa ANSI.

Ejemplo

Este programa lista las capas de una carpeta de Shapefiles con el número de entidades de cada código:

using Digi21.DigiNG.IO.Shp;

if (args.Length != 1)
{
    Console.WriteLine(@"Uso: ListaCapas <carpeta\cualquiera.shp>");
    return 1;
}

// Solo lectura y sin tabla de códigos: se añade un código por cada capa.
using var carpeta = new Shp(args[0], true);
carpeta.ResultsAdded += (sender, e) => Console.WriteLine(e.Message);

var porCódigo = new SortedDictionary<string, int>();
foreach (var entidad in carpeta)
{
    var código = entidad.Codes[0].Name;
    porCódigo[código] = porCódigo.GetValueOrDefault(código) + 1;
}

foreach (var (código, número) in porCódigo)
    Console.WriteLine($"{código}: {número}");

return 0;

El ejemplo Bind2Shape escribe en una carpeta de Shapefiles las entidades de un archivo .bind, con una tabla de códigos que relaciona los códigos con las capas.