Quick Start Anleitung
Es gibt drei Möglichkeiten, Scripting zu verwenden:
- Live Scripting Konsole
- Scripts in der Script-Bibliothek
- Ausführen von KeyShot auf der command-line:
keyshot.exe (optional file to open) -script <python script file> (optional script arguments..)
Die ersten beiden werden über den Scripting-konsolendialog aufgerufen, der über das Menü “Fenster > Scripting Konsole” oder durch Klicken auf die Schaltfläche “Scripting Konsole” im Ribbon geöffnet wird. Im Dialog gibt es zwei Registerkarten; „Konsole“ und „Scripts“.
Konsole
Die Konsole ist ein Live-Python-Interpreter, in den Sie zu evaluierenden Python-Code eingeben können.
Anmerkung
KeyShot verwendet Python 3.10 für Scripting-Zwecke.
Script-Bibliothek
Die Script-Bibliothek enthält vorgefertigte Scripts, die mit KeyShot gebündelt sind und entweder direkt nutzbar sind oder Beispiele für bestimmte Aufgaben enthalten. Es wird empfohlen, einen Blick in diese Dateien zu werfen, um mehr zu erfahren.
Allgemeine Hilfe
Um Hilfe zu erhalten, können Sie die Online-Dokumentation konsultieren oder die Hilfe-Funktion verwenden.
Außerdem, wann immer Zeilen wie die folgenden erscheinen:
>>> print("Hello, World!") # I am a comment
Hello, World!Dann symbolisiert es die Interaktion mit der Konsole, wobei “>>>” Python-Code als Eingabe bedeutet, und ansonsten wird es an die Konsole geschrieben ausgegeben. Beachten Sie den Kommentar nach dem Print. Kommentare werden vom Python-Interpreter immer ignoriert.
Es gibt zwei Hauptmodule für das KeyShot-Scripting; lux und luxmath. Gehen Sie wie folgt vor, um die Hilfe zum lux-Modul zu printen:
>>> help(lux)
(several lines omitted..)Es kann auch für Funktionen verwendet werden, um zu verstehen, was sie tun:
>>> help(lux.pause)
Help on built-in function pause in module lux:
pause(...)
Pauses renderer.