ossimEpsgProjectionFactory Class Reference

Projection Factory for coded projections defined in database. More...

#include <ossimEpsgProjectionFactory.h>

Inheritance diagram for ossimEpsgProjectionFactory:

Public Member Functions
virtual ossimProjection *	createProjection (const ossimFilename &filename, ossim_uint32 entryIdx) const
	STUB. Not implemented. More...
virtual ossimProjection *	createProjection (const ossimString &name) const
	This is the principal factory method. More...
virtual ossimProjection *	createProjection (const ossimKeywordlist &kwl, const char *prefix=0) const
	Looks for presence of "pcs_code" keyword with the value in the format <group>:, for example "EPSG:32615" (EPSG and AUTO–see above– are presently supported). More...
virtual ossimObject *	createObject (const ossimString &typeName) const
virtual ossimObject *	createObject (const ossimKeywordlist &kwl, const char *prefix=0) const
virtual void	getTypeNameList (std::vector< ossimString > &typeList) const
	This returns the type name of all objects in all factories. More...
Public Member Functions inherited from ossimProjectionFactoryBase
virtual ossimProjection *	createProjection (ossimImageHandler *handler) const
Public Member Functions inherited from ossimObjectFactory
virtual	~ossimObjectFactory ()
Public Member Functions inherited from ossimObject
	ossimObject ()
virtual	~ossimObject ()
virtual ossimObject *	dup () const
virtual ossimString	getShortName () const
virtual ossimString	getLongName () const
virtual ossimString	getDescription () const
virtual ossimString	getClassName () const
virtual RTTItypeid	getType () const
virtual bool	canCastTo (ossimObject *obj) const
virtual bool	canCastTo (const RTTItypeid &id) const
virtual bool	canCastTo (const ossimString &parentClassName) const
virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
virtual std::ostream &	print (std::ostream &out) const
	Generic print method. More...
virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const
virtual void	accept (ossimVisitor &visitor)
Public Member Functions inherited from ossimReferenced
	ossimReferenced ()
	ossimReferenced (const ossimReferenced &)
ossimReferenced &	operator= (const ossimReferenced &)
void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...
void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...
void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...
int	referenceCount () const

Static Public Member Functions
static ossimEpsgProjectionFactory *	instance ()
	Implements singleton pattern. More...

Protected Member Functions
	ossimEpsgProjectionFactory ()
	Constructor loads all SRS CSV files specified in the ossim prefs. More...
ossimMapProjection *	createProjFromAutoCode (const std::vector< ossimString > &spec) const
	When the CRS is specified with the "AUTO:<spec>" code format, this method is invoked to parse the <spec> and produce a projection (or NULL if spec invalid): This really shouldn't be in this class but nobody else is parsing for it, so leave it here for now. More...
Protected Member Functions inherited from ossimProjectionFactoryBase
ossimProjection *	createProjectionFromGeometryFile (const ossimFilename &imageFile, ossim_uint32 entryIdx) const
	This method takes the filename and tries to find an external ".geom" file. More...
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Detailed Description

Projection Factory for coded projections defined in database.

These are projections that are fully defined in database files and specified via a projection coordinate system (PCS) code, such as EPSG codes.

Definition at line 27 of file ossimEpsgProjectionFactory.h.

Constructor & Destructor Documentation

ossimEpsgProjectionFactory()

ossimEpsgProjectionFactory::ossimEpsgProjectionFactory ( )

protected

Constructor loads all SRS CSV files specified in the ossim prefs.

Protected as part of singleton implementation.

Definition at line 41 of file ossimEpsgProjectionFactory.cpp.

{
}

Member Function Documentation

createObject() [1/2]

ossimObject * ossimEpsgProjectionFactory::createObject ( const ossimString &  typeName ) const

virtual

Creates an object given a type name.

Implements ossimObjectFactory.

Definition at line 176 of file ossimEpsgProjectionFactory.cpp.

References createProjection().

{
   return createProjection(typeName);
}

createObject() [2/2]

ossimObject * ossimEpsgProjectionFactory::createObject ( const ossimKeywordlist &  kwl, const char *  prefix = 0  ) const

virtual

Creates and object given a keyword list.

Implements ossimObjectFactory.

Definition at line 182 of file ossimEpsgProjectionFactory.cpp.

References createProjection().

{
   return createProjection(kwl, prefix);
}

createProjection() [1/3]

ossimProjection * ossimEpsgProjectionFactory::createProjection ( const ossimFilename &  filename, ossim_uint32  entryIdx  ) const

