I/O

Bring external files into the project and manage what was imported. Accessed via snaptrude.core.io.

• Import — import images, PDFs, CAD, 3D models, and site terrain into the scene
• Query — read source metadata before importing (PDF page count, CAD layers)
• Job — poll long-running asynchronous imports (e.g. DWG)
• Underlay — inspect, scale, fade, measure, and delete placed underlays
• Terrain — inspect and manage the site terrain (datum, elevation/satellite, opacity, delete)

The source argument

Every file importer takes a single source string — either an https:// URL or a data: URL (base64); other schemes are rejected at validation. A plugin worker cannot hand a browser File across the boundary, so the host fetches source and rebuilds the File itself. Sources over 100 MB throw instead of buffering.

Distinct from presentation.import

core.io.import.* ingests files into the model/scene (traceable underlays, placed geometry, terrain). presentation.import.* drops image/PDF assets onto the Present canvas (a 2D output board). Same verb, different domain.