一、概述

Civil 3D是Autodesk公司面向基礎(chǔ)設(shè)施行業(yè)的推出的一款建筑信息模型解決方案軟件，能夠高效進(jìn)行道路、橋梁、隧道等項(xiàng)目的“平”“縱”“橫”參數(shù)設(shè)計(jì)，是市政BIM應(yīng)用的主要軟件之一。

實(shí)際項(xiàng)目中，我們遇到橫斷面往往復(fù)雜多變，結(jié)構(gòu)多樣且漸變，Civil 3D軟件自帶部件往往不能夠滿足我們的要求，這就需要我們?nèi)ザㄖ撇考?。Autodesk Subassembly Composer（后文稱(chēng)部件編輯器），是基于AutoCAD Civil 3D的部件創(chuàng)建工具軟件，其功能強(qiáng)大且簡(jiǎn)便易用，只需要通過(guò)可視化的軟件界面和圖形交互的方式，便可創(chuàng)建或修改復(fù)雜的用于AutoCAD Civil 3D的部件，而不再需要復(fù)雜的編程。

二、工作流簡(jiǎn)介

采用部件編輯器能夠快速精準(zhǔn)地制作出所需部件，其一般工作流程如下。

（1）確定橫斷面型式：根據(jù)圖紙資料對(duì)橫斷面進(jìn)行分析確定部件由幾部分構(gòu)成，如行車(chē)道、路肩、邊坡等；

（2）定義部件參數(shù)：對(duì)各部位結(jié)構(gòu)尺寸參數(shù)進(jìn)行設(shè)置，對(duì)邏輯目標(biāo)進(jìn)行設(shè)定，如設(shè)置長(zhǎng)、寬等參變量以及添加放坡曲面等；

（3）添加部件幾何要素：依照橫斷面形式，添加必要的點(diǎn)、連接及造型；

（4）編輯部件幾何元素：對(duì)添加的點(diǎn)、連接進(jìn)行參數(shù)設(shè)定，以便達(dá)到尺寸驅(qū)動(dòng)的目的；

（5）添加相應(yīng)代碼：向部件中添加必要的點(diǎn)代碼、連接代碼和造型代碼，方便后續(xù)導(dǎo)入Civil 3D中樣式控制以及信息提??；

（6）導(dǎo)出導(dǎo)入部件：保存部件至.pkt文件，并導(dǎo)入Civil 3D部件庫(kù)；

（7）測(cè)試及修改：在Cvil 3D中對(duì)編寫(xiě)的部件進(jìn)行測(cè)試，改變參數(shù)驗(yàn)證是否聯(lián)動(dòng)變化，發(fā)現(xiàn)問(wèn)題及時(shí)返回修改；

通過(guò)上述7個(gè)步驟就可以創(chuàng)建出一個(gè)自定義部件，實(shí)際項(xiàng)目過(guò)程中，我們可以通過(guò)定義一系列簡(jiǎn)單部件導(dǎo)入Civil 3D中進(jìn)行組合裝配生成最終橫斷面，也可以直接通過(guò)部件編輯器對(duì)整個(gè)橫斷面進(jìn)行編輯定義。

三、API函數(shù)

3.1API函數(shù)簡(jiǎn)介

API（Application Programming Interface）應(yīng)用編程接口，是操作系統(tǒng)為程序開(kāi)發(fā)人員提供的一組函數(shù)庫(kù)，開(kāi)發(fā)人員可以通過(guò)調(diào)用API簡(jiǎn)易的實(shí)現(xiàn)一些操作系統(tǒng)已經(jīng)提供的功能。常用的API函數(shù)可分為以下幾類(lèi)：點(diǎn)函數(shù)、線函數(shù)、超高坡度、偏移目標(biāo)、高程目標(biāo)、曲面目標(biāo)、基準(zhǔn)線目標(biāo)、枚舉類(lèi)型、狀態(tài)類(lèi)型以及鐵路超高。

3.2API函數(shù)舉例

