Skip to main content

ZOS-API interface 2024 R2 SP02

ZOSAPI.Tools.General Namespace Reference

Last update: 17.07.2025

Classes

interface  IComputeRMSSpotSize
 
interface  ICovarianceData
 
interface  ICreateArchive
 Interfaces and methods for creating a ZAR file. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  ICreateProject
 
interface  IDataDictionary
 
interface  IDataEntry
 
interface  IExportCAD
 Interfaces and methods for exporting the current system to various CAD formats. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  IHullTools
 
interface  ILensCatalogLens
 
interface  ILensCatalogs
 Interfaces and methods for searching the available Lens Catalogs. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  IPoint3D
 
interface  IPointList3D
 
interface  IPointTools
 
interface  IQuickAdjust
 Interfaces and methods for running the Quick Adjust tool. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  IQuickFocus
 Interfaces and methods for running the Quick Focus tool. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  IRayAimingWizard
 
interface  IRestoreArchive
 Interfaces and methods for restoring a ZAR file. This interface can be accessed via the IOpticalSystemTools interface. More...
 
interface  IRestoreProject
 
interface  IScale
 Interfaces and methods for Scaling the Currently active Lens System. This interface can be accessed via the IOpticalSystemTools interface. More...
 

Enumerations

enum  QuickAdjustType { Radius , Thickness }
 
enum  QuickAdjustCriterion {
  SpotSizeRadial = 0 , SpotSizeXOnly , SpotSizeYOnly , AngularRadial ,
  AngularXOnly , AngularYOnly
}
 
enum  QuickFocusCriterion { SpotSizeRadial = 0 , SpotSizeXOnly , SpotSizeYOnly , RMSWavefront }
 
enum  ArchiveFileStatus { Okay = 0 , UnableToOpen = -1 , InvalidFile = -2 , InvalidVersion = -3 }
 
enum  RayPatternType {
  XYFan = 0 , XFan , YFan , Ring ,
  List , Random , Grid , SolidRing
}
 
enum  SplineSegmentsType {
  N_016 = 0 , N_032 , N_064 , N_128 ,
  N_256 , N_512
}
 
enum  CADFileType {
  IGES = 0 , STEP , SAT , STL ,
  SAB , ASAT , ASAB , MODEL ,
  CATPART , CATPRODUCT , XCGM , ZMO ,
  XT , XB , PRC , JT ,
  N3MF , U3D , VRML , OBJ
}
 
enum  CADToleranceType { N_TenEMinus4 , N_TenEMinus5 , N_TenEMinus6 , N_TenEMinus7 }
 
enum  CADAngularToleranceType { Low = 0 , Medium , High , Presentation }
 
enum  ACISExportVersion {
  Current = 0 , V25 = 1 , V26 = 2 , V27 = 3 ,
  V28 = 4 , V29 = 5 , V30 = 6
}
 
enum  LensShape {
  Unknown , Equi , Bi , Plano ,
  Meniscus
}
 
enum  LensType {
  Other , Spherical , GRIN , Aspheric ,
  Toroidal
}
 
enum  ScaleToUnits { Millimeters , Centimeters , Inches , Meters }
 
enum  EntryCompressionModes { Auto = 0 , On = 1 , Off = 2 }
 
enum  ZemaxFileTypes { Unknown = 0 , LMX = 1 , User = 2 }
 
enum  DataTypes : short {
  NotSet , Boolean , Integer , IntegerArray ,
  IntegerMatrix , Float , FloatArray , FloatMatrix ,
  Double , DoubleArray , DoubleMatrix , String ,
  StringArray , StringMatrix , ByteArray , Dictionary ,
  Serializable , File
}
 

Enumeration Type Documentation

◆ ACISExportVersion

Enumerator
Current 
V25 
V26 
V27 
V28 
V29 
V30 

◆ ArchiveFileStatus

Enumerator
Okay 
UnableToOpen 
InvalidFile 
InvalidVersion 

◆ CADAngularToleranceType

Enumerator
Low 
Medium 
High 
Presentation 

◆ CADFileType

Enumerator
IGES 
STEP 
SAT 
STL 
SAB 
ASAT 
ASAB 
MODEL 
CATPART 
CATPRODUCT 
XCGM 
ZMO 
XT 
XB 
PRC 
JT 
N3MF 
U3D 
VRML 
OBJ 

◆ CADToleranceType

Enumerator
N_TenEMinus4 
N_TenEMinus5 
N_TenEMinus6 
N_TenEMinus7 

