Encrust
Alle Anleitungen

Drucken · Anleitung 20 von 21

Ein Resin-Slicer für die Kommandozeile

10 Min. Lesezeit

Der Befehl encrust ist ein Resin-Slicer fürs Terminal. Ohne Programmfenster macht er aus einem Modell, den Platten eines Projekts oder einem ganzen Ordner eine Druckdatei wie .ctb oder .goo, und er steuert einen Drucker im Netzwerk. Mit --json gibt er pro Lauf ein JSON-Dokument aus, und am Exit-Code erkennt ein Skript, wie es lief.

Fällt ein Modell durch die Prüfung, bleibt keine halb brauchbare Datei liegen. Mit --strict endet der Lauf mit Exit-Code 3, sobald ein Modell Fehler hat oder nicht auf die Druckplatte passt, und die gerade geschriebene Datei oder der PNG-Ordner verschwindet wieder von der Festplatte. Exit-Code und Festplatte sagen also dasselbe, und ein Skript kann sich auf beides verlassen.

Ein einzelnes Modell oder eine Platte slicen Sie am bequemsten im Programmfenster, wie in Ihr erster Druck. Den Befehl brauchen Sie, wenn ein ganzer Ordner ansteht oder ein Skript das Slicen übernimmt. Programmfenster und Befehl nutzen denselben Code. Hier stehen die Befehle, die Sie zuerst brauchen; alles Weitere steht in der Referenz.

Vorbereitung

Encrust muss installiert sein (Encrust installieren), ein Drucker gewählt wie in Ihr erster Druck und ein eigenes Resin angelegt (Drucker-, Resin- und Stützenprofile, auf Englisch). Außerdem brauchen Sie ein Modell als STL, OBJ oder 3MF.

Der Befehl ist ein eigenes Programm namens encrust, das neben der Encrust-App liegt. Die portablen Archive encrust-*.tar.gz und .zip enthalten beide in einem Ordner Encrust, so packt sie der Release-Workflow. Ob der Befehl im PATH liegt, zeigt encrust --version im Terminal; findet die Shell ihn nicht, starten Sie ihn aus dem entpackten Ordner. Haben Sie den Quellcode ausgecheckt, rufen Sie ihn so auf, wie es in der README steht: cargo run --release -p encrust-cli --bin encrust --. Im Folgenden steht encrust für jede dieser Varianten.

Drucker- und Resin-IDs nachschlagen

Führen Sie encrust profiles list aus. Die Ausgabe hat drei Blöcke: Drucker, Resins und Stützenprofile, Ihre eigenen Profile sind markiert. Im Resin-Block steht nur, was Sie selbst angelegt haben, denn der Katalog bringt kein Resin mit: Eine Belichtung misst man am eigenen Drucker.

Einen Drucker ohne Resin lehnt der Befehl ab, statt ihm Standardwerte unterzuschieben. Ist der Resin-Block leer, legen Sie zuerst im Fenster Machine and resin ein Resin an, oder schreiben Sie eine TOML-Datei und importieren Sie sie mit encrust profiles import grey.toml --kind resin --printer elegoo-mars-4-ultra. encrust profiles show <id> gibt jedes Profil als TOML aus, so wie es gespeichert ist. Mit -o file.toml landet es in einer Datei, die Sie bearbeiten und mit --profile (Drucker) oder --material (Resin) wieder übergeben. Ein Pfad hat Vorrang vor einer Katalog-ID.

Ein Modell slicen

encrust slice model.stl \
  --printer elegoo-mars-4-ultra --resin my-grey --center -o model.goo

Die Endung hinter -o bestimmt das Format: .goo, .prz, .ctb, .cbddlp, .photon, .sl1, .zip, .crmaslice, .cxdlp, .cxdlpv4, .fdg, .phz, .photons, .cxline und der Rest der Liste, darunter die Anycubic-Endungen und die .pwsz-Familie. Ein Name ohne Endung ergibt einen Ordner mit PNG-Schichten.

Eine .ctb schreibt Encrust in der Revision, die das Druckerprofil nennt: Version 5 oder den verschlüsselten Container, wenn das LCD auf einer Seite mehr als 4095 Pixel hat. Mit --ctb-version 4, 5 oder encrypted legen Sie die Version selbst fest. Eine .goo entsteht in Revision 5.1, wo das Profil sie nennt, sonst in 3.0. Jede Druckdatei braucht --printer (oder --profile), denn die Schichten werden für das LCD des Druckers berechnet. Fehlt die Angabe, bricht der Befehl mit einem Fehler ab.

