縮尺の罠を回避せよ：実務レベルの「スケールガイド自動配置」を実現するアーキテクチャ設計
現場の自動化エンジニア諸君、よく集まってくれた。
図面の自動化ツールを作ろうとして、初心者が必ず陥る罠がある。「線を引く」という単純な作業を、単なる「描画命令の羅列」として捉えてしまうことだ。
例えば、1/50の縮尺でガイド線を引くツールを作るとしよう。適当なエンジニアは、`ActiveLayer.CreateGuideline` をループで回し、数値をハードコーディングして書き上げる。しかし、そのコードは「ドキュメントの単位設定がミリメートルではない場合」や「既にガイドが存在する場合」、「ページサイズが急に変更された場合」に、無残にもクラッシュするか、あるいは実務では使い物にならないデタラメな位置に線を引くことになる。
プロフェッショナルが書くべきは、「ドキュメントの状態に依存せず、常に数学的整合性を保ち、かつ後続の作業を汚染しない」堅牢なコードだ。
本稿では、CorelDRAW VBAを用いて、図面の縮尺に基づいた正確なスケールガイドを自動配置する、プロダクションレベルの設計思想と実装を伝授する。
1. 設計の三原則：なぜその書き方では「使い物にならない」のか
実務用ツールを設計する際、私は常に以下の3つの原則を要求する。これらが欠けているコードは、どれほど動いても「ゴミ」に等しい。
① 単位系の正規化 (Unit Normalization)
CorelDRAWの内部座標は、ドキュメントの設定（インチ、ピクセル、ミリメートル等）に依存する。ユーザーがドキュメントの単位を勝手に変更した瞬間に、あなたの計算式は崩壊する。
解決策: 全ての計算は「ミリメートル」という絶対的な基準で行い、描画の直前でドキュメントの現在の単位系へ変換する。
② 冪等性 (Idempotency) の確保
「ツールを2回実行したら、ガイド線が2重、3重に重なってしまった」――これは自動化ツールにおける致命的な設計ミスだ。
解決策: 実行時に「専用のレイヤー」を確認し、既存のガイドがある場合は一度クリーンアップ（削除）してから再生成する。これにより、何度実行しても「常に同じ正しい状態」が保証される。
③ 関心の分離 (Separation of Concerns)
「計算ロジック」と「描画ロジック」を混ぜるな。
解決策: 縮尺から実寸のインターバルを算出するロジックと、実際にCorelDRAWのオブジェクトを操作するロジックを分離せよ。これにより、将来的に「ガイド線ではなく、目盛り付きのテキストも配置したい」となった際の改修コストが劇的に下がる。
2. 実装：プロダクション・グレードのコード例
以下に、これら全ての原則を組み込んだ、そのまま業務に投入可能なコードを示す。単なるコピペで終わらせるな。なぜこの構造になっているのか、一行ずつ読み解け。
Option Explicit
' ==============================================================================
' Module: ScaleAutomation
' Description: 図面の縮尺に基づき、正確なスケールガイドを自動配置する
' Author: Chief Architect
' ==============================================================================
''' <summary>
''' メインエントリポイント。ユーザーインターフェース（ダイアログ等）から呼ばれる想定。
''' </summary>
Public Sub ExecuteScaleGuidePlacement()
On Error GoTo ErrorHandler
' --- 設定値 (本来はUIや外部DBから取得すべき値) ---
Dim targetScale As Double: targetScale = 50 ' 1/50の場合
Dim intervalMm As Double: intervalMm = 10 ' 10mm間隔でガイドを引く
' -----------------------------------------------
Dim doc As Document
Set doc = ActiveDocument
If doc Is Nothing Then
MsgBox "ドキュメントが開かれていません。", vbCritical
Exit Sub
End If
' 高速化のための最適化開始
Optimization = True
EventsEnabled = False
ActiveDocument.BeginCommandGroup "Apply Scale Guides"
' 1. レイヤーの準備 (冪等性の確保)
Dim guideLayer As Layer
Set guideLayer = GetOrCreateScaleLayer(doc)
' 2. 既存ガイドのクリア (汚染防止)
ClearExistingGuides guideLayer
' 3. ガイドの生成
CreateScaleGuides guideLayer, targetScale, intervalMm
' 処理終了処理
ActiveDocument.EndCommandGroup
Optimization = False
EventsEnabled = True
Application.Refresh
MsgBox "スケールガイドの配置が完了しました。", vbInformation
Exit Sub
ErrorHandler:
Optimization = False
EventsEnabled = True
MsgBox "エラーが発生しました: " & Err.Description, vbCritical
End Sub
''' <summary>
''' 専用レイヤーの取得または作成を行う。
''' </summary>
Private Function GetOrCreateScaleLayer(doc As Document) As Layer
Const LAYER_NAME As String = "SCALE_GUIDES_LAYER"
Dim ly As Layer
On Error Resume Next
Set ly = doc.Layers(LAYER_NAME)
On Error GoTo 0
If ly Is Nothing Then
Set ly = doc.AddLayer(LAYER_NAME)
ly.Visible = True
End If
Set GetOrCreateScaleLayer = ly
End Function
''' <summary>
''' 指定されたレイヤー内の既存ガイドを削除する。
''' </summary>
Private Sub ClearExistingGuides(ly As Layer)
' レイヤー内の全てのオブジェクトを削除（ガイド含む）
' 注意: 運用ルールにより、ガイド以外を消してはいけない場合は
' オブジェクトの型判定を行うロジックに昇格させること
Dim s As Shape
For Each s In ly.Shapes
s.Delete
Next s
End Sub
''' <summary>
''' 数学的計算に基づきガイド線を配置する。
''' </summary>
Private Sub CreateScaleGuides(ly As Layer, scaleFactor As Double, intervalMm As Double)
Dim doc As Document: Set doc = ly.Document
Dim pg As Page: Set pg = doc.ActivePage
' 計算の基準となる単位を一時的にミリメートルに固定
Dim originalUnit As cdrUnit
originalUnit = doc.Unit
doc.Unit = cdrMillimeter
' 実寸におけるインターバル間隔を計算
' 例: 1/50スケールで10mm間隔なら、図面上では 10 / 50 = 0.2mm 間隔
Dim drawingInterval As Double
drawingInterval = intervalMm / scaleFactor
' 描画範囲の取得（ページの端から端まで）
Dim xStart As Double: xStart = pg.SizeWidth * 0 ' 簡易化のため0から開始
Dim xEnd As Double: xEnd = pg.SizeWidth
Dim yStart As Double: yStart = pg.SizeHeight
Dim yEnd As Double: yEnd = 0
' 垂直ガイドの生成
Dim currentX As Double
currentX = 0
Do While currentX <= xEnd
' ページ境界内に収まっているかチェック
If currentX >= 0 Then
ly.CreateGuideline cdrVertical, currentX
End If
currentX = currentX + drawingInterval
Loop
' 水平ガイドの生成
Dim currentY As Double
currentY = 0
Do While currentY <= yStart
If currentY >= 0 Then
ly.CreateGuideline cdrHorizontal, currentY
End If
currentY = currentY + drawingInterval
Loop
' 単位を元に戻す (重要: ユーザーの環境を壊さない)
doc.Unit = originalUnit
End Sub3. プロダクション運用のための高度なアドバイス
このコードをベースに、さらに「製品レベル」へと昇華させるための思考プロセスを授ける。
ファイル・データベース連携の注意点
もし、この縮尺情報をExcelや外部のデータベース（SQL等）から取得する場合、「データの型」に細心の注意を払え。
CSVから読み込んだ数値は文字列として扱われることが多く、`1/50` という文字列をそのまま `Double` に変換しようとすればエラーで即死する。必ず `Split(“/”)` 等を用いて、分母を数値として抽出するパース処理を挟め。
パフォーマンスの重み
大量のガイド線を引く場合、`Optimization = True`（画面更新の停止）は必須だが、それだけでは足りない。
CorelDRAWのオブジェクトモデルは、一つ一つの `CreateGuideline` 呼び出しに対して、内部的な再計算を行っている。数千本の線を引くような極端なケースでは、一度 `ShapeRange` にまとめてから一括操作する手法を検討すべきだが、ガイド線に関しては `CreateGuideline` メソッドが最適化されているため、上記の実装で十分だ。
メンテナンス性の極意
コード内に `Const LAYER_NAME As String = “SCALE_GUIDES_LAYER”` と定数を定義した理由を理解しているか？
半年後の君自身、あるいは別のエンジニアが「レイヤー名を変えたい」と思った時、ロジックの深淵まで潜る必要なく、先頭の定数を書き換えるだけで済む。これこそが、「保守性の高いコード」の正体だ。
結論
自動化とは、単に「手作業を消すこと」ではない。「手作業が孕んでいた不確実性を、数学的・論理的な確定事項に置き換えること」だ。
今回示したコードは、そのための最小にして最強のテンプレートである。これを踏み台にして、より複雑で、より価値のある自動化ツールを構築してほしい。
健闘を祈る。
