Shape 子包
此子包包含用于定义 Shape(形状)以供纳入 Shapeset 的函数。Shape 是一种基本几何对象,例如线、矩形或文本。与注释不同,Shape 不能直接插入网络模型并显示。相反,Shape 会被添加到 Shapeset 模型中(通过 Shapeset 子包),随后 Shapeset 在 Slice(切片)中显示(使用 Slice 子包)。
Shape 共有八种类型:arc(圆弧)、ellipse(椭圆)、icon(图标)、label(标签)、polygon(多边形)、region(区域)、rectangle(矩形)和 round rectangle(圆角矩形)。你使用 Ets_Shape_<type>_Create() 函数创建 Shape。你还可以使用 Ets_Shape_Empty_Create() 创建一个不可见的 Shape,通常用于承载属性。要获取特定 Shape 的规格,使用对应的 Ets_Shape_<type>_Info_Get() 函数。
你可以使用 Ets_Shape_Type_Get() 获取现有 Shape 的类型。要释放 Shape 占用的内存,使用 Ets_Shape_Destroy()。
Shape 可以关联任意数量的简单命名属性。支持的属性类型有 int、double、string 和 toggle。要向 Shape 附加新属性,使用 Ets_Shape_Attr_Add()。你可以使用 Ets_Shape_Attr_Type_Get() 获取属性的类型,并使用 Ets_Shape_Attr_Get() 获取其值。要判断 Shape 是否具有某个特定属性,使用 Ets_Shape_Attr_Exists()。要获取 Shape 上所有已安装命名属性的列表,使用 Ets_Shape_Attr_Names_Get()。
Shape 颜色
你可以使用 RGB 或 HLS 颜色系统定义 Shape 中使用的颜色。要定义颜色,使用以下函数之一:
Shape 数据类型
若干 Shape 由矩形(box)或一组线段使用此处描述的数据类型定义。这些数据类型中的点使用度、米或英尺为单位。
矩形使用 EtsT_Shape_Rect,它通过坐标系中的左下角(minx, miny)和右上角(maxx, maxy)角点定义一个矩形。minx 和 miny 的值必须分别始终小于 maxx 和 maxy 的值。(但请注意,取决于坐标系的类型,左下角实际可能显示在右上角的上方。)
图 4:EtsT_Shape_Rect 类型定义
typedef struct EtsT_Shape_Rect
{
double minx;
double miny;
double maxx;
double maxy;
} EtsT_Shape_Rect;
不规则 Shape(如多边形和区域)由类型为 EtsT_Shape_Line_Section 的线段列表定义。xy_array 存放 x 和 y 坐标对,x 坐标位于偶数索引位置,y 坐标位于奇数索引位置。为一条含 N 个线段的线所必须分配的内存块大小为 (sizeof (EtsT_Shape_Line_Section) + (N-1) * sizeof (double) * 2)。
图 5:EtsT_Shape_Line_Section 类型定义
typedef struct EtsT_Shape_Line_Section
{
unsigned int num_points;
double xy_array [2];
/* actual storage to be dynamically allocated */
} EtsT_Shape_Line_Section;