Im Terminal läuft ein Fortschrittsbalken über die Schichten. Mit --quiet, --no-progress und --json bleibt er weg.

Aushöhlen, Stützen, Relief und die übrigen Werkzeuge des Fensters sind ebenfalls Flags von slice: --hollow 2 --drain 4 --drain-at 30,30,60, --supports medium, --relief 0.4.

--infill hive --infill-cell 6 --infill-density 0.3 füllt den Hohlraum, --keep-solid X,Y,Z lässt die Wand an einem Punkt massiv (--keep-solid-size reicht so viele Millimeter darüber hinaus), --keep-solid-under 6 lässt sie überall massiv, wo das Modell dünner als 6 mm ist, sodass Finger und Klingen das Aushöhlen überstehen, und --drain-walled bohrt eine Vertiefung in die Wand und --drain-support-at X,Y,Z ein Loch in die Stützen. Statt einen Punkt zu wählen, bohrt --drain-at auto für jede Tasche, in der noch Resin stehen bleibt, ein Ablaufloch und eine Entlüftung und behält ein Loch erst, wenn ein Scan seine Tasche leer findet; --no-drain-vent lässt die Entlüftungen weg (die Referenz). --supports auto bemisst jede Stütze nach dem, was sie trägt, wie Auto im Programmfenster, und --support-cavity stützt auch den Hohlraum eines ausgehöhlten Modells, wie Support the cavity. Zu jedem Flag hat die Referenz ein Beispiel; was die Zahlen bewirken, erklären die Anleitungen zum Aushöhlen und zu Stützen.

Diese Zahlen sind Beispiele für einen Drucker und ein Resin, keine Empfehlungen: Die Angaben Ihres Resin- und Ihres Druckerherstellers gehen vor.

Das Modell ausrichten lassen

--orient dreht das Modell vor allem anderen und meldet das --rotate, mit dem sich die Drehung wiederholen lässt. Wonach gesucht wird, legt --orient-goal fest: fewest-supports (Standard), least-peel, shortest-print oder auto, das die drei gegeneinander abwägt. Mit --max-tilt 30 weicht das Modell höchstens 30 Grad von der Lage ab, in der es in der Datei steht. --clean-surface hält jedes Ziel bei möglichst wenigen Kontakten dort, wo das Modell sichtbar ist, nach seiner Form beurteilt (die Referenz). Ist ein Drucker angegeben, listet der Befehl die besten Lagen der Suche zur Auswahl auf, wie Auto-orient im Programmfenster (Ausrichtung).

Das Modell vorbereiten lassen

--prepare führt die Schritte der Reihe nach aus, ohne etwas abzustimmen: ausrichten (--orient-goal auto), reparieren, wenn der Import einen Defekt fand, aushöhlen, wenn das mindestens 10 ml und 40 % spart, Ablauflöcher bohren, stützen. Wo Resin eingeschlossen bleibt oder das Modell auf seinen Stützen nicht passt, hält der Befehl an und sagt es. --strict ist damit nicht gemeint. --recipe ID|PATH bei slice, estimate und batch führt stattdessen ein Rezept aus, ein eingebautes per ID (encrust recipes list zeigt sie) oder Ihre eigene Datei. Ein Projekt bringt seine eigenen Schritte mit und lehnt beides ab.

encrust slice figure.stl --printer elegoo-mars-4-ultra --resin my-grey --prepare -o figure.goo

Ein Modell reparieren

--repair schließt Nähte, entfernt Splitter, flickt Löcher und löscht doppelte Flächen wie das Werkzeug Repair. Bliebe danach mehr kaputt als vorher, lässt es das Modell, wie es war. --repair=close-holes, =close-small-holes oder =turn erledigt nur einen Teil davon; =wrap legt um alle Schalen eine gemeinsame Außenfläche, und =deep repariert, umhüllt und repariert noch einmal. --seam-tolerance MM (Standard 0,01 mm) bestimmt, wie weit ein Eckpunkt von einer offenen Kante entfernt sein darf, um noch vernäht zu werden, und --smallest-shell MM2 (Standard 1 mm²), welche Fläche eine offene Schale mindestens haben muss, um zu bleiben.

