Zum Inhalt springen
LinkCAD Documentation linkcad.com

Ihr erstes Skript

Dieses Tutorial führt Sie durch die Ausführung Ihres ersten Python-Skripts in der interaktiven Konsole von LinkCAD.

Konsole öffnen

Gehen Sie zu View → Python Console (Ctrl+Shift+P). Unten im Fenster erscheint eine Python-Eingabeaufforderung.

Hello World

Geben Sie Folgendes ein und drücken Sie ↵:

print("Hello from LinkCAD!")

Die Ausgabe sollte in der Konsole erscheinen.

Zeichnung erkunden

Konsole und Skripteditor definieren eine globale Variable drawing, die immer auf die gerade in LinkCAD geöffnete Zeichnung verweist. Ist nichts geladen, ist sie None.

Wenn eine Datei geladen ist, können Sie ihre Struktur untersuchen:

if drawing is None:
    print("Open a file first")
else:
    for cell in drawing.cells:
        print(f"Cell: {cell.name}")


    for layer in drawing.layers:
        print(f"Layer: {layer.name}")

cells und layers sind Eigenschaften, keine Methoden — ein Substantiv kostet keine Klammern. Diese Konvention zieht sich durch die gesamte API: shape.area, cell.bounds, polygon.vertices. Nur Verben behalten ihre Klammern: shape.destroy(), cell.clone(name).

Formen zählen

main = drawing.main_cell
print(f"Total shapes in main cell: {len(main.shapes)}")

Oder etwas nützlicher, pro Ebene:

from collections import Counter


counts = Counter(
    shape.layer.name
    for cell in drawing.cells
    for shape in cell.shapes
    if shape.layer is not None
)


for name, count in counts.most_common():
    print(f"{name}: {count} shapes")

Eine Zeichnung von Grund auf erstellen

Eine Zeichnung hält die gesamte Datenbank im Speicher und muss freigegeben werden. Als Kontextmanager verwendet, geschieht das automatisch:

from linkcad.v1.db import Drawing
from linkcad.v1.geom import Point


with Drawing("first-script") as dwg:
    top = dwg.add_cell("TOP")
    dwg.main_cell = top


    metal = dwg.add_layer("METAL1")


    top.add_polygon(metal, [(0, 0), (10_000, 0), (10_000, 10_000), (0, 10_000)])
    top.add_circle(metal, Point(20_000, 5_000), diameter=6_000)
    top.add_text(metal, "TOP", Point(0, 12_000), height=2_000)


    print(f"{len(top.shapes)} shapes, bounds {top.bounds}")

Geometrie wird immer von dem Objekt erzeugt, dem sie gehören wird: die Zeichnung erzeugt Zellen und Ebenen, die Zelle erzeugt Formen.

Skripteditor verwenden

Verwenden Sie für längere Skripte den integrierten Editor:

  1. Öffnen Sie View → Python Script Editor (Ctrl+Shift+E)
  2. Schreiben Sie Ihr Skript im Editor
  3. Drücken Sie F5, um das gesamte Skript auszuführen
  4. Oder wählen Sie Zeilen aus und drücken Sie Ctrl+↵, um nur die Auswahl auszuführen

Nächste Schritte