了解ZOS-API结构的基础知识

本文介绍了ZOS-API结构的基础知识和应用于ZOS-API的面向对象编程的概念。尽管ZOS-API面向对象的本质在很大程度上是“隐藏的”,但它可以帮助您更好地理解ZOS-API的词汇和结构。

作者 Sandrine Auriol

简介

本文将重点介绍一些关于面向对象编程的关键概念,以及如何在ZOS-API中使用它。您不需要成为开发人员就可以使用ZOS-API,同时,掌握一些基础知识将使得ZOS-API的使用变得更加简单。

什么是面向对象编程

面向对象语言(Object-Oriented Languages)使用了高效的方法进行编程。使用对象(Objects)种类(Classes)来组织数据,使代码可以在不同的工程中重复使用,而不是每次都从头开始编写。这个概念易于用来定义OpticStudio文件。

每个.zmx文件代表一个不同的序列和(或)非序列模式下的光学系统,这些光学系统中可以设置不同数量的物体和(或)表面,…

 

Different optical systems

在面向对象程序中,每个光学系统都被看作一个API“对象(Object) ”。光学系统有共同的特征,如波长、表面、…

面向对象编程中,具有共同特征的对象被分组到一个主列表中。具有这个特征的主列表被称为(Class)或接口(Interface)

Optical System Template

这些被进一步分组到称为名称空间(Namespaces)的库中。

如下为代码结构的总结:

Namespace (Library containing Classes and Interfaces)

Class / Interface: group (template with attributes)

Functions (action)

Property (set or get a value)

如果您想要获得更多信息,请查看链接: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/general-structure-of-a-csharp-program

ZOS-API的结构

ZOS-API是被称为名称空间接口层次结构。使用ZOS-API意味着创建API“对象”,作为是接口类型的一种。接口决定对象的哪些特性可用。

特性是指属性函数

  • 属性表示定义或者读取设置、已存储的值。
  • 函数为命令,表示对象可以执行的操作

调用对象函数属性总是会执行返回。可以进行返回的类型包括:

  • 数值(双精度型、整数型、…)、文本(字符串)、布尔(Boolean) (是或否)。
    int value = Object1.NumberOfFields;
  • 对象,作为一种接口
    IField New_Object = Object1.GetField(1);
  • 一种属性获取( [get] ),一种是获取、设置( [get, set] )。
    可用于获取数值的语句是: value = Object1.Normalization;
    可用于设置数值的语句是: Object1.Normalization = value;

接口的层次结构

让我们打开示例文件,看看代码是如何构成的。

  • 打开示例文件 "\Zemax\ZOS-API Sample Code\C#\CSharpStandalone_01_new_file_and_quickfocus.cs",这个示例文件可以用文本编辑器打开。

该示例文件是用c#编写的,但是面向对象编程的概念对于ZOS-API中使用的所有语言都是通用的。

  • 打开语法帮助文件(Syntax Help File)

Syntax Help File

帮助文件(Help File)中,主接口被称为ZOSAPI.IOpticalSystem,它相当于一个单独的ZMX文件。

IOpticalSystem

在示例文件中,第56行使用了主类 IOpticalSystem ZOSAPI.IopticalSystem,代码为:

IOpticalSystem TheSystem = TheApplication.PrimarySystem;

该行表示定义了称为TheSystem 的对象,该对象是IOpticalSystem接口的实例。这意味着创建了全新的光学系统,即新的 .zmx 文件。

要定义该系统的特征,请单击ZOSAPI.IOpticalSystem

Click IOpticalSystem

接口函数属性

TheSystem 的特征可以通过 IOpticalSystem 接口函数属性来描述。

的概念易于理解,因为在将 TheSystem 定义为 IOpticalSystem 类的对象时,它将具有访问 IOpticalSystem 所有特性的权限。这些特性定义了ZMX文件的共同特征。

Attributes of IOpticalSystem

LDEIOpticalSystem 接口的属性之一。使用 LDE 属性获取镜头数据编辑器(Lens Data Editor)的方法,如帮助文件中所示:

LDE

回到示例文件第95行,代码写法如下:

ILensDataEditor TheLDE = TheSystem.LDE;

该代码创建名为TheLDE 对象,即镜头数据编辑器。要创建TheLDE,可以使用TheSystemLDE 属性的代码。该属性返回名为ILensDataEditor接口。可以看出,ZOS-API是在接口的层次结构上构建的。

对象的创建过程被称为实例化(Instantiation)TheLDE 对象ILensDataEditor的实例。ILensDataEditor 接口函数属性可用于 TheLDE 对象

帮助文件中,要查看 ILensDataEditor 接口的属性,请单击ILensDataEditor

Click ILensDataEditor

继承

ILensDataEditor接口中,有属性函数。但也有从 IEditor继承的属性(Inherited Properties)

Inherited properties

IEditor称为父类(Parent Class)IEditor 父类为所有编辑器定义公共特征。

ILensDataEditor 子类(Child Class)定义了镜头数据编辑器特定的函数属性

单击 Ieditor 将会显示继承关系图,如下所示:

Inheritance diagram

子类可以访问父类的所有属性函数

例如,AddRow() 是所有编辑器通用的属性,它在父类中定义,并且可由子类访问。

AddRow术语提示

KA-01805

这篇文章有帮助吗?
0 人中有 0 人觉得有帮助

评论

0 条评论

文章评论已关闭。