CAA V5 Encyclopedia

Deprecated CATGitGSMGeom Function Removed

How to cope without it

Deprecated global function CATGitGSMGeom of the GSMInterfaces framework is now removed.

CATGitGSMGeom was a global function to be used when you wanted to derive from the Shape Design StartUp defining a GSMGeom object. This global function in fact encapsulated a call to the Feature Modeler standard function to create StartUps: CATOsmSUFactory. Since V5R13, CATGitGSMGeom is deprecated, and we recommend to directly use this Feature Modeler function CATOsmSUFactory instead. Now in V5R15, CATGitGSMGeom is removed. As a consequence, if you have not yet changed your applications to use CATOsmSUFactory, this code will not build. To avoid this, you should:

For existing StartUps created before V5R15
- Change your code to use CATOsmSUFactory instead of CATGitGSMGeom to avoid compilation error, as shown below
- DO NOT RUN this code TO REGENERATE THE CATALOGS. Once StartUps are generated, there is no need to regenerate them later on. THERE IS NO IMPACT ON THE PREVIOUS GENERATED CATALOGS
For new StartUps created starting with V5R15
- Create the StartUp creation code using the example below using CATOsmSUFactory
- Run it to generate the StartUps.

How to Create a StartUp Deriving from GSMGeom?

// ObjectSpecsModeler Service 
//-------------------------------------------------------------------------
#include "CATOsmSUFactory.h"
...
// Factory to create a new StartUp deriving from the Shape Design "GSMGeom" late type.
//-------------------------------------------------------------------------
HRESULT rc = E_FAIL;

// Predefined variables
CATUnicodeString CatalogName   = "CATHybridShape";
CATUnicodeString SuperTypeName = "GSMGeom";
CATBoolean       publicSU      = FALSE;
CATBoolean       derivableSU   = FALSE;

// CAA Developer defined variables
const CATUnicodeString *iTypeName = "MyStartUpType"; // The late type of the new StartUp to be created
CATICatalog *ipiClientCatalog     = "MyCatalog";     // The name of the catalog in which the new StartUp is to be created
CATISpecObject *opiStartUp        = NULL;            // The new StartUp created

rc = ::CATOsmSUFactory(&opiStartUp,
                       iTypeName,
                       ipiClientCatalog,
                       &SuperTypeName,
                       &CatalogName,
                       publicSU,
                       derivableSU); 
if (SUCCEEDED(rc) && (NULL != opiStartUp)) {
  ...
}

[Top]

History

Version: 1 [Jan 2005]	Document created
[Top]