Von Hand geht es wie im Modus Faces und in der Liste Shells: --flip-faces 3,4 dreht Flächen um, --drop-faces entfernt sie, --drop-shells 2 entfernt Schalen, ab 1 gezählt wie in der Liste von inspect --shells, und --bridge A-B:C-D spannt Flächen zwischen zwei offene Kanten. Jede Nummer bezieht sich auf das Modell, wie es aus dem Import kommt. Was die einzelnen Methoden tun, steht in Modell prüfen und reparieren (auf Englisch).

encrust inspect broken.stl --repair
encrust slice parts.stl --drop-shells 2,3 -o out

Kanten glätten

Wie die Kanten einer Maske schattiert werden, steht im Abschnitt [edges] des Resins; steht dort nichts, glättet Encrust sie. --anti-alias schattiert Kanten nach Abdeckung, --no-anti-alias schaltet jedes Pixel ganz an oder ganz aus. --grey-levels N rundet die Kanten auf N Graustufen, --blur PX lässt jede Kante weich auslaufen, und --grey-range MIN..MAX verteilt die Graustufen der Kanten auf diesen Bereich statt auf den des Druckerprofils. Ein Drucker, dessen Masken keine Graustufen kennen, übergeht diese Flags mit einer Warnung.

Vor dem Slicen prüfen

encrust inspect model.stl --printer elegoo-mars-4-ultra liest ein Modell und meldet Größe, Fehler und ob es passt, ohne zu slicen. Mit --center sehen Sie die Abmessungen nach dem Platzieren, --shells listet jede Schale ab 1 nummeriert auf, und --intersections zählt die Flächenpaare, die sich schneiden. Ragt ein Modell in den Randstreifen, den ein Hersteller an der Kante der Druckplatte frei hält, passt es trotzdem, und der Bericht nennt, wie weit es hineinreicht. Würde Aushöhlen auf 2 mm Wand bei einem massiven Modell mindestens 10 ml und 40 % sparen, bekommt es eine Zeile solid mit der Menge.

encrust estimate model.stl --printer elegoo-mars-4-ultra --resin my-grey nimmt dieselben Angaben wie slice, schreibt aber nichts. Es gibt Schichtzahl, Druckzeit, Resinmenge und Gewicht aus, dazu die Schichten, die wahrscheinlich fehlschlagen. Das ist der Probelauf, ein Flag --dry-run gibt es nicht. Auch inspect kennt --strict und kann ein Modell so aussortieren, ohne eine Datei zu schreiben.

Der Bericht urteilt wie On the plate in Check. Hat --supports die Stützen gesetzt, gilt die Zeile fits für das Modell samt Stützen und Raft dort, wo sie stehen. Zwei Modelle, die ineinander stehen, oder Stützen des einen, die in ein anderes reichen, nennt er einmal als meeting a.stl and b.stl. Berührung zählt, ein Spalt nicht. Mit --strict schlägt der Lauf in beiden Fällen fehl, und bei batch listet jedes Modell unter meets die anderen, auf die es trifft.

encrust info plate.ctb geht den umgekehrten Weg und öffnet eine Druckdatei in jedem Format, das die Referenz aufführt. Was es ausgibt, erklärt .ctb-Datei öffnen und Schichten prüfen. Mit --thumbnail out.png speichern Sie die größte Vorschau der Datei als PNG.

Einen ganzen Ordner slicen

encrust batch models/ \
  --printer elegoo-mars-4-ultra --resin my-grey --center --orient --supports light -o out/
encrust batch models/ --printer elegoo-mars-4-ultra --resin my-grey \
  --name "{model}_{resin}_{layer}um_{date}" -o out/

Encrust slicet jede .stl, .obj und .3mf im Ordner mit denselben Flags und lässt andere Dateien in Ruhe. Jedes Modell bekommt eine eigene Druckdatei und einen Bericht <name>.json, dazu schreibt der Lauf eine batch.json über alle. Ohne -o landet alles in out. --name benennt jede Datei nach einer Vorlage, wie die Einstellung File name im Programmfenster: {model}, {ext} (die Endung des Modells), {printer}, {resin}, {layer} in µm, {plate}, {date} und {time}. Die Endung des Druckers hängt Encrust an.

--jobs N slicet so viele Modelle gleichzeitig, Standard ist 1. Schlägt ein Modell fehl, laufen die anderen weiter, und der Lauf endet mit Exit-Code 4. Hier bekommt jedes Modell seine eigene Datei. Um mehrere Modelle auf eine Druckplatte zu packen, geben Sie slice mehrere Dateien und --arrange mit, wie in Modelle anordnen (auf Englisch).

