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;

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com