1、點(diǎn)函數(shù)：用于獲取相對(duì)于上一點(diǎn)的水平位置、垂直位置、偏移位置、坡度、相對(duì)高程等位置屬性。

舉例：

P1.DistanceToSurface(ExistingSurface)>0.如果 P1 在曲面上方，將返回正值。如果 P1 在曲面下方，將返回負(fù)值。

2、線函數(shù)： 用于獲取連接 兩點(diǎn)的坡度、長(zhǎng)度、 高程 等屬性。

舉例：

HasIntersection(Link2ID as string, ExtendLink1 as bool=false, ExtendLink2 as bool=false).   確定當(dāng)前連接是否與另一連接相交。

3、偏移目標(biāo)類(lèi)： 用于 獲取目標(biāo)的偏移以及確定是否已指定目標(biāo)或目標(biāo)是否可供使用。

舉例 ：

OffsetTarget.Offset. 獲取 目標(biāo)的偏移值。

4、高程目標(biāo)類(lèi)： 用于 獲取目標(biāo)的 高程 以及確定是否已指定目標(biāo)或目標(biāo)是否可供使用。

舉例：

ElevationTarget.Elevation.獲取目標(biāo)的高程值。

5、基準(zhǔn)線類(lèi)： 用于獲取基準(zhǔn)路線上的當(dāng)前樁號(hào)、高程、起點(diǎn)、終點(diǎn)坡率以及轉(zhuǎn)彎方向等信息。

舉例：

Station.獲取基準(zhǔn)路線上的當(dāng)前樁號(hào)。

Elevation .獲取基準(zhǔn)線上的當(dāng)前高程。

RegionStart.獲取當(dāng)前區(qū)域的起點(diǎn)樁號(hào)。

RegionEnd.獲取當(dāng)前區(qū)域的終點(diǎn)樁號(hào)。

Grade .獲取基準(zhǔn)線縱斷面在當(dāng)前樁號(hào)處的坡率。

TurnDirection.基于曲線編組獲取當(dāng)前樁號(hào)處的轉(zhuǎn)彎方向。

四、多級(jí)邊坡案例詳解

4.1參數(shù)設(shè)置

為實(shí)現(xiàn)多級(jí)邊坡的參數(shù)化驅(qū)動(dòng)，在部件編輯器環(huán)境中對(duì)邊坡的坡度、級(jí)數(shù)、高度目標(biāo)等參數(shù)進(jìn)行預(yù)先設(shè)置。并說(shuō)明邏輯目標(biāo)參數(shù)，以便多級(jí)放坡和地形曲面在發(fā)生干涉的時(shí)候，多級(jí)邊坡可自動(dòng)識(shí)別判斷填挖方。

4.2幾何圖形創(chuàng)建

設(shè)置多級(jí)邊坡放坡原點(diǎn)以及地面線，然后基于該原點(diǎn)創(chuàng)建AP1參照點(diǎn)用于判斷填挖方放坡，再依次基于上一參照創(chuàng)建對(duì)應(yīng)放坡線，對(duì)于多級(jí)循環(huán)放坡應(yīng)用Loop Geometry命令來(lái)實(shí)現(xiàn)。

4.3定義部件代碼

部件代碼主要包含點(diǎn)代碼、連接代碼、造型代碼，其中點(diǎn)代碼用于控制多級(jí)放坡的變坡點(diǎn)、文本注釋等；連接代碼用于控制尺寸標(biāo)準(zhǔn)、參數(shù)標(biāo)準(zhǔn)等；造型代碼用于生成實(shí)體模型、工程量統(tǒng)計(jì)。

4.4部件測(cè)試

部件測(cè)試主要對(duì)部件的參數(shù)進(jìn)行驗(yàn)證優(yōu)化。將該部件導(dǎo)入至Civil 3D中創(chuàng)建一條邊坡實(shí)，驗(yàn)證邊坡的填挖判斷、變坡點(diǎn)、坡度是否滿足項(xiàng)目需求。