【SolidWorks API】面IDの呪縛から解放される：トポロジー解析による「壊れない」堅牢合致エンジンの設計論
SolidWorks APIを扱うエンジニアにとって、最大の敵は「設計変更」だ。面やエッジに割り振られた内部ID（Entity ID）は、フィーチャーの再構築（Rebuild）やモデルの微細な変更によって容易に変動する。
「昨日まで動いていた自動化コードが、設計変更一つで全滅する」
多くのエンジニアがこの悪夢に直面するが、それはAPIの表面的なメソッドしか見ていないからだ。本稿では、IMateEntity2とトポロジー解析を組み合わせ、「モデルの形状的特徴」を追跡することで、設計変更に完全耐性を持つ合致自動生成エンジンの極意を解説する。
—
1. なぜ「ID指定」は死ぬのか？
`SelectByID2`による面指定は、いわば「座標系へのハードコーディング」だ。フィーチャーの順序が変われば、IDは再割り当てされる。堅牢なエンジンを構築するには、プログラム側で「その面が何であるか」を幾何学的に特定するルーチンを挟む必要がある。
核心：トポロジーによる面特定
特定の面を選択する際、以下のパラメータを照合するメタロジックを実装せよ。
- 面の法線ベクトル: `IMathVector`による方向の特定。
- 面の境界（Loop）: `IGetEdges`によるエッジ数と曲率の解析。
- 重心（Centroid）: 座標の近傍値による特定。
—
2. 堅牢合致エンジンの実装アーキテクチャ
以下のコードは、特定の形状特徴（例：円筒面）をトポロジー解析で特定し、`IMate2`を生成するプロトタイプだ。`IMateEntity2`を介することで、IDではなく「面オブジェクトそのもの」を拘束対象として保持する。
‘ 堅牢な面特定と合致生成の断片
Public Function CreateRobustMate(swAssy As SldWorks.AssemblyDoc, targetFace As SldWorks.Face2) As SldWorks.Mate2
Dim swMateFeat As SldWorks.Feature
Dim swMateEntity As SldWorks.MateEntity2
Dim swModel As SldWorks.ModelDoc2
Set swModel = swAssy
‘ メモリ最適化: 不要なオブジェクトの参照は最小限にする
‘ IMateEntity2を生成し、トポロジー情報を持たせる
Set swMateEntity = swModel.IModelDocExtension.CreateMateEntity(targetFace)
‘ 合致定義の生成
‘ ここでは同心円合致(swMateCONCENTRIC)を例とする
Dim swMateData As SldWorks.ConcentricMateFeatureData
Set swMateData = swAssy.CreateMateData(swMateCONCENTRIC)
swMateData.EntitiesToMate(0) = swMateEntity
‘ … (他のエンティティ設定)
‘ 合致のコミット
Set swMateFeat = swAssy.AddMate(swMateData)
‘ 明示的解放
Set swMateEntity = Nothing
Set swMateData = Nothing
End Function
—
3. シニアエンジニアが守るべき3つの鉄則
① IModelDocExtensionの徹底活用
`SelectByID2`はレガシーな手法であり、UIとの同期が必要なため低速だ。一方、`IModelDocExtension`系のメソッドは、メモリ内でのトポロジー操作に長けており、バックグラウンド処理において圧倒的な安定性を発揮する。
② COMオブジェクトの「明示的解放」
VBAはガベージコレクションが脆弱だ。`Set obj = Nothing` を怠れば、特にアセンブリのループ処理においてメモリリークが蓄積し、SolidWorks自体がクラッシュする。
- 定石: ループ内では常にオブジェクトをキャッシュせず、必要な処理が終わるごとに解放し、ポインタをクリーンに保て。
③ Windows APIによるプロセス生存監視
大規模アセンブリを扱う際、SolidWorksが「応答なし」になることは珍しくない。`User32.dll` の `GetForegroundWindow` や `IsHungAppWindow` を叩き、スレッドがハングアップしていないか監視するラッパーを実装するのは、プロとしての最低限の防衛策だ。
—
4. 結論：アルゴリズムが設計を追い越す時
堅牢な自動化とは、単にコードを書くことではない。「設計者がモデルをどう変更するか」を数学的にモデル化することだ。
面IDに依存せず、法線や曲率、隣接するエッジ構成を走査するこのアプローチを導入すれば、たとえ設計者がフィーチャーを再構成しても、コードは「正しい面」を見つけ出し、合致を再構築する。
これが、我々アーキテクトが目指すべき「真の自動化」の姿である。
次に構築するシステムでは、ぜひ `ISurface` オブジェクトの詳細な解析を組み込んでみてほしい。そこには、IDという名の束縛から解放された、自由な自動化の世界が広がっているはずだ。
