【極限の設計】SolidWorks VBA:断面図の切断線を数学的に支配する ― マウス操作を脱却する決定論的アプローチ
業務自動化の現場において、多くのエンジニアが「マクロ記録」という甘い罠に陥る。
「ボタンを押して、断面図を作り、マウスで線を動かす」
この一連の動作を記録したコードは、一見動いているように見える。しかし、それは「非決定論的(Non-deterministic)」なコードだ。モデルの寸法がわずかに変わった、あるいは図面シートのスケールが変更された瞬間に、そのコードは無残に崩壊する。
プロフェッショナルが構築すべきは、マウスの動きに依存する「操作の再現」ではない。幾何学的な定義に基づいた「位置の確定」である。
本記事では、断面図(Section View)の切断線(Section Line)を、座標値によって厳密に、かつ堅牢に制御するためのアーキテクチャを伝授する。
1. なぜ、あなたの断面図自動化は失敗するのか
多くの開発者が直面する問題は、「座標系の混乱」である。
SolidWorksの図面空間には、複数の座標系が混在している。
1. Sheet Coordinate System: 図面シート上の絶対座標。
2. View Coordinate System: 各ビュー(投影図)が持つローカル座標。
3. Model Coordinate System: 参照している3Dモデル自体の座標。
断面図の切断線を「図面のここらへん」という感覚で制御しようとすると、ビューのスケール変更や、配置位置の変更によって、切断線が意図しない場所へ飛んでいく。
「堅牢な設計」の鉄則は、切断線を「ビューのローカル座標系」において、モデルの特定フィーチャーの幾何学的中心や、定義されたパラメータに基づいて計算し、直接注入することである。
2. 戦略的アプローチ:Sketch-Based Control
SolidWorksのAPIにおいて、断面図の切断線は実質的に「断面を定義するためのスケッチ」によって制御されている。
単に `InsertSectionView` を呼び出すだけでは、切断線の位置はSolidWorksのアルゴリズムによる「推測」に委ねられる。
プロフェッショナルな実装では、以下のステップを踏む。
1. ベースとなるビューを特定する。
2. 断面図を生成する。
3. 生成された断面図に含まれる「切断用スケッチ」を特定し、そのスケッチ線(Line)の始点・終点座標を、計算済みの数値で上書きする。
この「スケッチへの直接介入」こそが、座標を数値入力で厳密にコントロールするための唯一の解である。
3. プロダクション・コード例
以下に、指定したビューに対して、数学的に定義された座標で断面図を生成する、保守性の高いクラスモジュール級の設計思想に基づいたコードを示す。
'**
' Module: SectionViewController
' Description: 断面図の切断位置を数学的に制御するための高度な制御モジュール
'**
Option Explicit
''' <summary>
''' 指定したビューに対して、厳密な座標に基づいた断面図を生成する
''' </summary>
''' <param name="swDraw">DrawingDocumentオブジェクト</param>
''' <param name="targetViewName">基準となるビューの名前</param>
''' <param name="startX">切断線の始点 X (ビューローカル座標)</param>
''' <param name="startY">切断線の始点 Y (ビューローカル座標)</param>
''' <param name="endX">切断線の終点 X (ビューローカル座標)</param>
''' <param name="endY">切断線の終点 Y (ビューローカル座標)</param>
''' <returns>生成されたSectionViewオブジェクト。失敗時はNothing</returns>
Public Function CreatePreciseSectionView( _
ByVal swDraw As SldWorks.DrawingDoc, _
ByVal targetViewName As String, _
ByVal startX As Double, _
ByVal startY As Double, _
ByVal endX As Double, _
ByVal endY As Double) As SldWorks.View
On Error GoTo ErrorHandler
Dim swModel As SldWorks.ModelDoc2
Set swModel = swDraw.GetActiveDoc
Dim swView As SldWorks.View
Set swView = swDraw.ViewByName(targetViewName)
If swView Is Nothing Then
Err.Raise vbObjectError + 513, "SectionViewController", "指定されたビューが見つかりません: " & targetViewName
End If
' 1. 断面図の挿入
' 第2引数以降はデフォルト値を使用し、まずは「器」を作る
' InsertSectionView(参照ビュー, 断面図の向き, ...)
Dim swSectionView As SldWorks.View
Set swSectionView = swDraw.InsertSectionView(swView)
If swSectionView Is Nothing Then
Err.Raise vbObjectError + 514, "SectionViewController", "断面図の生成に失敗しました。"
End If
' 2. 断面図内の「切断用スケッチ」へのアクセス
' 断面図が作成されると、そのビュー内に切断線を定義するスケッチが生成される
Dim swSelMgr As SldWorks.SelectionMgr
Set swSelMgr = swModel.SelectionManager
' 断面図ビューをアクティブにして、その中のスケッチを特定するプロセスが必要
' ここでは、断面図ビューの「内側」にあるスケッチエンティティを直接操作する設計とする
' 重要: 断面図の切断線は、そのビューのスケッチとして存在する
Dim swSketch As SldWorks.Sketch
Set swSketch = swSectionView.GetSketch
If swSketch Is Nothing Then
Err.Raise vbObjectError + 515, "SectionViewController", "断面図のスケッチを取得できませんでした。"
End If
' 3. スケッチ内のライン(切断線)を特定して座標を書き換える
' 通常、生成直後の断面図には1本のラインが含まれている
Dim vSketchLines As Variant
vSketchLines = swSketch.GetSketchLines
If Not IsEmpty(vSketchLines) Then
Dim swLine As SldWorks.SketchLine
Set swLine = vSketchLines(0) ' 最初のラインをターゲットとする
' 座標の注入(メートル法に基づいたDouble値)
' 注意: ここでの座標はビューの原点からの相対座標である
swLine.SetEndpoint startX, startY
swLine.SetStartPoint endX, endY
' 再描画を強制し、幾何学的整合性を確保
swModel.GraphicsRedraw2
Else
Err.Raise vbObjectError + 516, "SectionViewController", "切断線(SketchLine)が検出できません。"
End If
Set CreatePreciseSectionView = swSectionView
Exit Function
ErrorHandler:
MsgBox "Critical Error in CreatePreciseSectionView: " & Err.Description, vbCritical
Set CreatePreciseSectionView = Nothing
End Function
4. アーキテクトの視点:実装における「落とし穴」と回避策
このコードを実務に投入する際、以下の3点に留意せよ。これを行わない限り、あなたのツールは「動くが信頼できない」ものに留まる。
① 座標系の変換(Coordinate Transformation)
上記のコードで使用している `startX`, `startY` は、「ビューのローカル座標」である。
もし、あなたが「図面の左下端から◯mm」という指示(シート座標)に基づいた設計をしたいのであれば、必ずビューの変換行列(`swView.Transform`)を用いて、シート座標からビュー座標へと数学的に変換してから関数へ渡さなければならない。
② データベース連携と浮動小数点誤差
ExcelやSQLデータベースから座標値を取得する場合、数値の精度に注意せよ。
SolidWorksの内部単位はメートル(m)である。`10mm` を指定したいなら `0.01` を渡さなければならない。また、`Double` 型の比較を行う際は、`If Abs(val1 – val2) < 0.000001 Then` のように、微小な許容誤差(Epsilon)を設けるのが、堅牢なソフトウェア設計の定石である。
③ エラーハンドリングの階層化
実務ツールでは、単に `On Error Resume Next` を使うことは「技術的負債」を積み上げているのと同義だ。
本コード例のように、「何が原因で失敗したのか(ビューがないのか、スケッチがないのか)」を明確に区別してエラーを返せ。これにより、自動化プロセスが止まった際、原因究明のコストを劇的に下げることができる。
5. 結論
断面図の自動化において、マウス操作をシミュレートすることは「自動化」ではなく「自動操作」に過ぎない。
真の自動化とは、幾何学的な定義をコードによって記述することである。
切断線をスケッチエンティティとして捉え、その座標を数学的に制御する。この視点を持つことで、あなたの作成するツールは、モデルの変更や図面の複雑化に揺るがない、極めて高い堅牢性を手に入れることになる。
「動けば良い」という思考を捨て、「いかにして数学的に支配するか」を考えよ。 それが、伝説的なエンジニアへの第一歩である。