virtual

STUB. Not implemented.

Implements ossimProjectionFactoryBase.

Definition at line 191 of file ossimEpsgProjectionFactory.cpp.

Referenced by createObject(), createProjection(), ossimPointCloudImageHandler::getImageGeometry(), ossimGpkgTileEntry::getNewMapProjection(), ossimGpkgWriter::getNewOutputProjection(), ossimTiffInfo::getPcsCode(), ossimFgdcXmlDoc::getProjection(), ossimGeoPdfReader::getVPGeoProjection(), and ossimGeoTiff::parsePcsCode().

{
   return 0;
}

createProjection() [2/3]

ossimProjection * ossimEpsgProjectionFactory::createProjection ( const ossimString &  name ) const

virtual

This is the principal factory method.

It accepts a string in one of three formats:

1. <group>:, for example "EPSG:32615"
2. , for example "32615", this is the CRS code ID for the projerection.
3. AUTO:<comma-separated spec>, for specifying custom user-defined codes.

Both projected and geographic (Platte Carre) codes are handled.

Implements ossimProjectionFactoryBase.

Definition at line 96 of file ossimEpsgProjectionFactory.cpp.

References ossimString::after(), createProjFromAutoCode(), ossimString::explode(), ossimEpsgProjectionDatabase::findProjection(), ossimEpsgProjectionDatabase::instance(), and ossimString::trim().

{
   std::vector<ossimString> split_line;
   
   // Intercept custom codes here before resorting to the database. This really shouldn't be in this
   // class but nobody else is parsing for it, so leave it here for now.
   if (ossimString(spec).downcase().contains("auto"))
   {
      split_line = spec.after(":").explode(",");
      return createProjFromAutoCode(split_line);
   }

   // Strip commonly found or bar '|' from end if present.
   ossimString s = spec;
   s.trim(ossimString("|"));

   // Otherwise, pass along the request to the database object for record search:
   return ossimEpsgProjectionDatabase::instance()->findProjection(s);
}

createProjection() [3/3]

ossimProjection * ossimEpsgProjectionFactory::createProjection ( const ossimKeywordlist &  kwl, const char *  prefix = 0  ) const

virtual

Looks for presence of "pcs_code" keyword with the value in the format <group>:, for example "EPSG:32615" (EPSG and AUTO–see above– are presently supported).

From keywordlist.

If only an integer is specified, EPSG code is assumed.

Implements ossimProjectionFactoryBase.

Definition at line 48 of file ossimEpsgProjectionFactory.cpp.

References ossimKeywordlist::addList(), createProjection(), ossimString::empty(), ossimKeywordlist::find(), ossimProjection::loadState(), ossimKeywordNames::PCS_CODE_KW, ossimKeywordNames::PIXEL_SCALE_UNITS_KW, ossimKeywordNames::PIXEL_SCALE_XY_KW, ossimKeywordNames::PROJECTION_KW, ossimKeywordlist::remove(), ossimProjection::saveState(), ossimKeywordNames::TIE_POINT_UNITS_KW, and ossimKeywordNames::TIE_POINT_XY_KW.

{
    ossimProjection* proj = 0;

   // Look for a PCS (Projected Coordinate System) code entry and construct the basic projection.
   // This is the bootstrap for creating the fully-initialized proj:
   ossimString proj_spec = keywordList.find(prefix, ossimKeywordNames::PCS_CODE_KW);
   if(!proj_spec.empty())
      proj = createProjection(proj_spec);
  
   if (!proj)
   {
      // An alternate way of specifying an EPSG projection is by its database name:
      proj_spec = keywordList.find(prefix, ossimKeywordNames::PROJECTION_KW);
      proj = createProjection(proj_spec);
   }

   if (!proj)
      return NULL;

   // The tie points and perhaps other params might still be in the KWL, so pass the KWL on to the
   // new projection after it has been amended with the default proj info extracted from the 
   // EPSG code (i.e., sans tiepoints and gsd):
   ossimKeywordlist proj_kwl;
   proj->saveState(proj_kwl, prefix);
   proj_kwl.remove(prefix, ossimKeywordNames::PIXEL_SCALE_XY_KW);
   proj_kwl.remove(prefix, ossimKeywordNames::PIXEL_SCALE_UNITS_KW);
   proj_kwl.remove(prefix, ossimKeywordNames::TIE_POINT_XY_KW);
   proj_kwl.remove(prefix, ossimKeywordNames::TIE_POINT_UNITS_KW);
   proj_kwl.addList(keywordList, false); // false: do not override existing items
   proj->loadState(proj_kwl, prefix);
   
   return proj;
}

