Aktion „Lua Kommando“
Im Dialog Objekte verändern steht die Aktion „Lua Kommando“ zur Verfügung, mit der Lua-Funktionen aufgerufen werden können, die in der Kommando-Datei cnacmd.lua definiert wurden.
Zur Einschränkung der Auswahl der betroffenen Objekte stehen alle im Dialog Objekte verändern verfügbaren Optionen zur Verfügung (siehe Kapitel 11 - Objekte verändern im Handbuch „Einführung in CadnaA“).
Kommando-Datei öffnen & editieren
Wählen Sie in CadnaA den Befehl Lua-Kommando-Datei öffnen im Menü Extras, um die aktuell verwendete Kommando-Datei cnacmd.lua in dem verlinkten Lua-Editor zu öffnen (z.B. LuaEdit).
Anschließend kann die Datei editiert werden. Eine Kommando-Datei kann beliebig viele Lua-Funktionen (function) enthalten, die anschließend im Dialog Lua Kommando angezeigt werden.
Alternativ kann der Kode auch in einen lokalen oder globalen Textbaustein mit der Bezeichnung CNACMD.LUA eingefügt werden.
Lua-Funktionen aufrufen
Öffnen Sie den Dialog Objekte verändern und wählen Sie die Aktion „Lua Kommando“. Wählen Sie z.B. nur die Objektart „Punktquelle“ aus, um eine der in der Lua-Kommando-Datei vorhandenen Funktionen darauf anzuwenden. Wählen Sie im anschließenden Dialog Lua Kommando eine der Lua-Funktionen aus und klicken Sie OK.
Dialog Lua Kommando mit den Lua-Funktionenaus nachfolgendem Beispiel
Beispiel
In nachfolgend aufgeführten Beispiel sind drei Funktionen in der Kommando-Datei cnacmd.lua vorhanden:
-- function changes the name BEZ to "from LUA-file 3" of all objects found
function cnacmd.find3(o)
o.BEZ = "from LUA-file 3"
return 1
end
-- optional description, not inside the function, but outside with reference
cnacmd.find3_descr="BEZ = from LUA-file 3"`
-- function changes ID to "ST_1"
function cnacmd.myfunct_2(o)
o.ID = "ST_1"
return 1
end
cnacmd.myfunct_2_descr="ID = ST_1"`
-- function deletes objects foundfunction cnacmd.delete1(x)
x:delete()
return 1
end
cnacmd.delete1_descr="delete objects found"`