Develop a COM Application (with C++)

TerraExplorer Desktop's rich API allows you to easily develop powerful, customized 3D desktop applications in several programming languages, including C#, JavaScript and C++. This article contains a step-by-step guide to application development with C++. 

Download code sample (built with Visual Studio 2019) >

Full TerraExplorer Programmer's Guide >

1. Download and install TerraExplorer.
2. Create a new Win32 Console Application project in Visual Studio, using Visual C++:
   • In Visual Studio, click Create a new project.
   • Select a C++ Console Application.
   • Name the project 'TerraExplorerShowcaseCPP'.
   • Click OK and then click Create.
3. Add the "#import" directive after the include statement to link your project to the TerraExplorer COM interface. It is used to incorporate TerraExplorer interfaces in your application. Make sure the name of the file in this command points to the TerraExplorer executable on your computer.

   #import "C:\Program Files\Skyline\TerraExplorer Pro\TerraExplorerX.dll" no_namespace, named_guids, no_namespace rename("GetObject","GetTEObject")

4. Initialize COM infrastructure inside your main method.

   CoInitialize(NULL);
    {
    // Work with TerraExplorer here, using SGWorld class
    }
   CoUninitialize();

5. Create the SGWorld CoClass.
   Note: You must create a SGWorld80 CoClass before working with the interfaces. The constant CLSID_SGWorld80 is automatically defined by the "#import" command.

   ISGWorld80Ptr pISGWorld;
   pISGWorld.CreateInstance(CLSID_SGWorld80);

6. Call the methods on the interface pointer.

   pISGWorld->Project->Open("https://www.skylineglobe.com/SkylineGlobeLayers/SG_ExternalFlys/skylineglobe7.fly",FALSE,"","");
   IPosition80Ptr pIPosition80 = pISGWorld->Creator->CreatePosition(-81.374173,28.537068,616.158537,AltitudeTypeCode::ATC_TERRAIN_RELATIVE, 312.967450,313.936515,0.0,0.0);
   pISGWorld->Navigate->FlyTo(_variant_t((IDispatch*)pIPosition80),ActionCode::AC_FLYTO);

7. Build and run the application.
8. Full code for the example.

   #import "C:\Program Files\Skyline\TerraExplorer Pro\TerraExplorerX.dll" no_namespace, named_guids, no_namespace rename("GetObject","GetTEObject")
   int main()
   {
   //std::cout << "Hello World!\n";
   CoInitialize(NULL);
   {
   try
   {
   // Work with TerraExplorer here, using SGWorld class
   ISGWorld80Ptr pISGWorld;
   pISGWorld.CreateInstance(CLSID_SGWorld80);
   pISGWorld->Project->Open("https://skylineglobe.com/sg/projects/JS_to_site_71.2896277", false, "", "");
   IPosition80Ptr pIPosition80 = pISGWorld->Creator->CreatePosition(-81.374173, 28.537068, 616.158537, AltitudeTypeCode::ATC_TERRAIN_RELATIVE, 312.967450, 313.936515, 0.0, 0.0);
   pISGWorld->Navigate->FlyTo(_variant_t((IDispatch*)pIPosition80), ActionCode::AC_FLYTO);
   }
   catch (_com_error& e)
   {
   // Crack _com_error
   _bstr_t bstrDescription(e.Description());
   }
   }
   CoUninitialize();
   }