上一篇文章已经完成了线束、线轴以及元件的操作，接下来可开始布线（Route）。Toolkit一共提供了ProCableRoutingStart、ProCableThruLocationRoute、roCableRoutingEnd、roCablelocationrefAlloc、roCablelocationrefFree五个函数用于对于布线操作。使用Toolkit进行布线操作官方文档给出解释如下，大致包括6个步骤：

To Route a Group of Cables Through a Sequence of Locations:
1.Call ProCableRoutingStart() to identify the cables to be routed.
2.Call ProCablelocationrefAlloc() to create a routing reference location structure.
3.Call ProCableThruLocationRoute() for each location through which to route the cables.
4.Call ProCablelocationrefFree() to free the location reference.
5.Call ProCableRoutingEnd() to complete the routing.
6.Call ProSolidRegenerate() to make Creo Parametric calculate the resulting cable geometry and > create the necessary cable features.
Note You must also call the function ProWindowRepaint() to see the new cables.

根据测试，实际操作过程中布线需要确定对应的位置和参照，而对应的位置和参照一般都会超过一个，所以上面的2-4步可以循环调用，实际代码流程图如下所示：

图 布线的流程

1.启动布线操作

调用ProCableRoutingStart函数即可开始布线。ProCableRoutingStart函数的参数有三个，第一个为装配体句柄，第二步为一个ProCable的ProArray数组，将上一篇文章中生成的ProCable结构体对象插入数组即可，第三个为ProRouting类型，作为输出用于后续的布线操作。官方给出ProCableRoutingStart的作用和使用说明如下：

After the call to ProCableRoutingStart(), the information about the routing in progress is contained in an opaque data structure ProRouting that ProCableRoutingStart() provides. This pointer is then given as an input to the functions ProCableThruLocationRoute() and ProCableRoutingEnd().
The inputs to ProCableRoutingStart() are the cabling assembly and harness handles, and an array of cables.

开始布线的示例代码如下，完成最开始所说布线6个步骤的第1个步骤：

1
2
3
4
5
6
7
status = ProArrayAlloc(0, sizeof(ProCable), 1, (ProArray *)&array_cable);
status = ProArrayObjectAdd((ProArray *)&array_cable, PRO_VALUE_UNUSED, 1, &cable);
status = ProCableRoutingStart(asm_mdl, array_cable, &cable_route_data);
if (status != PRO_TK_NO_ERROR)
{
  status = ProArrayFree((ProArray *)&array_cable);
}

2.布线操作

2.1 准备布线的位置引用（location reference）

布线时需要的位置引用（location reference）在Toolkit中为ProCablelocationref对象，由ProCablelocationrefAlloc分配和初始化内存。ProCablelocationref对象的初始化需要对应的Selection对象，自动化的时候遍历装配体可以使用ProSelectionAlloc函数程序自动添加坐标系到ProSelection对象，经测试手动选择对象ProSelect函数无法在ProCableRoutingStart后使用，所以如果是手动选择获取Selection对象必须在开始布线前获取。本文为简单说明，以两个坐标系(Csys)作为布线的起点和终点，采用手动选择的方式获取，代码如下：

1
2
3
4
5
6
7
8
9
int nSels = 0;
ProSelection *sel_array;
//选择两个坐标系用于布线，自动化的时候遍历装配体可以使用ProSelectionAlloc程序自动添加selection
status = ProSelect("csys", 2, NULL, NULL, NULL, NULL, &sel_array, &nSels); //filter与ProCablelocationref类型一致
if (status != PRO_TK_NO_ERROR || nSels <= 0)
{
  AfxMessageBox(_T("需要选择两个坐标系才能进行布线。\n这是一个测试程序，仅为演示使用。"));
  return;
}

ProCablelocationrefAlloc函数包含五个参数，其原型官方介绍如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
#include <ProCabling.h>
ProError ProCablelocationrefAlloc (
 ProCablelocationType type  
 /* (In)
 The location reference type
 */
 ProSelection* refs  
 /* (In)
 The ProArray of ProSelections (If the type is PRO_LOC_TYPE_CONNECTOR, PRO_LOC_TYPE_POINT, PRO_LOC_TYPE_AXIS, PRO_LOC_TYPE_OFFSET, or PRO_LOC_TYPE_LOC, one reference is sufficient).
 */
 ProBoolean with_axis_dir  
 /* (In)
 If PRO_B_TRUE, follow the axis direction. If PRO_B_FALSE, go in the opposite direction.
 */
 ProVector offset  
 /* (In)
 The offset
 */
 ProCablelocationref* ref  
 /* (Out)
 The location reference
 */
)

