Eine eigene AutoLISP-Routine für AutoCAD schreiben, laden und als Befehl bereitstellen

Einen Handgriff wählen, den du wirklich oft machst

Gute Kandidaten sind Abläufe aus drei bis fünf immer gleichen Schritten, die an einer festen Regel hängen: auf einen bestimmten Layer wechseln, dort etwas zeichnen und zurückwechseln, einen Block an einer gewählten Stelle mit festen Werten setzen, eine Auswahl auf eine Eigenschaft prüfen. Schlechte Kandidaten sind Abläufe, bei denen jedes Mal etwas anders entschieden wird, denn dort wird aus der Routine eine Abfragekette, die länger dauert als die Handarbeit.

Die Funktion mit dem Präfix c: zum Befehl machen

Eine mit defun definierte Funktion lässt sich nur mit Klammern aufrufen. Erst das vorangestellte c: macht daraus einen Befehl, der an der Befehlszeile ohne Klammern eingegeben werden kann. Wähl den Namen kurz, aber eindeutig, und nimm nie den Namen einer eingebauten Funktion, denn damit überschreibst du sie und machst sie unzugänglich. Ein zwei- bis dreibuchstabiges Kürzel mit einem festen Hauspräfix hat sich bewährt.

Alle Hilfsvariablen als lokal deklarieren

Hinter dem Schrägstrich in der Argumentliste stehen die lokalen Variablen. Was dort nicht steht, bleibt nach dem Lauf global im Speicher und kann eine andere Routine stören, die zufällig denselben Namen benutzt. Der Schrägstrich muss dabei durch mindestens ein Leerzeichen vom letzten Argument und vom ersten lokalen Namen getrennt sein. Das ist die häufigste Ursache für Routinen, die einzeln laufen und im Zusammenspiel nicht mehr.

Befehlsnamen mit Punkt und Unterstrich schreiben

Innerhalb der Funktion command wird der Befehlsname als Zeichenkette übergeben. Der vorangestellte Punkt sorgt dafür, dass der ursprüngliche Befehl verwendet wird, auch wenn jemand ihn im Haus umdefiniert hat. Der Unterstrich sorgt dafür, dass die englische Befehlsbezeichnung gilt, unabhängig von der Sprachfassung der Installation. Die Beispiele in der Dokumentation schreiben deshalb konsequent zuerst einen Punkt, dann einen Unterstrich und dann den Befehlsnamen.

Die Datei an einen Ort legen, der automatisch geladen wird

AutoCAD lädt bestimmte Dateien von sich aus. Die Datei acad.lsp wird einmal beim Programmstart geladen, acaddoc.lsp bei jeder Zeichnung, und für AutoCAD LT heißen sie acadlt.lsp und acadltdoc.lsp. Beide Dateien gehören nicht zum Lieferumfang, du legst sie selbst an und pflegst sie selbst. Routinen, die in allen Zeichnungen verfügbar sein sollen, gehören in acaddoc.lsp. Alternativ nutzt du die Startgruppe des Befehls APPLOAD, dann musst du gar keine Datei bearbeiten.

Den Speicherort als vertrauenswürdig eintragen

Im sicheren Modus lädt AutoCAD Code nur aus Pfaden, die in TRUSTEDPATHS stehen. Für ein Team heißt das: Die Sammlung liegt in einem Netzlaufwerk oder in einem verteilten Ordner, und dieser Pfad wird bei der Einrichtung der Arbeitsplätze eingetragen. Wer diesen Schritt überspringt, bekommt eine Sammlung, die auf genau einem Rechner funktioniert, und niemand sucht die Ursache an der richtigen Stelle.

Aufräumen einbauen, bevor jemand Esc drückt

Jede Routine, die einen Zustand ändert, muss ihn wiederherstellen, auch wenn sie abbricht. Merk dir den alten Wert mit getvar, setz den neuen mit setvar, und stell den alten am Ende wieder her. Für den Abbruchfall definierst du zusätzlich eine eigene Fehlerbehandlung, in AutoLISP als Funktion mit dem von Sternchen eingefassten Namen error, und wenn darin Befehle aufgerufen werden, empfiehlt die Dokumentation ausdrücklich command-s statt command, weil diese Variante in Fehlerbehandlungen benutzt werden darf.