Bonsai Drawing and Documentation — Implementation Guide

Version: Bonsai v0.8.x | Blender 4.2+ | Python 3.11 Module path: bonsai.bim.module.drawing — NEVER blenderbim.bim.module.drawing Dependencies: bonsai-core-architecture (Bonsai tool/core/operator pattern)

1. Critical Warnings

• ALWAYS use bonsai.bim.module.drawing — NEVER use blenderbim.bim.module.drawing (legacy name)
• ALWAYS activate a drawing camera before calling bim.create_drawing
• NEVER edit generated SVG files directly — ALWAYS modify annotations in Blender and regenerate
• ALWAYS install InkScape before using sheet composition or PDF export
• Annotations are ONLY generated for orthographic camera views — NEVER for perspective views
• ALWAYS sync IFC data before generating drawings (sync=True or save first)
• ALWAYS use project-relative paths for titleblock SVG templates

2. Architecture Overview

The drawing module follows Bonsai's core/tool/operator pattern: