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