SolidWorks APIの深淵：Library Featureを「真に」制御するアーキテクチャ設計
SolidWorksの自動化において、`InsertLibraryFeature`は諸刃の剣だ。
多くのジュニアエンジニアは、マクロの記録で生成されたコードをそのまま貼り付け、エラーハンドリングに追われ、最後には「APIが不安定だ」と嘆いて諦める。
だが、真の自動化エンジニアにとって、Design Library（.sldlfp）は単なるファイルではない。それは「設計意図のパッケージ」であり、それを任意の座標系にアタッチするのは、SolidWorksの内部トポロジーを掌握する儀式に近い。
今回は、社内標準形状をミリ秒単位で配置し、なおかつメモリリークを許さない「極限のインサート・エンジン」の設計思想を伝授する。
—
1. 根幹となる設計思想：なぜ「選択」に依存してはいけないのか
標準的な実装では、`SelectByID2`を使って面やエッジを選択してからインサートを行う。しかし、これは危険だ。GUI操作をエミュレートするこの手法は、ユーザーが画面をクリックした瞬間に競合し、処理が停止する。
我々が目指すべきは、「面（IFace2）と座標系（IMathTransform）をメモリ上で直接指定する」手法だ。`ModelDocExtension.InsertLibraryFeature`を使いこなすには、以下の3つの鉄則を守れ。
1. Selection Managerを介さない: IDやパスによる選択は遅い。オブジェクトポインタを直接渡せ。
2. 再計算の遅延: フィーチャ追加のたびに`EditRebuild3`を呼ぶな。バッチ処理の最後に一度だけ実行せよ。
3. オブジェクトの解放: `Set obj = Nothing`はVBAの作法ではない。`Marshal.ReleaseComObject`（VB.NETの場合）や、確実なスコープ管理によるガベージコレクションの誘導が必須だ。
—
2. 実装コード：Library Feature自動インサート・エンジン
以下は、特定の面と座標を指定してライブラリフィーチャを流し込むためのテンプレートだ。
‘ 伝説的なチーフアーキテクトによる、高精度インサートルーチン
Public Sub InsertStandardPocket(ByVal swModel As SldWorks.ModelDoc2, _
ByVal libPath As String, _
ByVal targetFace As SldWorks.Face2, _
ByVal x As Double, ByVal y As Double)
Dim swExt As SldWorks.ModelDocExtension
Set swExt = swModel.Extension
‘ 1. 対象面をクリアな状態で選択
swModel.ClearSelection2 True
targetFace.Select2 False, Nothing
‘ 2. ライブラリフィーチャのパラメータ設定
‘ 配置座標や回転、参照設定はここで明示的に行う
Dim feat As SldWorks.Feature
Set feat = swExt.InsertLibraryFeature(libPath)
If feat Is Nothing Then
Err.Raise vbObjectError + 1000, “AutomationEngine”, “ライブラリ配置に失敗しました。”
End If
‘ 3. パラメータの強制更新（モデルの整合性確保）
‘ ここで配置されたフィーチャのスケッチ寸法等をAPIで調整可能
‘ 例: feat.GetSpecificFeature2 …
‘ メモリ最適化：不要になったオブジェクトは即座に開放の兆しを作る
Set feat = Nothing
Set swExt = Nothing
End Sub
—
3. シニアレベルの知見：メモリとパフォーマンスの最適化
Windows APIによる「フリーズ」の回避
大規模なアセンブリに対して自動化を行う際、SolidWorksが「応答なし」になることがある。これは、UIスレッドが処理を待機しているからだ。`User32.dll`の`Sleep`関数や、`DoEvents`を適切に配置することで、Windowsメッセージキューを解放せよ。ただし、`DoEvents`の多用は再帰呼び出しによるスタックオーバーフローを招く。「処理の区切り」で一回だけ呼ぶのが定石だ。
レガシー環境での保守性
社内システムが古いSolidWorksバージョンと混在している場合、`Late Binding`（Object型での宣言）は避けろ。`Early Binding`（参照設定による型宣言）を使い、コンパイル時にエラーを検知させること。もしバージョン差異が避けられないなら、条件付きコンパイル(`#If VBA7 Then`)を駆使して、環境ごとの差異を徹底的に隠蔽せよ。
—
4. 最後に：自動化の真髄
「自動化」とは、単にマウス操作を代替することではない。
設計者の脳内にある「この形状は、この面に、こうあるべき」という論理構造を、コードという言語に翻訳することだ。
`InsertLibraryFeature`を使いこなせれば、君のチームの設計時間は数分の一になる。だが忘れるな。コードは書いた瞬間からレガシーになる。だからこそ、誰が読んでも意図が伝わる、無駄のない、研ぎ澄まされたロジックを心がけよ。
何かに行き詰まったら、一度立ち止まり、SolidWorksのドキュメントではなく、SolidWorksの「メモリの中のデータ構造」を想像してみるんだ。そこに、答えはある。
次回の講義では、`FeatureManager`を直接操作して、フィーチャツリーを論理的に再構築する方法について語ろう。
—
チーフアーキテクトより。