Aus einem Skript aufrufen

Auf zwei Dinge kann sich ein Skript verlassen. Das erste ist --json: Es gibt genau ein JSON-Dokument auf stdout aus, mit "schema": 1 neben den Feldern des Berichts. Logs und Fortschritt gehen nach stderr, encrust inspect model.stl --json | jq lässt sich also direkt auswerten. Ein fehlgeschlagener Lauf gibt an derselben Stelle {"schema": 1, "error": {"message", "chain", "cancelled"}} aus. Die Schema-Nummer steigt, wenn ein Feld wegfällt oder seine Bedeutung ändert; ein neues Feld erhöht sie nicht. Lesen Sie die Felder, die Sie brauchen, deshalb beim Namen und übergehen Sie den Rest. Befunde kommen mit einem Ort: cured.risks listet jedes Risiko mit Schicht und Punkt at_mm, slicing.trapped jede eingeschlossene Tasche, und supports.no_room_why nennt, warum ein Kontakt keinen Platz fand (head-blocked, faces-up oder no-ground). Die Punkte liegen in dem Koordinatensystem, das --drain-at annimmt, ein Skript kann also jeden zurückgeben.

Das zweite ist der Exit-Code:

Code Bedeutung
0 Fertig
1 Der Lauf ist fehlgeschlagen
2 Die Argumente waren falsch
3 --strict, und ein Modell hat Fehler oder passt nicht; auf der Festplatte bleibt nichts zurück
4 Eine Stapelverarbeitung, in der mindestens ein Modell fehlgeschlagen ist
130 Mit Strg+C abgebrochen

Quelle: die Exit-Codes. Das erste Strg+C hält zwischen zwei Schichten an, in der Stapelverarbeitung zwischen zwei Modellen, und löscht die Datei, die gerade entsteht. Ein zweites beendet sofort.

Eine Zahl hinter einem Flag darf negativ sein: --rotate -90,0,0 funktioniert so, wie es dasteht.

Flags in einer Datei ablegen

--config FILE liest Flags aus einer TOML-Datei. Ein Schlüssel ist der lange Name eines Flags, eine Tabelle steht für einen Unterbefehl.

[slice]
printer = "elegoo-mars-4-ultra"
resin = "my-grey"
center = true

Ein getipptes Flag hat Vorrang vor der Datei. Ein Schlüssel, den der Befehl nicht kennt, ist ein Fehler mit Exit-Code 2.

Plattendateien und Projekte

encrust slice plate.toml -o plate.goo liest eine Plattendatei, die Modelle mit eigenem rotate, scale, position, supports und hollow auflistet. Ein im Programmfenster gespeichertes Projekt slicet der Befehl so, wie es gespeichert ist: encrust slice plate.encrust --resin my-grey -o plate.goo. Ein Projekt nennt Drucker und Resin nur per ID; fehlt eines davon unter Ihren Profilen, geben Sie es per Flag an. Flags, die ein Modell verändern, etwa --hollow oder --supports, lehnt der Befehl bei einem Projekt ab.

Druckeinstellungen speichert ein Projekt nicht, die liegen in den Profilen von Drucker und Resin. --layer-height, --adaptive, --samples-per-layer, --exposure-at und die Masken-Flags wirken auf ein Projekt genauso wie auf ein Modell.

Eine Platte wählen

Hat ein Projekt mehrere Platten, slicet der Befehl die, auf der es gespeichert wurde, und sagt das dazu. --plate N wählt eine andere, ab eins gezählt wie in der Plattenleiste, für slice und estimate. slice --all-plates schreibt jede Platte mit Modell in eine eigene Datei, die nach ihr benannt ist, also plate-small-parts.goo neben plate.goo, wie File > Slice all N plates to .goo. Mit --json entsteht ein einziges Dokument mit einem Bericht pro Platte unter plates.

encrust slice plate.encrust --plate 2 -o small.goo
encrust slice plate.encrust --all-plates -o plate.goo

Weitere Unterbefehle

encrust convert plate.ctb --printer elegoo-mars-4-ultra -o plate.goo wandelt eine Druckdatei in ein anderes Format um, ohne die Schichten neu zu berechnen. Das LCD des Druckers muss deshalb genauso groß sein wie das, für das die Datei erstellt wurde. encrust completions zsh gibt Shell-Vervollständigungen für bash, zsh, fish, elvish oder PowerShell aus.

