Running Python scripts
Digi3D.AI runs Python scripts in three ways: from the pane, as a command (by name from the command console), and as a quality control.
1. From the Python script pane
The dockable Python script pane (Window/Python script) lets you type or paste and immediately run scripts. Use it to test scripts and perform one-off tasks. See Python script.
import digi3d
view = digi3d.current_view()
digi3d.show_results(True)
digi3d.add_result(f"El dibujo tiene {len(view)} geometrías")
2. As a command (from the command console)
Run a script by name, like a native Digi3D.AI command:
- Save the
.pyin the macro directory, configured under Tools → Configuration → Drawing window → Macro directory. - With a drawing window open, press Enter: a text field appears in the status bar for a command name and parameters.
- Type the name and, if required,
=followed by space-separated parameters.
If the name matches no native command, Digi3D.AI searches the macro directory for a matching .py, loads it in the interpreter and runs it with the parameters. Run the script like any other command.
For example, with FILTRAR.py in the macro directory, entering:
FILTRAR=020124 020123 1
loads FILTRAR.py and runs it with those three parameters, because FILTRAR is not a native command.
Receiving parameters: argv
Parameters arrive in the global argv list as strings, in the order entered:
import digi3d
if len(argv) < 1:
digi3d.music(digi3d.MusicType.Error)
raise Exception("Falta el código")
codigo = argv[0]
distancia = float(argv[1]) if len(argv) > 1 else 1.0
# ... usa codigo y distancia
For an interactive command awaiting drawing input, create a class derived from PythonCommand instead of a linear script. See Text from the Cadastre street directory and Azure Maps.
3. As a quality control
A Python function can be a code's quality control: Digi3D.AI runs it on geometries with that code to check rules, on demand or in real time while digitizing. See Quality controls.
See also
- Programming examples: ready-to-use scripts and commands.
- Quality controls
- The
digi3dmodule