做了這么多年Creo二次開發(fā)我最大的感觸是出圖環(huán)節(jié)里最磨人的往往不是建模而是那些看起來毫無技術(shù)含量的球標(biāo)標(biāo)注。一個(gè)三百來件的大裝配BOM表生成出來很快但球標(biāo)一個(gè)一個(gè)手動(dòng)點(diǎn)、一個(gè)一個(gè)挪位置能讓人從下午三點(diǎn)坐到晚上十點(diǎn)。這也是我當(dāng)初下定決心寫球標(biāo)函數(shù)工具的原因。這篇東西我不打算寫成一個(gè)API手冊式的流水賬而是想聊聊我自己對(duì)球標(biāo)自動(dòng)化這件事的理解球標(biāo)在Creo里到底是什么、調(diào)用鏈該怎么設(shè)計(jì)、批量創(chuàng)建時(shí)有哪些坑是文檔里不會(huì)告訴你的。如果你是剛接觸Creo二次開發(fā)的工程師或者正被裝配圖球標(biāo)折磨得夠嗆的工藝/設(shè)計(jì)同事這篇文章應(yīng)該能幫你少走不少彎路。1. 球標(biāo)標(biāo)注為什么是工程圖出圖的頭號(hào)耗時(shí)項(xiàng)先說清楚球標(biāo)是什么。在工程圖上球標(biāo)就是那個(gè)帶引線的圓圈圓圈里寫序號(hào)引線指向某個(gè)零件。它的序號(hào)并不是隨便編的而是和BOM表在Creo里通常叫重復(fù)區(qū)域表里的行號(hào)一一對(duì)應(yīng)。也就是說圖上每個(gè)球標(biāo)背后都對(duì)應(yīng)著明細(xì)欄里的某一行零件信息。手動(dòng)放球標(biāo)的問題在于它不是放完就完事了而是放了以后基本都要再調(diào)一頓。調(diào)整的理由五花八門引線交叉零件多了球標(biāo)扎堆引線繞成一團(tuán)圖面沒法看。序號(hào)與BOM行對(duì)不上模型改了一版某個(gè)零件刪掉了后面的序號(hào)全部順延手動(dòng)改一批圓圈里的數(shù)字。標(biāo)準(zhǔn)和風(fēng)格不統(tǒng)一有的球標(biāo)是圓的有的是橢圓的有的引線連在邊上有的連在面上。看著鬧心審圖的人也挑毛病。視圖更新后球標(biāo)漂移或者丟失模型改了視圖重新生成辛辛苦苦擺好的位置全部白費(fèi)。我見過很多公司對(duì)球標(biāo)的處理方式就是認(rèn)了因?yàn)橛X得改球標(biāo)是不可避免的重復(fù)勞動(dòng)。但仔細(xì)想想這些操作其實(shí)高度規(guī)律根據(jù)BOM表行號(hào)確定序號(hào)、根據(jù)零件位置確定引線連接點(diǎn)、根據(jù)規(guī)則確定擺放區(qū)域。只要是規(guī)律性的操作就有自動(dòng)化的空間。所以球標(biāo)函數(shù)要解決的核心問題可以概括成一句話把人工逐個(gè)創(chuàng)建球標(biāo)人工整理位置變成程序按規(guī)則批量生成一鍵刷新。這種自動(dòng)化的收益在50個(gè)零件以上的裝配圖里非常明顯零件越多收益越夸張。我自己做的工具在三百件左右的裝配圖上原先手動(dòng)搞一個(gè)多小時(shí)現(xiàn)在程序批量跑一遍加檢查和修改大概一首歌的時(shí)間。2. 球標(biāo)不是獨(dú)立注釋和視圖、BOM表的依賴關(guān)系很多剛接觸球標(biāo)開發(fā)的人第一個(gè)誤區(qū)就是把它當(dāng)成普通注釋note來對(duì)待。普通注釋是獨(dú)立實(shí)體隨便放哪都行。球標(biāo)完全不是這么回事。在Creo的工程圖數(shù)據(jù)模型里球標(biāo)是一個(gè)掛在視圖對(duì)象下面的子實(shí)體它必須依賴兩個(gè)東西才能活第一必須有一個(gè)視圖。球標(biāo)不是滿天亂飛的注釋它必須屬于某個(gè)視圖而且它的引線連接參照連到哪個(gè)面、哪條邊、哪個(gè)軸也是針對(duì)該視圖里的模型幾何而言的。第二必須關(guān)聯(lián)到BOM重復(fù)區(qū)域表。球標(biāo)序號(hào)不是自己隨便編的數(shù)字它是從重復(fù)區(qū)域表的某個(gè)列一般是索引列取來的。如果沒有綁定重復(fù)區(qū)域你創(chuàng)建出來的球標(biāo)基本就是個(gè)空圈序號(hào)永遠(yuǎn)填不進(jìn)去。所以完整的依賴鏈路是這樣的三維裝配模型 → 工程圖繪圖 → 視圖對(duì)象 → BOM重復(fù)區(qū)域表 → 球標(biāo)對(duì)象在開發(fā)層面對(duì)應(yīng)的對(duì)象層級(jí)大致是ProDrawing工程圖 └── ProSheet圖頁 └── ProView視圖 └── ProBalloon球標(biāo)我建議所有準(zhǔn)備寫球標(biāo)函數(shù)的人先把這個(gè)層級(jí)背下來因?yàn)楹竺?0%的bug都是層級(jí)理解不到位造成的后面我會(huì)專門講。另外提一下開發(fā)方式的選擇。Creo二次開發(fā)常見的有三種路子基于C的Pro/TOOLKIT、基于Java的J-Link、以及VB/C#那套API。球標(biāo)這種底層依賴視圖和表的操作我個(gè)人最推薦C的Pro/TOOLKIT。原因很簡單C接口離內(nèi)核最近函數(shù)覆蓋最全尤其是批處理場景下性能優(yōu)勢明顯。J-Link也能做但有些底層枚舉和回調(diào)處理不如C接口順手。VB/C#適合做小工具跑一些簡單的界面交互還可以做大型裝配批量球標(biāo)處理我不太建議性能和維護(hù)性都吃虧。3. 球標(biāo)函數(shù)的調(diào)用鏈路從視圖收集到球標(biāo)落位這一節(jié)是核心。我講的是我實(shí)際封裝后的調(diào)用流程而不是某個(gè)版本的具體API手冊。有一點(diǎn)先說明Creo不同版本、不同小版本的PRO/TOOLKIT接口聲明多多少少有差異函數(shù)名這種東西一定要以你自己機(jī)器上安裝目錄里protoolkit/inc下面的頭文件為準(zhǔn)。我下面代碼里的命名是我自己封裝層的命名風(fēng)格上盡量貼近官方但你直接復(fù)制是不行的得對(duì)著自己的頭文件改。整個(gè)球標(biāo)創(chuàng)建鏈路由五個(gè)環(huán)節(jié)組成缺一不可。第一步拿到工程圖。這個(gè)比較簡單打開當(dāng)前文檔確定它是繪圖類型就行。如果做批處理就是遍歷指定目錄下的所有繪圖文件。第二步收集目標(biāo)視圖。通過視圖收集接口把這個(gè)圖頁里所有視圖列出來。這里有個(gè)小技巧不是每個(gè)視圖都需要球標(biāo)我一般只處理常規(guī)視圖general view類型投影視圖、剖視圖這些通常不需要重復(fù)放球標(biāo)。過濾條件不同版本寫法不同但思路是固定的。// 示意代碼收集當(dāng)前圖頁中的全部視圖 #include ProDrawing.h #include ProView.h ProError CollectTargetViews(ProDrawing drawing, ProView *views, int *count) { ProError status ProDrawingViewCollect(drawing, views); if (status ! PRO_TK_NO_ERROR) return status; int n 0; for (int i 0; i *count; i) { ProViewType type; if (ProViewTypeGet(views[i], type) PRO_TK_NO_ERROR) { if (type PRO_GENERAL_VIEW) { views[n] views[i]; // 只保留常規(guī)視圖 } } } *count n; return PRO_TK_NO_ERROR; }第三步檢查BOM重復(fù)區(qū)域表。這一步很多人會(huì)跳過但我要說別跳。球標(biāo)能不能顯示序號(hào)完全取決于重復(fù)區(qū)域表是否健在、是否已經(jīng)更新。判斷方式也是遍歷繪圖上的表對(duì)象找到類型為重復(fù)區(qū)域的表再檢查表里是否有一個(gè)可用作索引的列。// 示意代碼確認(rèn)視圖對(duì)應(yīng)當(dāng)前圖頁中存在重復(fù)區(qū)域表 ProError CheckRepeatRegion(ProDrawing drawing, int *region_exists) { *region_exists 0; ProDwgTable tables; int n; ProDwgTableCollect(drawing, tables); ProArraySizeGet(tables, n); for (int i 0; i n; i) { if (ProRepeatRegionIsRepeatRegion(tables[i]) PRO_TK_NO_ERROR) { *region_exists 1; break; } } ProArrayFree(tables); return PRO_TK_NO_ERROR; }第四步創(chuàng)建球標(biāo)并設(shè)置數(shù)據(jù)。球標(biāo)創(chuàng)建接口通常需要一個(gè)視圖句柄、一個(gè)放置點(diǎn)、一個(gè)連接參照和一個(gè)參數(shù)結(jié)構(gòu)。參數(shù)結(jié)構(gòu)里最主要的東西包括球標(biāo)類型圓/橢圓/旗形/自定義符號(hào)、文本高度、引線樣式、連接方向等。有一個(gè)必須注意的細(xì)節(jié)放置點(diǎn)坐標(biāo)必須是當(dāng)前工程圖頁的絕對(duì)坐標(biāo)繪圖坐標(biāo)不是相對(duì)于視圖的偏移。這個(gè)坐標(biāo)一般用視圖中某個(gè)點(diǎn)的坐標(biāo)加上一個(gè)偏移量算出來。// 示意代碼創(chuàng)建一個(gè)圓型球標(biāo)并指定連接參照 ProError CreateOneBalloon( ProView view, ProSelection attach_ref, // 引線連接參照邊/面/軸/點(diǎn) double sheet_x, double sheet_y, // 繪圖坐標(biāo)系的放置位置 int balloon_type // 0圓 1橢圓 2旗形 ) { // 構(gòu)造參數(shù)結(jié)構(gòu)不同版本字段略有差別務(wù)必以頭文件為準(zhǔn) ProBalloonCreateData data; PRO_BALLOON_CREATE_DATA_DEF(data); data.type balloon_type; data.height 3.0; // 球標(biāo)字高取決于繪圖標(biāo)準(zhǔn) data.place_point[0] sheet_x; data.place_point[1] sheet_y; data.attach attach_ref; // 調(diào)用球標(biāo)創(chuàng)建接口 return ProViewBalloonCreate(view, data, NULL); }如果你的調(diào)用連這個(gè)都報(bào)錯(cuò)先別急著懷疑球標(biāo)接口有問題回頭檢查上面兩步視圖是否有效、重復(fù)區(qū)域表是否存在。我在項(xiàng)目里見過太多次最后查出來根本不是球標(biāo)函數(shù)的問題。第五步創(chuàng)建完成后刷新重繪。批量創(chuàng)建完一堆球標(biāo)以后會(huì)有個(gè)很隱蔽的問題球標(biāo)實(shí)體在數(shù)據(jù)里有了但圖面上沒刷出來。所以最后一定要調(diào)用一次視圖更新和圖形重繪的接口強(qiáng)制把球標(biāo)顯示出來。這也是看起來創(chuàng)建失敗其實(shí)成功了的一個(gè)重要原因。4. 球標(biāo)樣式和引線控制參數(shù)才是細(xì)節(jié)里的魔鬼球標(biāo)函數(shù)寫起來不難難的是樣式和引線的控制。工程圖有工程圖的規(guī)矩尤其是外發(fā)圖紙球標(biāo)樣式必須符合企業(yè)標(biāo)準(zhǔn)。Creo里球標(biāo)樣式常見的有這么幾類樣式外觀典型場景踩坑提示圓形圓圈內(nèi)序號(hào)最通用絕大多數(shù)企業(yè)默認(rèn)序號(hào)超過兩位數(shù)時(shí)圓圈可能顯得擠橢圓形橢圓內(nèi)序號(hào)部分歐洲客戶圖紙規(guī)范長軸方向受文本影響重新生成會(huì)變旗形小矩形加折線引線局部放大圖的零件標(biāo)注引線起點(diǎn)位置難控制自定義符號(hào)公司標(biāo)準(zhǔn)符號(hào)有企業(yè)圖標(biāo)的單位符號(hào)實(shí)例名必須事先加載到工程圖模板三角等其他樣式略小眾標(biāo)準(zhǔn)非內(nèi)置樣式需要額外定義我平時(shí)用圓形最多。但圓形球標(biāo)有一個(gè)容易被忽略的問題序號(hào)位數(shù)變了圓的視野是不夠的。9號(hào)球標(biāo)和10號(hào)球標(biāo)圓的顯示效果差不少。程序里如果只是設(shè)置高度而不考慮文本寬度兩位數(shù)序號(hào)在球標(biāo)里容易碰到圓圈邊打出來的圖紙?zhí)貏e難看。解決方式是在創(chuàng)建時(shí)預(yù)留文本寬度余量或者直接改用自定義符號(hào)并把符號(hào)做得大一些。引線控制是另一個(gè)大坑。球標(biāo)引線的連接參照可以選邊、面、軸、基準(zhǔn)點(diǎn)、坐標(biāo)系每種參照在程序里構(gòu)造的Selection類型都不同。用邊做參照引線端點(diǎn)是邊的某個(gè)位置用面做參照引線端點(diǎn)在面內(nèi)某處如果用軸球標(biāo)引線甚至可以是帶箭頭的折線。這些選擇直接影響出圖質(zhì)量對(duì)于鈑金件連在邊上最清晰工程上默認(rèn)也是邊優(yōu)先。對(duì)于只有一個(gè)面暴露在視圖上的零件連面比連邊穩(wěn)。對(duì)于回轉(zhuǎn)體零件連軸更專業(yè)球標(biāo)能體現(xiàn)中心線特征?；鶞?zhǔn)點(diǎn)連接適合特殊情況比如在剖視圖里標(biāo)注孔位。程序里批量處理時(shí)我不建議對(duì)不同零件做智能判斷連邊還是連面?？此浦悄軐?shí)則難維護(hù)。我的做法是統(tǒng)一優(yōu)先連邊如果某個(gè)零件在該視圖中沒有可用邊再降級(jí)連面。這個(gè)邏輯用簡單的判斷就能實(shí)現(xiàn)穩(wěn)定可靠。還有引線折線的參數(shù)。引線樣式是否帶折線引線短線長度多少這些在Creo里都有對(duì)應(yīng)配置不同模板默認(rèn)值不一樣。我踩過的坑是程序創(chuàng)建的球標(biāo)引線到了某個(gè)裝配圖上突然變得特別短引線箭頭直接扎進(jìn)零件里檢查了整整半天才發(fā)現(xiàn)是模板里設(shè)置的引線短線長度參數(shù)有問題。所以批量處理前先確認(rèn)繪圖模板里的引線參數(shù)否則你代碼寫得再好也白搭。5. 批量創(chuàng)建球標(biāo)時(shí)最容易踩的五個(gè)坑與完整排查過程這一節(jié)我重點(diǎn)講一個(gè)真實(shí)場景。某次我寫了一個(gè)批量球標(biāo)工具輸入是一堆裝配圖輸出是全部自動(dòng)加好球標(biāo)的圖紙。第一次跑批量三百多張圖結(jié)果有七八十張球標(biāo)少了一半有的圖甚至一個(gè)球標(biāo)都沒有。當(dāng)時(shí)第一反應(yīng)是函數(shù)調(diào)用失敗了于是花了一個(gè)小時(shí)查創(chuàng)建接口參數(shù)一無所獲。后來冷靜下來按數(shù)據(jù)鏈路從頭排查才找到真相。我把那次排查的完整思路寫出來以后你們遇到類似問題可以照這個(gè)順序走。排查第一步確認(rèn)球標(biāo)是不是被隱藏了。球標(biāo)和圖元一樣有顯示和拭除的狀態(tài)。有些繪圖模板默認(rèn)把球標(biāo)層BALL層隱藏了這時(shí)候球標(biāo)數(shù)據(jù)是存在的只是看不見。判斷方法很簡單手動(dòng)在視圖上右鍵看球標(biāo)是否在顯示狀態(tài)或者程序里查視圖下球標(biāo)的顯示狀態(tài)。我當(dāng)時(shí)這一關(guān)過了因?yàn)槟０迨枪窘y(tǒng)一的之前手動(dòng)放球標(biāo)是正常顯示的。排查第二步檢查重復(fù)區(qū)域表是否更新。這是最要命的一步。Creo里球標(biāo)序號(hào)從重復(fù)區(qū)域取但重復(fù)區(qū)域表如果沒做更新表里可能只有空的骨架球標(biāo)自然填不上序號(hào)。批量處理時(shí)我先刪了舊的球標(biāo)又重建了重復(fù)區(qū)域然后創(chuàng)建新球標(biāo)——問題就出在這我的代碼里只調(diào)用了更新重復(fù)區(qū)域但沒檢查它是否真的更新成功。有些圖中的BOM表因?yàn)閰?shù)缺失比如某個(gè)零件沒有材料參數(shù)更新過程被中斷后面的球標(biāo)創(chuàng)建就成了無源之水。排查到這里我用一個(gè)笨辦法驗(yàn)證手動(dòng)打開出問題的圖重新更新BOM表如果球標(biāo)還是不顯示再往下走。排查第三步查看球標(biāo)放置坐標(biāo)是否超出邊界。球標(biāo)是放在繪圖坐標(biāo)系里的。如果程序計(jì)算出的放置點(diǎn)落在圖框之外或者離視圖太遠(yuǎn)Creo有可能直接放棄創(chuàng)建該球標(biāo)而且不報(bào)錯(cuò)。我那次批量失敗有一部分圖就是這個(gè)原因不同圖框的幅面不一樣而我寫死了一個(gè)偏移量。A3圖上剛好A4圖上就超出去了。這個(gè)問題最隱蔽因?yàn)樗鼤r(shí)好時(shí)壞特別容易讓人誤判成隨機(jī)bug。解決辦法是動(dòng)態(tài)讀取當(dāng)前圖頁的幅面大小再計(jì)算安全的放置區(qū)域絕不能用固定偏移。排查第四步檢查簡化表示。有些裝配視圖用了簡化表示視圖里壓根沒有某些零件。如果你對(duì)一個(gè)不存在的零件創(chuàng)建球標(biāo)接口不報(bào)錯(cuò)但球標(biāo)就是不會(huì)出現(xiàn)。這也是批量場景的高發(fā)問題。處理方式很簡單創(chuàng)建前先判斷零件是否在當(dāng)前視圖的顯示范圍里用一個(gè)零件是否可見的判斷過濾掉不可見對(duì)象。排查第五步檢查創(chuàng)建順序。球標(biāo)必須在重復(fù)區(qū)域更新之后創(chuàng)建不能之前。如果先創(chuàng)建球標(biāo)、后更新重復(fù)區(qū)域球標(biāo)雖然建立起來了但序號(hào)文本還是空的你再去重新關(guān)聯(lián)會(huì)發(fā)現(xiàn)球標(biāo)和表行的綁定已經(jīng)錯(cuò)亂只能刪了重建。這是我最開始代碼里的順序失誤改掉之后成功率立刻上了好幾個(gè)臺(tái)階。把這五個(gè)環(huán)節(jié)走完那次批量失敗的真實(shí)原因基本定位了一半的圖是坐標(biāo)偏移越界剩下的是簡化表示未過濾。修復(fù)后重新跑成圖率從82%提到98%。剩下2%是圖紙本身模型就有問題屬于人工介入范疇不能怪程序。6. 把球標(biāo)能力封裝成可復(fù)用的組件球標(biāo)函數(shù)寫一次容易寫得好用的關(guān)鍵是封裝。我最終沉淀下來的封裝思路是這樣的對(duì)外暴露兩個(gè)最基本的操作——?jiǎng)?chuàng)建球標(biāo)和刷新球標(biāo)。創(chuàng)建球標(biāo)是從無到有傳入視圖、傳入需要標(biāo)注的零件列表、傳入放置規(guī)則程序自動(dòng)生成球標(biāo)。刷新球標(biāo)是從舊到新模型變更后球標(biāo)序號(hào)、位置、連接參照可能失效程序重新遍歷所有球標(biāo)把序號(hào)按當(dāng)前BOM順序重排把引線連接點(diǎn)重新吸附到最新幾何上。這兩個(gè)操作為什么要分開因?yàn)閷?shí)際出圖流程是不斷迭代的模型改了BOM變了圖紙要重新出。如果每次都把球標(biāo)全部刪掉重建一是慢二是會(huì)把工程師手工微調(diào)過的好位置全部丟掉。刷新只更新序號(hào)和連接參照保留位置和引線走向這才是工程上最舒服的使用方式。封裝的輸入?yún)?shù)我建議設(shè)計(jì)成結(jié)構(gòu)體而不是一長串零散參數(shù)typedef struct { int balloon_type; // 球標(biāo)類型 double text_height; // 字高 int attach_type; // 0邊 1面 2軸 3點(diǎn) double margin_x; // 視圖外水平偏移 double margin_y; // 視圖外垂直偏移 int skip_invisible; // 是否跳過不可見零件 } BalloonToolConfig;用結(jié)構(gòu)體的好處是以后企業(yè)標(biāo)準(zhǔn)變了——比如從圓形改旗形——只需要改一處配置所有圖紙重新跑一遍刷新即可不用動(dòng)業(yè)務(wù)代碼。性能方面也說一個(gè)經(jīng)驗(yàn)。批量創(chuàng)建幾百個(gè)球標(biāo)時(shí)千萬別每創(chuàng)建一個(gè)球標(biāo)就調(diào)用一次界面刷新那會(huì)卡到你懷疑人生。正確做法是批量創(chuàng)建期間關(guān)閉視圖自動(dòng)更新全部創(chuàng)建完成后統(tǒng)一刷新一次。我當(dāng)時(shí)優(yōu)化這一步把整套圖紙的處理時(shí)間從三分鐘壓到了二十秒以內(nèi)。這一點(diǎn)對(duì)大批量工程圖自動(dòng)化是實(shí)打?qū)嵉男阅芗t利。最后分享一個(gè)小技巧球標(biāo)調(diào)試階段把創(chuàng)建接口的返回值完整打印到日志里不要只打成功失敗。返回碼只是第一步我一般會(huì)連放置點(diǎn)坐標(biāo)、連接參照標(biāo)識(shí)、視圖名稱一起打出來。跑完一批圖紙?jiān)俳y(tǒng)一拉日志看哪些球標(biāo)被丟棄、被跳過一目了然。配合上面的排查思路能少熬不少夜。工具是越用越趁手的但前提是你把球標(biāo)這條數(shù)據(jù)鏈路徹底想明白。上面這些坑我基本都是在實(shí)際項(xiàng)目里一個(gè)一個(gè)填過來的。如果你也在寫類似的球標(biāo)自動(dòng)化工具希望這篇東西能讓你少填幾個(gè)。