第1个参数为ProCablelocationType type表示位置引用的类型，官方给出解释如下：

type refs axis_flip offsets
PROLOC_CONNECTOR The coordinate system datum for the entry port — —
PROLOC_POINT The datum point — —
PROLOC_AXIS The axis 0 or 1 to show the routing direction -—
PROLOC_OFFSET The coordinate system datum to define the offset directions — Offset distances from the previous location
PROLOC_LOC An existing routing location — —

我遇到的情况都是以坐标系(Csys)作为布线的起点和终点，所以设置为PROLOC_CONNECTOR。
第二个参数ProSelection* refs为一个Selection数组，根据函数介绍，如果是上面表格所述类型，这个数组只要包含对应的Selection即可，为简单的ProArray操作：

1
2
3
status = ProArrayAlloc(0, sizeof(ProSelection), 1, (ProArray *)&sel_array_route);
status = ProArrayObjectAdd((ProArray *)&sel_array_route, -1, 1, &sel_array[i]);
status = ProCablelocationrefAlloc(locType, sel_array_route, PRO_B_TRUE, offset, &cablelocationref);

后面3个参数比较简单，在此不再说明，给出准备布线的位置引用（location reference）的示例代码：

1
2
3
4
5
6
7
8
ProCablelocationref cablelocationref;//联接线用的数据
ProCablelocationType locType = PRO_LOC_CONNECTOR; //联接线对应坐标系，The coordinate system datum for the entry port;与选择的selection对应，axis就必须选axis
ProVector offset = {0, 0, 0}; //ProCablelocation对应的偏移量，ProCablelocationrefAlloc函数使用
//2.Call ProCablelocationrefAlloc() to create a routing reference location structure.
//初始化ProCablelocationrefAlloc第二个参数，选择的第一个坐标系作为起点,sel_array只添加了一个
status = ProArrayAlloc(0, sizeof(ProSelection), 1, (ProArray *)&sel_array_route);
status = ProArrayObjectAdd((ProArray *)&sel_array_route, -1, 1, &sel_array[i]);
status = ProCablelocationrefAlloc(locType, sel_array_route, PRO_B_TRUE, offset, &cablelocationref);

2.2 布线

有了对应的位置引用（location reference），直接调用ProCableThruLocationRoute函数即可将布线通过该位置，其参数为之前ProCableRoutingStart生成的ProRouting数据以及ProCablelocationrefAlloc生成的ProCablelocationref数据：

1
2
//3.Call ProCableThruLocationRoute() for each location through which to route the cables.
status = ProCableThruLocationRoute(cable_route_data, cablelocationref, &p_location, &second_location);

2.3 释放内存

调用ProCableThruLocationRoute之后，对应的布线参考对象cablelocationref就不再需要，使用ProCablelocationrefFree释放其内存，同时记得释放构建cablelocationref时生成sel_array_route数组的内存，代码如下：

1
2
3
//4.Call ProCablelocationrefFree() to free the location reference.
status = ProCablelocationrefFree(cablelocationref);
status = ProArrayFree((ProArray *)&sel_array_route);

重复上述操作，即可确定布线的所有位置。

P.S. 使用ProConnectorDesignate可以将Selection对应的组件指定为装配连接器（assembly connector），但是测试发现不做这步也能完成布线，给出一下代码，希望有人能够帮忙解惑：

1
2
status = ProSelectionAsmcomppathGet(sel_array[i], &comp_path);
status = ProConnectorDesignate(&comp_path, NULL);

3.结束布线

结束布线只需调用ProCableRoutingEnd函数即可，其参数为之前ProCableRoutingStart生成的ProRouting数据：

1
2
//5.Call ProCableRoutingEnd() to complete the routing.
status = ProCableRoutingEnd(cable_route_data);

最后根据官方文档，需要调用ProSolidRegenerate和ProWindowRepaint才能显示生成的线缆。同时不要忘记在第一步中我们为array_cable申请了内存，记得释放，示例代码如下：

1
2
3
4
5
//6.Call ProSolidRegenerate() to make Creo Parametric calculate the resulting cable geometry and create the necessary cable features.
//Note You must also call the function ProWindowRepaint() to see the new cables.
status = ProSolidRegenerate((ProSolid)mdl, PRO_REGEN_NO_FLAGS);
status = ProWindowRepaint(PRO_VALUE_UNUSED);
status = ProArrayFree((ProArray *)&array_cable);

图 一键布线

完整代码可在Github.com下载。代码在VS2010,Creo 2.0 M060 X64下编译通过。