Scripting (advanced)

For repetitive or bulk work, Cizgen can run a small script over your drawing instead of taking one step at a time. These are advanced, opt-in abilities — they're off by default and you turn them on when you want them.

Two kinds of script

• Query (read-only) — runs a script that reads the drawing (overview, regions, spaces, objects, text, measurements) and returns a computed answer. It cannot change anything.
• Draw (batch) — runs a script that reads the drawing and batch-draws to the preview. Like every change, the result is staged for your approval; a script can't commit on its own.

Turning them on

Both live in the Tools selector, disabled by default. Enable the one you want for the tasks that need it. See The Tools selector.

When scripting helps

• Bulk operations across many objects at once.
• Computations over the whole drawing that would be tedious step by step.
• Repetitive patterns where a short script is clearer than many instructions.

Safety

Scripts run in a sandbox:

• No file or network access — a script can only touch the current drawing.
• Failures roll back — if a draw script errors partway through, its changes are undone, so it can't leave a half-finished mess.
• Approval still applies — a draw script's output is a preview you review and approve, exactly like any other change.