De CLI gebruiken

Inspecteer en bewerk de actieve app via de lokale API, of exporteer G-code rechtstreeks.

Het binaire bestand beambench-cli wordt samen met de desktopapp gedistribueerd. De meeste opdrachten voor projecten, ontwerpen, machines, profielen en status zijn clients van de lokale API van de app. Hiervoor moet de app actief zijn met Instellingen > Algemeen > Lokale API ingeschakeld.

Houd Netwerkapparaten toestaan verbinding te maken uitgeschakeld voor scripts die op dezelfde computer worden uitgevoerd. De CLI leest de geconfigureerde API-poort uit de app-instellingen; de standaardwaarde is 5900.

Beschikbare opdrachten vinden

beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json

Help werkt zonder de app. Mogelijkheden en live status gebruiken de API. Voer een subopdracht uit met --help om de parameters voor de geïnstalleerde versie te bekijken.

Een project openen en inspecteren

beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json

Een project openen verandert het project in de desktopapp. Sla je werk op voordat je scripts uitvoert die het project vervangen of bewerken.

beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj

Renderen en exporteren

beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg

Deze opdrachten gebruiken het project van de actieve app via de API. Voor het renderen van ontwerpen hoeft het canvas niet zichtbaar te zijn, maar de server is wel vereist.

beambench-cli camera overlay render --output /tmp/overlay.png --view fit

Voor het renderen van een camera-overlay moet de frontend van de app het renderverzoek ook verwerken. Dit is geen vervanging zonder gebruikersinterface voor de cameraworkflow.

Opdrachten die zonder de app werken

Het weergeven van seriële poorten, help en de G-code-export met positionele argumenten hebben directe lokale paden:

beambench-cli ports
beambench-cli export gcode /abs/path/project.lzrproj /abs/path/out.gcode

Een zelfstandige G-code-export gebruikt een lokaal opgeslagen machineprofiel en de plannings- en uitvoercontroles van de desktopapp. Deze kan een actieve machinepositie niet lezen. Lees G-code-uitvoer voor vereisten voor profielen en plaatsing.

Automatisering en conflicten

Ontwerptranacties gebruiken de huidige projectrevisie. Als een andere bewerking, projectwissel of sluitactie het vastgelegde project ongeldig maakt, wordt de transactie afgewezen. Vernieuw de status en beoordeel de bewerking opnieuw voordat je het opnieuw probeert; overschrijf gelijktijdige gebruikersbewerkingen niet met een oude snapshot.

Voor opdrachten die de machine kunnen verplaatsen, de laser kunnen activeren, onbewerkte G-code kunnen verzenden of luchtassistentie kunnen wijzigen, zijn de bijbehorende bevestigingsflags vereist. Bekijk de opdrachthelp en de beoogde actie voordat je deze opgeeft.

De CLI selecteert geen canvasgereedschappen, rangschikt geen panelen en activeert geen sneltoetsen. Dat zijn acties in de desktopinterface.