◆ DataTypes

Enumerator
NotSet 
Boolean 
Integer 
IntegerArray 
IntegerMatrix 
Float 
FloatArray 
FloatMatrix 
Double 
DoubleArray 
DoubleMatrix 
String 
StringArray 
StringMatrix 
ByteArray 
Dictionary 
Serializable 
File 

◆ EntryCompressionModes

Enumerator
Auto 
On 
Off 

◆ LensShape

Enumerator
Unknown 
Equi 
Bi 
Plano 
Meniscus 

◆ LensType

Enumerator
Other 
Spherical 
GRIN 
Aspheric 
Toroidal 

◆ QuickAdjustCriterion

Enumerator
SpotSizeRadial 
SpotSizeXOnly 
SpotSizeYOnly 
AngularRadial 
AngularXOnly 
AngularYOnly 

◆ QuickAdjustType

Enumerator
Radius 
Thickness 

◆ QuickFocusCriterion

Usage (see Example 15 for a full sample)

C#

//change BFL & run quick focus
Surface_Last.Thickness = 40.0;
IQuickFocus QFocus = tools.OpenQuickFocus();
QFocus.Criterion = QuickFocusCriterion.SpotSizeRadial;
QFocus.UseCentroid = true;
QFocus.Close();
SampleFile = System.IO.Path.Combine(TheApplication.SamplesDir, @"API\CS\e15_Seq_Optimization\OptimizedFile2.zos");
TheSystem.SaveAs(SampleFile);
Interfaces and methods for running the Quick Focus tool. This interface can be accessed via the IOpti...
Definition: Tools.cs:793
bool RunAndWaitForCompletion()
Sames as calling Run followed by WaitForCompletion.
bool Close()
Closes this tool and frees up and associated resources.
QuickFocusCriterion
Definition: Tools.cs:767

C++

// change BFL & run quick focus
Surface_Last->Thickness = 40.0;
IQuickFocusPtr QFocus = tools->OpenQuickFocus();
QFocus->Criterion = QuickFocusCriterion::QuickFocusCriterion_SpotSizeRadial;
QFocus->UseCentroid = true;
ISystemToolPtr baseTool = QFocus;
baseTool->RunAndWaitForCompletion();
baseTool->Close();
SampleFile = _bstr_t(TheApplication->SamplesDir) + "\\API\\CPP\\e15_Seq_Optimization\\OptimizedFile2.zos";
TheSystem->SaveAs(SampleFile);

Matlab

%change BFL & run quick focus
Surface_Last.Thickness = 40.0;
QFocus = tools.OpenQuickFocus();
QFocus.Criterion = ZOSAPI.Tools.General.QuickFocusCriterion.SpotSizeRadial;
QFocus.UseCentroid = true;
QFocus.RunAndWaitForCompletion();
QFocus.Close();
SampleFile = System.String.Concat(TheApplication.SamplesDir, '\API\Matlab\e15_Seq_Optimization\OptimizedFile2.zos');
TheSystem.SaveAs(SampleFile);
Definition: Tools.cs:697
Definition: FileSource.cs:4
The ZOSAPI namespace contains classes for initially connecting to zemax. See also ZOSAPI_Connection,...
Definition: IAS_FieldCurvatureAndDistortion.cs:5

Python

# change BFL & run quick focus
Surface_Last.Thickness = 40.0
QFocus = tools.OpenQuickFocus()
QFocus.Criterion = ZOSAPI.Tools.General.QuickAdjustCriterion.SpotSizeRadial
QFocus.UseCentroid = True
QFocus.RunAndWaitForCompletion()
QFocus.Close()
SampleFile = TheApplication.SamplesDir + '\\API\\Python\\e15_Seq_Optimization\\OptimizedFile2.zos'
TheSystem.SaveAs(SampleFile)
Enumerator
SpotSizeRadial 
SpotSizeXOnly 
SpotSizeYOnly 
RMSWavefront 

◆ RayPatternType

Enumerator
XYFan 
XFan 
YFan 
Ring 
List 
Random 
Grid 
SolidRing 

◆ ScaleToUnits

Enumerator
Millimeters 
Centimeters 
Inches 
Meters 

◆ SplineSegmentsType

Enumerator
N_016 
N_032 
N_064 
N_128 
N_256 
N_512 

◆ ZemaxFileTypes

Enumerator
Unknown 
LMX 
User 

Connect with Ansys