【テクニカル・上級編】【初心者向け】「Documents.Open」で大量の図面を順次処理する際の、メモリ消費を抑えるための基本的な「Close」タイミング – AutoCAD VBA解析バイブル

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

「Documents.Open」の罠:大量図面処理におけるメモリリークを断つ、真のリソース解放戦略

大量のDWGファイルを順次処理するバッチシステムを構築する際、多くのエンジニアが直面する「壁」がある。
「最初は順調に動いていた処理が、数百枚を過ぎたあたりでAutoCADが応答なし(Not Responding)になる」「メモリ使用量が右肩上がりに増え続け、最終的にOut of Memoryでクラッシュする」――。

これは単なるプログラムのバグではない。オブジェクトのライフサイクルと、COM(Component Object Model)の参照カウントに対する理解不足が生む、必然的な破綻である。

本稿では、初心者向けの「Close」という概念を、シニアエンジニアが実践すべき「リソースの完全な破棄」へと昇華させるための、極限の知見を伝授する。

1. なぜ `Document.Close` だけでは足りないのか

初心者はこう考える。「`doc.Close` を呼び出せば、図面は閉じられ、メモリも解放されるはずだ」と。
残念ながら、それは致命的な誤解だ。

AutoCAD VBAにおいて、`Documents.Open` で取得した `Document` オブジェクトは、単なるファイルへのポインタではない。それはAutoCAD本体(`acad.exe`)のメモリ空間に居座る、極めて重厚なCOMオブジェクトである。

メモリが解放されないメカニズム

1. 参照カウントの残留: VBA側で `Dim doc As AcadDocument` と宣言し、オブジェクトを代入した瞬間、そのオブジェクトの参照カウントが上昇する。
2. Closeの限界: `doc.Close` メソッドは「図面を閉じる」というアクションを実行するが、「VBA変数としてのオブジェクト」をメモリから消去するわけではない。
3. COMのゴミ溜め: `Close` を呼んでも、VBAの変数 `doc` がそのオブジェクトを指し続けている限り、参照カウントはゼロにならず、AutoCADのメモリ空間には「実体のない、しかし参照は生きているオブジェクト」が蓄積され続ける。これがメモリリークの正体だ。

2. リソース解放の三位一体:完全なるクリーンアップ・サイクル

大量処理を完遂するためには、以下の3つのステップを一つのサイクルとして、ループ内で厳格に実行しなければならない。

① 明示的なオブジェクトの破棄 (`Set = Nothing`)

VBAにおいて、オブジェクトの参照を断ち切る唯一の方法は、変数に `Nothing` を代入することである。これにより、COMの参照カウントが減少し、条件を満たした時に初めてメモリが解放される。

② スケジューラーへの制御権譲渡 (`DoEvents`)

ループ処理が高速すぎると、Windowsのメッセージキュー(描画更新やOSからの信号処理)が追いつかず、AutoCADがフリーズしたように見える。`DoEvents` を挟むことで、OSに制御を一時的に戻し、メモリ管理プロセスやGUIの更新を促す。

③ 物理的なリソースの限界を見極める(アーキテクチャの選択)

もし数千枚規模の処理を行うのであれば、一つの `acad.exe` プロセス内で完結させること自体が設計ミスである。プロセスがクラッシュすれば、それまでの全工程が失われるからだ。

3. 実装コード:堅牢なバッチ処理パターン

以下に、メモリ消費を最小限に抑え、安定稼働を目的とした実装例を示す。これは、単なるコードではない。リソース管理の規律を具現化したものである。

' =================================================================
' 堅牢な図面バッチ処理モジュール
' 目的: 大量図面処理におけるメモリリークの徹底防止
' =================================================================

Option Explicit

Public Sub BatchProcessDrawings(ByVal fileList As Collection)
    Dim acadApp As AcadApplication
    Dim doc As AcadDocument
    Dim filePath As Variant
    
    On Error GoTo ErrorHandler

    ' AutoCADアプリケーションへの参照取得
    Set acadApp = ThisDrawing.Application

    ' ファイルリストのループ処理
    For Each filePath In fileList
        Debug.Print "Processing: " & filePath
        
        ' --- 1. 図面のオープン ---
        Set doc = acadApp.Documents.Open(filePath)
        
        ' --- 2. 図面処理ロジック (ここに実処理を記述) ---
        Call ExecuteHeavyLogic(doc)
        
        ' --- 3. 保存とクローズ ---
        ' 変更がある場合のみ保存。エラー回避のためOn Error Resume Nextを併用
        On Error Resume Next
        doc.Save
        doc.Close
        On Error GoTo ErrorHandler
        
        ' --- 4. 【極めて重要】リソースの明示的解放 ---
        ' オブジェクトへの参照を完全に断ち切る
        Set doc = Nothing
        
        ' OSのメッセージキューを処理させ、メモリ管理プロセスに隙を与える
        DoEvents
        
        ' ループの各ステップで、メモリ使用量を確認することを推奨する
    Next filePath

    MsgBox "全ての処理が正常に完了しました。", vbInformation
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
           "Error No: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical
    
    ' エラー時も、可能な限りオブジェクトを解放してプロセスを保護する
    If Not doc Is Nothing Then
        Set doc = Nothing
    End If
End Sub

Private Sub ExecuteHeavyLogic(ByRef doc As AcadDocument)
    ' ここに図面操作のロジックを記述
    ' 例: 全レイヤーのチェック、属性抽出など
    ' 注意: この内部でも、生成したオブジェクト(AcadEntity等)は
    ' 必ず Set = Nothing で解放すること
End Sub

4. 伝説のアーキテクトが教える「究極の回避策」

もし、上記の対策を講じてもメモリ不足が解消されない場合、それはAutoCAD本体(`acad.exe`)が持つ、累積的なメモリ断片化(Fragmentation)の問題である。

シニアエンジニアとして、君が検討すべき次の一手は「プロセス分離型アーキテクチャ」への移行だ。

プロセス分離(Process Isolation)の戦略

VBA内部のループで処理するのではなく、外部のスクリプト(VBScriptやPowerShell、あるいはVB.NETで作成したコンソールアプリケーション)からAutoCADを制御する。

1. Controller(外部プログラム)が図面リストを読み込む。
2. Worker(AutoCAD)を起動する。
3. 図面を N枚(例: 50枚) 処理する。
4. Worker(AutoCADのプロセス自体)を強制終了させる。
5. 再度、新しい Worker(AutoCAD) を立ち上げる。

この「プロセスを定期的に殺して、新しく作り直す」という手法は、一見非効率に見える。しかし、数千枚の図面を「止まらずに、最後まで」処理するという観点においては、これこそが最も信頼性の高い、プロフェッショナルの選択である。

結論

`Documents.Open` は、魔法の杖ではない。それは、システムのメモリという限られた資源を消費する、重い契約である。

  • `Close` は契約の終了ではなく、手続きの開始に過ぎない。
  • `Set = Nothing` は、メモリに対する責任の証明である。
  • `DoEvents` は、システムとの対話である。

これらを遵守し、必要であればプロセスレベルでの制御を設計に組み込め。それが、レガシーな環境においても堅牢なシステムを構築できる、真のエンジニアの姿である。

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