Python-Scripting

LinkCAD enthält einen eingebetteten Python-Interpreter für benutzerdefinierte Automatisierung, Tool-Entwicklung und die Erstellung von Format-Plugins. Python-Skripte können auf die vollständige Zeichnungsdatenbank und Geometrie-API zugreifen.

Funktionen

• Benutzerdefinierte Tools — Menüeinträge erstellen, die Zeichnungsgeometrie verarbeiten
• Format-Plugins — Unterstützung für neue Import-/Export-Dateiformate hinzufügen
• Interaktive Konsole — Zeichnungen live erkunden und bearbeiten
• Skripteditor — Skripte direkt in LinkCAD schreiben und ausführen

Erste Schritte

1. Einrichtung & Anforderungen — Python-Umgebung und Voraussetzungen
2. Ihr erstes Skript — „Hello World“ in der Python-Konsole
3. Ein Tool-Plugin schreiben — ein ins Menü integriertes Tool erstellen
4. Ein Format-Plugin schreiben — ein neues Dateiformat hinzufügen
5. Tutorial zur Panel-Zusammenstellung — vollständiges praxisnahes Beispiel

API-Referenz

• Optionstypen — integer, real, boolean, string, choice, path, color, table, cell_choice
• Tool-Dekorator — @tool()-Dekorator und Tool-Basisklasse
• Format-Dekoratoren — @format_reader(), @format_writer() und Basisklassen
• API-Module — alle Module: linkcad.plugin, linkcad.db, linkcad.geom, linkcad.edit, linkcad.env, linkcad.conv, linkcad.libgraph, linkcad.controller

Kurzes Beispiel

Ein einfaches Tool, das Formen pro Ebene zählt:

from linkcad.plugin import tool, Tool

@tool(
    name="Layer Statistics",
    menu="Tools/Analysis",
    tooltip="Count shapes per layer",
)
class LayerStats(Tool):
    def run(self, drawing) -> None:
        for layer_name, shapes in drawing.shapes_by_layer():
            count = sum(1 for _ in shapes)
            print(f"{layer_name}: {count} shapes")