図面データの「静かなる腐敗」を防げ:不要なスケッチ要素を幾何判定で排除する堅牢なクリーンアップ設計
実務におけるSolidWorks自動化において、最も恐ろしいのは「エラーで止まること」ではない。「エラーを出さずに、不完全なデータを生成し続けること」だ。
図面(Drawing)の自動生成ツールを開発していると、必ず直面する問題がある。モデルをビューに配置した際、意図せず混入する「コンストラクションライン(補助線)」や、モデルの変更に伴い残存してしまう「不要なスケッチ要素」だ。これらは一見、図面を汚すだけのゴミに見えるが、実は致命的なリスクを孕んでいる。
ファイルサイズの肥大化、DXF出力時のレイヤー汚染、そして何より、後続の自動寸法入れプロセスにおける幾何学的判定の誤作動。これらはすべて、図面内に潜む「幽霊のようなスケッチ要素」が原因だ。
本記事では、単なる「全削除」という力技ではない。幾何学的な属性を判定し、必要な要素を保護しながら不要な要素のみを外科手術のように排除する、プロフェッショナルなクリーンアップ・アルゴリズムの設計思想を伝授する。
1. 初学者が陥る「破壊的ループ」の罠
まず、多くの開発者が最初に書く「間違ったコード」を提示しておこう。
' 【警告】これはプロダクションコードではない。絶対に真似してはいけない。
For i = 1 To sketch.GetFeatureCount
Set feat = sketch.GetFeature(i)
If feat.IsConstruction Then
feat.Delete2 True
End If
Next i
なぜこれが「設計ミス」なのか。理由は単純だ。「コレクションの反復処理中に、そのコレクション自体を破壊しているから」である。
要素を削除すると、インデックス(添え字)が即座に詰められる。`i=1`を削除した瞬間、元々`i=2`だった要素が`i=1`に昇格する。しかしループは`i=2`へ進むため、本来処理すべき要素をスキップしてしまう。これが、クリーンアップが不完全になる最大の原因だ。
2. アーキテクトが採用すべき設計戦略
堅牢なツールを構築するためには、以下の3つのフェーズに処理を分離しなければならない。
1. Discovery(探索): ターゲットとなるビュー内の全スケッチ要素を走査し、判定条件に合致するものを「リストアップ」する。
2. Judgment(判定): その要素が「本当に消すべきゴミか」を幾何学属性(Construction属性、長さ、タイプなど)に基づき論理的に判断する。
3. Execution(実行): リストアップされた要素を、インデックスのズレを回避する方法(逆順ループ、あるいはコレクションへの格納後の個別削除)で一括削除する。
3. 実装:プロダクション・グレードのクリーンアップ・エンジン
以下に、実務に投入可能なレベルのコードを示す。ここでは、図面ビュー内のスケッチを走査し、コンストラクション属性を持つ線分や、長さが極めて短い(ノイズと思われる)要素を特定して削除するロジックを実装している。
Option Explicit
''' <summary>
''' 図面ビュー内の不要なスケッチ要素をクリーンアップする
''' </summary>
''' <param name="swView">対象となるDrawing View</param>
Public Sub CleanupDrawingView(swView As SldWorks.View)
If swView Is Nothing Then Exit Sub
Dim swModel As SldWorks.ModelDoc2
Set swModel = swView.Mbd.ModelDoc ' ビューが参照しているモデル
' 図面ドキュメントの取得
Dim swDraw As SldWorks.DrawingDoc
Set swDraw = swView.GetDocument
If swDraw Is Nothing Then
Debug.Print "Error: Target is not a Drawing Document."
Exit Sub
End If
' 削除対象を保持するためのコレクション
' インデックスのズレを防ぐため、削除前に「消すべきもの」を特定する
Dim targetEntities As New Collection
' 1. 探索フェーズ: ビュー内のスケッチを走査
Dim swSketch As SldWorks.Sketch
Set swSketch = swView.GetSketch ' ビューに紐づくスケッチを取得
If swSketch Is Nothing Then Exit Sub
Dim vEntities As Variant
vEntities = swSketch.GetSketchSegments
If Not IsEmpty(vEntities) Then
Dim i As Long
Dim swSeg As SldWorks.SketchSegment
For i = 0 To UBound(vEntities)
Set swSeg = vEntities(i)
' 2. 判定フェーズ: 幾何学的・属性的判断
If ShouldDeleteSegment(swSeg) Then
' 削除対象リストに追加
targetEntities.Add swSeg
End If
Next i
End If
' 3. 実行フェーズ: 確定した要素のみを削除
' コレクションに格納した要素に対して個別にDeleteを実行
' これにより、走査中のインデックス変動の影響を受けない
If targetEntities.Count > 0 Then
Debug.Print "Found " & targetEntities.Count & " junk elements. Starting cleanup..."
' トランザクションの開始(Undoを可能にする設計思想)
' ※SolidWorks APIには直接のTransactionStartはないが、
' 実行前にUndoを意識させるため、処理単位を明確にする
Dim ent As Variant
For Each ent In targetEntities
' セレクションを介さず直接削除を試みる(高速化)
' もし直接削除が失敗するタイプの場合は、SelectByID2を使用する設計に切り替える
Dim swSegToDelete As SldWorks.SketchSegment
Set swSegToDelete = ent
swSegToDelete.GetEntity2.Select4 False, Nothing
swModel.EditDelete
Next ent
swModel.ForceRebuild3 True
Debug.Print "Cleanup completed successfully."
Else
Debug.Print "No junk elements found."
End If
End Sub
''' <summary>
''' スケッチセグメントが「ゴミ」であるかを判定するロジック
''' </summary>
Private Function ShouldDeleteSegment(swSeg As SldWorks.SketchSegment) As Boolean
' デフォルトは削除しない
ShouldDeleteSegment = False
' A. コンストラクション属性の判定
' 補助線は図面ビューにおいて、モデルの幾何学とは独立した「ゴミ」であることが多い
If swSeg.ConstructionGeometry Then
ShouldDeleteSegment = True
Exit Function
End If
' B. 長さによる判定(極小のノイズ除去)
' 0.01mm以下の線分は、インポートエラーや意図しないクリックによるゴミの可能性が高い
Dim swLine As SldWorks.SketchLine
If swSeg.GetType = swSketchLine Then
Set swLine = swSeg
Dim length As Double
length = swLine.GetEndPoint2 - swLine.GetStartPoint2 ' 簡易的な距離計算(実際は3Dベクトル計算が必要)
' 正確には: swLine.GetStartPoint2 と GetEndPoint2 の距離
' 実際の実装では、ベクトルの差のノルムを使用すること
Dim p1 As SldWorks.MathPoint, p2 As SldWorks.MathPoint
Set p1 = swLine.GetStartPoint2
Set p2 = swLine.GetEndPoint2
Dim v1 As SldWorks.MathVector, v2 As SldWorks.MathVector
Set v1 = p1.CreateVector
Set v2 = p2.CreateVector
Dim diff As SldWorks.MathVector
Set diff = v1.Subtract(v2)
If diff.GetLength < 0.0001 Then ' 0.1ミクロン未満
ShouldDeleteSegment = True
Exit Function
End If
End If
' C. 特定のタイプ(例: スケッチ点など)の判定を追加可能
End Function
4. アーキテクトの視点:実務における運用上の注意点
このコードを現場に導入する際、リーダーとして以下の3点をチームに徹底させてください。
① 削除ロジックの「副作用」を検証せよ
`ShouldDeleteSegment` 関数は、いわば「判定の心臓部」です。ここに「長さが〇〇mm以下なら消す」というロジックを入れる場合、それが設計上の意図的な微小パーツを破壊しないかを必ず検証しなければなりません。判定条件は、常に「保守的な(消しすぎない)設定」から始めるのが鉄則です。
② コレクションへの格納と削除のコスト
上記のコードでは、一度 `Collection` オブジェクトに格納してから削除しています。これはメモリ効率と堅牢性のトレードオフです。数万個の要素を持つ巨大なスケッチに対して行う場合、`Collection` への追加コストが発生しますが、インデックス崩壊によるバグを防ぐコストに比べれば微々たるものです。「速度のために堅牢性を捨てるな」。これがエンジニアの矜持です。
③ Undo(元に戻す)への配慮
大規模な自動化ツールを動かした後、ユーザーが「あ、今の削除は間違いだった」と思っても、VBAによる操作は一度の `Undo` で戻せない場合があります。
本格的なツールにするならば、処理の開始前に現在の状態を一時保存するか、あるいは削除対象を即座に消すのではなく、「削除対象レイヤー(Junk_Layer等)に移動させるだけ」という設計にすることで、ユーザーへの安全性を担保できます。
まとめ
図面クリーンアップの自動化は、単なる「掃除」ではありません。それは、「データの信頼性を担保するための品質管理プロセス」です。
オブジェクトのライフサイクルを理解し、コレクションの挙動を制御し、幾何学的な判定ロジックを分離する。この設計思想に基づいたコードを書くことで、あなたの作成するツールは、単なるスクリプトから、企業の基幹業務を支える「プロダクト」へと昇華します。