encrust profiles reset-unreadable verwirft die Kopien mitgelieferter Profile, die sich nicht mehr lesen lassen, sodass wieder die mitgelieferten gelten. --with-own löscht auch Ihre eigenen unlesbaren Dateien, wie Delete im Programmfenster.

Einen Drucker im Netzwerk steuern

encrust printer discover, status und send sprechen über das lokale Netzwerk mit einem Drucker. discover sucht per Broadcast nach ELEGOO-Boards, status und send erwarten die IP-Adresse eines Boards. send --start startet die Datei, sobald das Board sie geprüft hat. Starten Sie einen Druck nur, wenn Sie am Drucker stehen und Wanne und Druckplatte bereit sind, und halten Sie sich an das Handbuch des Druckers.

Einen Prusa-Drucker findet Encrust nicht per Broadcast, und es schickt ihm nur .sl1 und .sl1s. Geben Sie ihn mit --prusalink und seinem Hostnamen an, und übergeben Sie Schlüssel oder Passwort als ENCRUST_PRUSALINK_KEY oder ENCRUST_PRUSALINK_PASSWORD, damit sie nicht im Verlauf Ihrer Shell landen.

Läuft ein Druck, gibt es die Schaltflächen der Druckerkarte auch als Befehle:

Befehl Was er tut
pause, resume Hält den Druck an oder setzt ihn fort
stop Bricht ihn ab; ein abgebrochener Druck lässt sich nicht fortsetzen, und der Befehl fragt vorher nicht nach
history Listet die letzten Drucke, die sich ein ELEGOO-Board merkt, 10, wenn --count nichts anderes sagt; von einem Prusa-Drucker liest Encrust keinen Verlauf
camera on, camera off Gibt die RTSP-Adresse aus, an die ein ELEGOO-Board streamt, für einen Videoplayer, oder schaltet den Stream ab
picture -o FILE Speichert das Bild der Druckplatte, das der Drucker zum laufenden Druck aufbewahrt
encrust printer pause 192.168.1.42
encrust printer history 192.168.1.42 --count 5

Das sind die Druckerbefehle der Referenz; mit --json gibt jeder seine eigenen Felder aus.

Was Encrust ablehnt und wovor es nur warnt

Was Encrust nicht so ausführen kann, wie verlangt, lehnt es ab und sagt das. Eine andere Datei schreibt es stattdessen nicht. Abgelehnt werden:

  • ein Drucker ohne Resin oder ein Druckdateiformat ohne Drucker,
  • bei einem Projekt ein Flag, das die Form eines Modells ändert,
  • eine Füllungszahl ohne --infill,
  • ein Ablaufpunkt auf einer Kante oder Ecke des Modells statt auf einer Fläche,
  • bei einer .sl1 eine Belichtung nach Höhe (--exposure-at) oder adaptive Schichten.

Nur eine Warnung gibt es, und die Datei entsteht trotzdem, wenn eine Resin-Einstellung über dem liegt, was der Drucker annimmt oder sein Hersteller rät (slice und convert nennen jede einzeln), und wenn Sie Masken-Flags für einen Drucker angeben, dessen Masken keine Graustufen kennen.

Wenn etwas schiefgeht

Exit-Code 2

Ein Argument war falsch: ein Flag, das der Unterbefehl nicht kennt, zwei Flags, die sich widersprechen, oder ein unbekannter Schlüssel in einer --config-Datei. Die Meldung auf stderr nennt es. Maßgeblich für die Flags ist encrust slice --help.

Der Drucker wird abgelehnt

Sie haben einen Drucker angegeben, aber kein Resin. Nennen Sie eines mit --resin oder einen TOML-Pfad mit --material. Welche es gibt, zeigt encrust profiles list.

Exit-Code 3, und es gibt keine Datei

Genau dafür ist --strict da. Der Bericht nennt trotzdem jeden Fehler oder den Überstand. Reparieren Sie das Modell, verschieben Sie es mit --center, oder lassen Sie --strict weg, wenn Sie den Fehler in Kauf nehmen.

Eine Stapelverarbeitung endet mit Code 4

Mindestens ein Modell ist fehlgeschlagen, die anderen sind fertig. Welches, steht in batch.json und in der <model>.json neben jedem Modell.

Quellen