【実務・中級編】【実務中級者向け】図面保存時に「プロキシオブジェクト」が含まれている場合、自動的に「分解(Explode)」を試みる互換性向上マクロ – AutoCAD VBA解析バイブル

スポンサーリンク
スポンサーリンク

プロキシオブジェクトという「時限爆弾」を解体せよ:互換性を極める堅牢な図面浄化アーキテクチャ

現場のエンジニア諸君、今日も「昨日まで動いていたマクロが、他社から届いた図面を開いた瞬間にクラッシュした」という報告に頭を抱えているのではないか?

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開発における「中級者から上級者への登竜門」だ。
オブジェクトを単なるデータの塊として見るのではなく、「データベースの一部であり、ライフサイクルを持つ動的な存在」として捉えること。この視点の転換こそが、バグのない、プロフェッショナルな自動化ツールを生む唯一の道である。

タイトルとURLをコピーしました