CppStandalone_19_Surface_Properties.cpp

// 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;
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));
 
 
    // 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();
}
ZOS-API interface 2025 R1

CppStandalone_19_Surface_Properties

Connect with Ansys
