## On this page # Example 19 - C++ Last update: 17.07.2025 # C++ // CppStandaloneApplication.cpp : Defines the entry point for the console application. \#include "stdafx.h" \#include <stdlib.h> \#include <stdio.h> \#include <iostream> \#include <string> \#include <ctime> \#include <functional> \#include <assert.h> // Note - .tlh files will be generated from the .tlb files (above) once the project is compiled. // Visual Studio will incorrectly continue to report IntelliSense error messages however until it is restarted. \#include "zosapi.h" using namespace std; using namespace [ZOSAPI](namespace_z_o_s_a_p_i.xhtml); using namespace ZOSAPI_Interfaces; void handleError(std::string msg); void logInfo(std::string msg); void finishStandaloneApplication(IZOSAPI_ApplicationPtr TheApplication); int RunApplication() { CoInitialize(NULL); // Create the initial connection class IZOSAPI_ConnectionPtr TheConnection(__uuidof([ZOSAPI\_Connection](class_z_o_s_a_p_i_1_1_z_o_s_a_p_i___connection.xhtml))); // Attempt to create a Standalone connection IZOSAPI_ApplicationPtr TheApplication = TheConnection->CreateNewApplication(); if (TheApplication == nullptr) { handleError("An unknown error occurred!"); return -1; } // Check the connection status if (!TheApplication->IsValidLicenseForAPI) { handleError("License check failed!"); return -1; } if (TheApplication->Mode != ZOSAPI_Mode::ZOSAPI_Mode_Server) { handleError("Standlone application was started in the incorrect mode!"); return -1; } IOpticalSystemPtr TheSystem = TheApplication->PrimarySystem; // Add your custom code here... // creates new directory CreateDirectory(TheApplication->SamplesDir + "\\\\API", NULL); CreateDirectory(TheApplication->SamplesDir + "\\\\API\\\\CPP", NULL); // This code build a chain of prisms based on the KB article: // http://zemax.com/os/resources/learn/knowledgebase/how-to-work-in-global-coordinates-in-a-sequential TheSystem->New(false); // ISystemData represents the System Explorer in GUI. // We access options in System Explorer through ISystemData in ZOS-API ISystemDataPtr TheSystemData = TheSystem->SystemData; TheSystemData->Aperture->ApertureValue = 10; TheSystemData->Aperture->AFocalImageSpace = true; TheSystemData->Wavelengths->GetWavelength(1)->Wavelength = 0.55; ISDMaterialCatalogDataPtr(TheSystem->SystemData->MaterialCatalogs)->AddCatalog("SCHOTT"); // Get interface of Lens Data Editor and add 3 surfaces. ILensDataEditorPtr TheLDE = TheSystem->LDE; TheLDE->InsertNewSurfaceAt(2); TheLDE->InsertNewSurfaceAt(2); TheLDE->InsertNewSurfaceAt(2); // Set thickness and material for each surface. TheLDE->GetSurfaceAt(1)->Thickness = 30; TheLDE->GetSurfaceAt(2)->Thickness = 20; TheLDE->GetSurfaceAt(4)->Thickness = 30; TheLDE->GetSurfaceAt(2)->Material = "N-BK7"; // GetSurfaceAt(surface number shown in LDE) will return an interface ILDERow // Through property TiltDecenterData of each interface ILDERow, we can modify data in Surface Properties > Tilt/Decenter section TheLDE->GetSurfaceAt(2)->TiltDecenterData->BeforeSurfaceOrder = TiltDecenterOrderType_Decenter_Tilt; TheLDE->GetSurfaceAt(2)->TiltDecenterData->BeforeSurfaceTiltX = 15; TheLDE->GetSurfaceAt(2)->TiltDecenterData->AfterSurfaceTiltX = -15; TheLDE->GetSurfaceAt(3)->TiltDecenterData->BeforeSurfaceTiltX = -15; TheLDE->GetSurfaceAt(3)->TiltDecenterData->AfterSurfaceTiltX = 15; // To specify an aperture to a surface, we need to first create an ISurfaceApertureType and then assign it. ISurfaceApertureTypePtr Rect_Aper = TheLDE->GetSurfaceAt(2)->ApertureData->CreateApertureTypeSettings(SurfaceApertureTypes_RectangularAperture); Rect_Aper->_S_RectangularAperture->XHalfWidth = 10; Rect_Aper->_S_RectangularAperture->YHalfWidth = 10; TheLDE->GetSurfaceAt(2)->ApertureData->ChangeApertureTypeSettings(Rect_Aper); TheLDE->GetSurfaceAt(3)->ApertureData->PickupFrom = 2; // To change surface type, we need to first get an ISurfaceTypesettings and then assign it. ISurfaceTypeSettingsPtr SurfaceType_CB = TheLDE->GetSurfaceAt(4)->GetSurfaceTypeSettings(SurfaceType_CoordinateBreak); TheLDE->GetSurfaceAt(4)->ChangeType(SurfaceType_CB); // Set Chief Ray solves to surface 4, which is Coordinate Break // To set a solve to a cell in editor, we need to first create a ISolveData and then assign it. ISolveDataPtr Solve_ChiefNormal = TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par1)->CreateSolveType(SolveType_PickupChiefRay); TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par1)->SetSolveData(Solve_ChiefNormal); TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par2)->SetSolveData(Solve_ChiefNormal); TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par3)->SetSolveData(Solve_ChiefNormal); TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par4)->SetSolveData(Solve_ChiefNormal); TheLDE->GetSurfaceAt(4)->GetSurfaceCell(SurfaceColumn_Par5)->SetSolveData(Solve_ChiefNormal); // Copy 3 surfaces starting from surface number 2 in LDE and paste to surface number 5, // which will become surface number 8 after pasting. for (int i = 0; i < 10; i++) { TheLDE->CopySurfaces(2, 3, 5); } // Save file TheSystem->SaveAs(TheApplication->SamplesDir + "\\\\API\\\\CPP\\\\e19\_Sample\_Prism\_Chain.zos"); // Run tool Convert Local To Global Coordinates to convert surface #2 to surface #35 to be globally referenced to surface #1 TheLDE->RunTool_ConvertLocalToGlobalCoordinates(2, 35, 1); TheSystem->SaveAs(TheApplication->SamplesDir + "\\\\API\\\\CPP\\\\e19\_Sample\_Prism\_Chain\_GlobalCoordinate.zos"); // Run tool Conver Global To Local Coordinates to convert surface #1 to surface #57 back to local coordinate. TheLDE->RunTool_ConvertGlobalToLocalCoordinates(1, 57, ConversionOrder_Forward); TheSystem->SaveAs(TheApplication->SamplesDir + "\\\\API\\\\CPP\\\\e19\_Sample\_Prism\_Chain\_BackTo\_LocalCoordinate.zos"); \#if defined(\_DEBUG) // keeps console open when in debug mode system("pause"); \#endif // Clean up finishStandaloneApplication(TheApplication); return 0; } void handleError(std::string msg) { throw new exception(msg.c_str()); } void logInfo(std::string msg) { printf("%s", msg.c_str()); } void finishStandaloneApplication(IZOSAPI_ApplicationPtr TheApplication) { // Note - TheApplication will close automatically when this application exits, so this isn't strictly necessary in most cases if (TheApplication != nullptr) { TheApplication->CloseApplication(); } } int APIENTRY _tWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nCmdShow) { return RunApplication(); } int _tmain(int argc, _TCHAR* argv[]) { return RunApplication(); } [ZOSAPI.ZOSAPI\_Connection](class_z_o_s_a_p_i_1_1_z_o_s_a_p_i___connection.xhtml) **Definition:** ZemaxService.cs:198 [ZOSAPI](namespace_z_o_s_a_p_i.xhtml) The ZOSAPI namespace contains classes for initially connecting to zemax. See also ZOSAPI_Connection,... **Definition:** IAS_FieldCurvatureAndDistortion.cs:5