プロキシオブジェクトという「時限爆弾」を解体せよ:互換性を極める堅牢な図面浄化アーキテクチャ
現場のエンジニア諸君、今日も「昨日まで動いていたマクロが、他社から届いた図面を開いた瞬間にクラッシュした」という報告に頭を抱えているのではないか?
AutoCADの世界において、最も厄介な存在の一つが「プロキシオブジェクト(Proxy Objects)」だ。Civil 3D、AutoCAD Mechanical、あるいはサードパーティ製の特殊な設計ソフト。これらが生成したオブジェクトは、標準のAutoCAD環境においては「中身の分からない不透明な塊」に過ぎない。
これらを放置したまま保存・共有を行うことは、プロジェクトの進行を阻害する「時限爆弾」をチーム内にバラ撒く行為と同義である。
本記事では、単なる「分解(Explode)マクロ」ではない。オブジェクトのライフサイクルを制御し、メモリとデータベースの整合性を保ちながら、図面を「クリーンな標準状態」へと導くための、プロフェッショナルな設計思想を伝授する。
1. なぜ、一般的な「ループ+分解」コードは破綻するのか
多くの開発者が最初に書くコードは、おそらく以下のようなものだ。
' --- 典型的な「素人」のコード(絶対に使うな) ---
Dim obj As AcadObject
For Each obj In ThisDrawing.ModelSpace
If obj.IsProxy Then ' 仮にIsProxyというプロパティがあると想定
obj.Explode
End If
Next obj
このコードは、実務では「死」を意味する。 なぜか?理由は大きく分けて2つある。
A. コレクションの動的変更による崩壊
`For Each` 文でコレクション(ModelSpaceなど)を走査している最中に、`Explode` メソッドを呼び出すとどうなるか? `Explode` は新しい図形をデータベースに生成する。つまり、「走査中のコレクションの要素数が、実行中に変化する」のだ。
これは、イテレータが次なる要素を見失い、予期せぬエラー(Run-time error ‘450’ 等)を引き起こすか、最悪の場合、AutoCAD自体を強制終了させる原因となる。
B. オブジェクトのライフサイクル管理の欠如
プロキシオブジェクトを分解した際、生成される「分解後のオブジェクト」は、元のオブジェクトの属性を引き継いでいる場合がある。分解に失敗した、あるいは分解後にそのオブジェクトをどう扱うかの制御がないコードは、メモリリークや図面データの不整合(ゾンビオブジェクトの残留)を招く。
2. 堅牢な設計思想:2フェーズ・アプローチ
プロフェッショナルが採用すべき設計は、「検出(Scouting)」と「実行(Execution)」を完全に分離した2フェーズ・アプローチである。
1. Phase 1: 検出フェーズ
図面全体を走査し、分解が必要なプロキシオブジェクトの「参照(Handleまたはオブジェクト自体)」を、一時的なリスト(Collectionオブジェクト)に格納する。この時点では、図面データには一切の変更を加えない。
2. Phase 2: 実行フェーズ
構築した「リスト」に対してのみループを回し、一つずつ分解処理を行う。これにより、走査中のコレクション変更の影響を完全に回避できる。
3. プロダクション・グレードのコード実装
以下に、実務でそのまま使用できるレベルまで昇華させた、堅牢な実装例を示す。
Option Explicit
''' <summary>
''' 図面内のプロキシオブジェクトを検出し、可能な限り標準図形へ分解する
''' </summary>
Public Sub PurgeProxyObjects()
Dim targetCollection As Collection
Set targetCollection = New Collection
Dim obj As AcadObject
Dim block As AcadBlock
Dim i As Long
Dim errCount As Long: errCount = 0
Dim successCount As Long: successCount = 0
On Error GoTo ErrorHandler
Debug.Print "--- プロキシ検出フェーズ開始 ---"
' --- Phase 1: 検出フェーズ (ModelSpace & PaperSpace) ---
' モデル空間とレイアウト空間の両方を走査
' ※ここでは簡略化のため、主要な空間のみを対象とする
Call CollectProxies(ThisDrawing.ModelSpace, targetCollection)
For Each block In ThisDrawing.Layouts
Call CollectProxies(block.Block, targetCollection)
Next block
' --- Phase 2: 実行フェーズ ---
Debug.Print "--- 分解実行フェーズ開始: 対象数 " & targetCollection.Count & " ---"
' Collection内のオブジェクトに対して処理を行う
' ※重要: targetCollection自体は分解によって変化しないため、安全にループ可能
For i = 1 To targetCollection.Count
Set obj = targetCollection(i)
On Error Resume Next ' 個別のオブジェクトのエラーが全体を止めないように制御
' 分解試行
Dim explodedObjects As Variant
explodedObjects = obj.Explode
If Err.Number = 0 Then
' 分解成功時、元のプロキシオブジェクトを削除
obj.Delete
successCount = successCount + 1
Else
' 分解失敗(分解不能なプロキシや、ロックされたレイヤー上のオブジェクトなど)
errCount = errCount + 1
Debug.Print "Warning: 分解失敗 [Handle: " & obj.Handle & "] - " & Err.Description
End If
On Error GoTo ErrorHandler ' エラーハンドリングを元に戻す
Next i
MsgBox "処理完了" & vbCrLf & _
"成功: " & successCount & " 件" & vbCrLf & _
"失敗: " & errCount & " 件", vbInformation, "互換性向上処理"
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical, "システムエラー"
End Sub
''' <summary>
''' 指定された空間内のプロキシオブジェクトをスキャンし、コレクションに格納する
''' </summary>
Private Sub CollectProxies(ByRef space As AcadBlock, ByRef col As Collection)
Dim obj As AcadObject
For Each obj In space
' プロキシオブジェクトの判定ロジック
' AutoCAD VBAにおいて、プロキシ判定は ApplicationName が空でない、
' あるいは特定のプロパティを持つかで判断する
If IsProxyObject(obj) Then
col.Add obj
End If
Next obj
End Sub
''' <summary>
''' オブジェクトがプロキシであるかを判定する
''' </summary>
Private Function IsProxyObject(ByRef obj As AcadObject) As Boolean
On Error Resume Next
' プロキシオブジェクトは、ApplicationName プロパティに
' 自身の作成元アプリケーション名を持っている
Dim appName As String
appName = obj.ApplicationName
' ApplicationName が空でない、かつ AutoCAD 自体の名前でない場合をプロキシとみなす
' (注: 環境によって判定基準は調整が必要)
If appName <> "" And appName <> "AutoCAD" Then
IsProxyObject = True
Else
IsProxyObject = False
End If
On Error GoTo 0
End Function
4. アーキテクトからのアドバイス:運用の極意
このコードを実務に投入する際、以下の3点を忘れてはならない。
① 「分解」は破壊的変更である
`Explode` は、オブジェクトの属性(色、レイヤー、線種)を完全に維持できるとは限らない。分解後のオブジェクトが、元の意図した設計情報を保持しているか、常に検証が必要だ。このマクロは「互換性を優先し、情報の完全性をある程度犠牲にする」というトレードオフの上に成り立っていることを理解せよ。
② レイヤーのロックに注意せよ
プロキシオブジェクトが「ロックされたレイヤー」上にある場合、`Explode` は失敗する。本番環境では、処理前にレイヤーのロック状態を確認するか、一時的にロックを解除するロジックを組み込むのが、真に「堅牢な」設計だ。
③ ログこそが最大の防御である
上記のコードでは `Debug.Print` を使用しているが、大規模な自動化ツールにおいては、これらをテキストファイルやデータベースへ出力するように拡張せよ。「どの図面の、どのハンドルが、なぜ分解できなかったのか」という履歴がなければ、問題が発生した際に原因究明ができず、エンジニアの工数を無駄に浪費することになる。
結論
プロキシオブジェクトの制御は、AutoCAD VBA開発における「中級者から上級者への登竜門」だ。
オブジェクトを単なるデータの塊として見るのではなく、「データベースの一部であり、ライフサイクルを持つ動的な存在」として捉えること。この視点の転換こそが、バグのない、プロフェッショナルな自動化ツールを生む唯一の道である。