createProjFromAutoCode()

ossimMapProjection * ossimEpsgProjectionFactory::createProjFromAutoCode ( const std::vector< ossimString > &  spec ) const

protected

When the CRS is specified with the "AUTO:<spec>" code format, this method is invoked to parse the <spec> and produce a projection (or NULL if spec invalid): This really shouldn't be in this class but nobody else is parsing for it, so leave it here for now.

When the CRS is specified with the "AUTO:<spec>" code format, this method is invoked to parse the <spec> and produce a projection (or NULL if spec invalid):

Definition at line 121 of file ossimEpsgProjectionFactory.cpp.

References ossimGpt::latd(), ossimGpt::lond(), ossimTransMercatorProjection::setFalseNorthing(), ossimUtmProjection::setHemisphere(), ossimUtmProjection::setOrigin(), ossimEquDistCylProjection::setOrigin(), ossimMapProjection::setOrigin(), ossimTransMercatorProjection::setScaleFactor(), ossimUtmProjection::setZone(), ossimUtmProjection::update(), ossimTransMercatorProjection::update(), ossimOrthoGraphicProjection::update(), and ossimEquDistCylProjection::update().

Referenced by createProjection().

{
   if (spec.size() < 3)
      return 0;

   ossim_uint32 code = spec[0].toUInt32();
   ossimGpt origin (spec[2].toDouble(), spec[1].toDouble()) ;

   // Only a few AUTO codes are considered:
   switch(code)
   {
      case 42001:
      {
         ossimUtmProjection* utm = new ossimUtmProjection;
         utm->setZone(origin);
         utm->setHemisphere(origin);
         utm->setOrigin(origin);
         utm->update();
         //utm->setPcsCode(42001);
         return utm;
      }
      
      case 42002:
      {
         ossimTransMercatorProjection* transMerc = new ossimTransMercatorProjection;
         transMerc->setFalseNorthing(origin.latd()>=0.0?0.0:10000000.0);
         transMerc->setOrigin(ossimGpt(0.0, origin.lond()));
         transMerc->setScaleFactor(.9996);
         transMerc->update();
        // transMerc->setPcsCode(42002);
         return transMerc;
      }
      
      case 42003:
      {
         ossimOrthoGraphicProjection* ortho = new ossimOrthoGraphicProjection;
         ortho->setOrigin(origin);
         ortho->update();
         //ortho->setPcsCode(42003);
         return ortho;
      }
      
      case 42004:
      {
         ossimEquDistCylProjection* geographic = new ossimEquDistCylProjection;
         geographic->setOrigin(origin);
         geographic->update();
         //geographic->setPcsCode(42004);
         return geographic;
      }
   }
   return 0;
}

getTypeNameList()

void ossimEpsgProjectionFactory::getTypeNameList ( std::vector< ossimString > &  typeList ) const

virtual

This returns the type name of all objects in all factories.

This is the name used to construct the objects dynamically and this name must be unique.

Implements ossimObjectFactory.

Definition at line 201 of file ossimEpsgProjectionFactory.cpp.

References ossimEpsgProjectionDatabase::getProjectionsList(), and ossimEpsgProjectionDatabase::instance().

{
   ossimEpsgProjectionDatabase::instance()->getProjectionsList(typeList);
   return;
}

instance()

ossimEpsgProjectionFactory * ossimEpsgProjectionFactory::instance ( )

static

Implements singleton pattern.

METHOD: instance() Instantiates singleton instance of this class:

Definition at line 27 of file ossimEpsgProjectionFactory.cpp.

Referenced by ossimPointCloudImageHandler::getImageGeometry(), ossimGpkgTileEntry::getNewMapProjection(), ossimGpkgWriter::getNewOutputProjection(), ossimTiffInfo::getPcsCode(), ossimFgdcXmlDoc::getProjection(), ossimGeoPdfReader::getVPGeoProjection(), ossimProjectionFactoryRegistry::initializeDefaults(), and ossimGeoTiff::parsePcsCode().

{
   static ossimEpsgProjectionFactory inst;
   
   return &inst;

   //if(!m_instance)
   //   m_instance = new ossimEpsgProjectionFactory;
   //return m_instance;
}

---

The documentation for this class was generated from the following files:

• ossimEpsgProjectionFactory.h
• ossimEpsgProjectionFactory.cpp