shapeFeatureFile.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2025 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/

#ifndef SHAPEFEATUREFILE_H
#define SHAPEFEATUREFILE_H

#include "shape/shapeDefines.h"
#include "shape/shapefile.h"
#include "shape/shapeVectorInitializer.h"
#include <vlutil/vlFilename.h>
#include "gdb/specification.h"
#include "gdb/specificationManager.h"

class DtShapeReader;
class DtShapeVectorInitializer;
class DtGroup;

class DT_DLL_shape DtShapeFeatureFile : public DtShapefile
{

public:

   enum DtFeatureTypes
   {
      PointFeature,
      LinearFeature,
      ArealFeature

   };

   DtShapeFeatureFile(const DtShapeVectorInitializer* i);

   virtual ~DtShapeFeatureFile() override;

   virtual DtGroup *import(DtShapeReader *reader) override;

   virtual bool importFeatures(DtShapeVectorReader *reader) override;

protected:

   virtual bool initSpecification(int& fccCode, DtSpecification& spec, 
      DtSpecificationID& specID, DtFeatureTypes featureType, int recordNumber,
      const DtShapeVectorInitializer::DtShapeAttributeMapContainer& attributeAliasMap);

   virtual bool createNewSpecification(const DtFilename& specificationFilename, int fccCode, DtSpecification& spec, 
      DtSpecificationID& specID, DtFeatureTypes featureType, bool warn = true);

   // to the fieldNamesRead parameter list supplied by the caller.
   virtual void readMappedFeatureAttributes(DtSpecification& spec, 
      DtSpecificationID& specID, int recordNumber, 
      const DtShapeVectorInitializer::DtShapeAttributeMapContainer& attributeMap,
      std::list<DtString>& fieldNamesRead);

   // Attempts to read the specified field.  If successful, adds it to the
   // specification using the attribute name supplied.
   // \return True if successful.
   virtual bool readSingleFeatureAttribute(DtSpecification& spec,
      int recordNumber, unsigned int attributeType, const DtString& fieldName,
      const DtString& attributeName);

   // Any field with a name included in the fieldsToExclude list will
   // not be added by this function.
   virtual void readAllFeatureAttributes(DtSpecification& spec, 
      DtSpecificationID& specID, int recordNumber,
      const std::list<DtString>& fieldsToExclude);

   // Uses myFilename and the shapeFilenameMapping file in myEntry to choose
   // an FCC code based on the filename.
   virtual int findFccCodeFromFilename();

   // Loads the shapeAttributeAliasMap file specified by the initializer.
   // Adds all entries to the specified attributeMap.
   // \return True if the file was found and loaded.
   virtual bool loadShapeAttributeAliasMap(DtShapeVectorInitializer::DtShapeAttributeMapContainer& attributeMap);
};

#endif