OpenSCAD-Debugging und typische Fehler

Wenn ein OpenSCAD-Modell nicht wie erwartet aussieht, hilft ein fester Prüfablauf. Beginne mit der Konsole und reduziere das Modell anschließend Schritt für Schritt auf den problematischen Bereich.

Die vier Debugging-Zeichen

OpenSCAD besitzt praktische Modifikatoren, die direkt vor einer Geometrie stehen:

# hebt einen Körper farbig hervor.
% zeigt Referenzgeometrie transparent und schließt sie vom Export aus.
! isoliert die markierte Geometrie.
* deaktiviert die folgende Geometrie vorübergehend.

difference() {
  grundplatte();
  #lochbild();
}

Mit echo() gibst du berechnete Werte gemeinsam mit einer verständlichen Bezeichnung in der Konsole aus.

Häufige Syntax- und Geometriefehler

Bei Syntaxfehlern fehlen oft Semikolon, Komma oder Klammer. Weitere typische Ursachen sind falsche Groß-/Kleinschreibung oder ein Textwert ohne Anführungszeichen. Die tatsächliche Ursache kann kurz vor der von der Konsole genannten Zeile liegen.

Ein leeres Ergebnis bei difference() entsteht häufig, wenn sich Werkzeug und Grundkörper nicht überschneiden oder der Werkzeugkörper das komplette Ausgangsmaterial entfernt.

Exakt deckungsgleiche Flächen können in der Vorschau flimmern. Verlängere Schneidkörper deshalb mit einem kleinen Übermaß:

epsilon = 0.1;
cube(
  [20, 20, staerke + 2 * epsilon],
  center = true
);

Fehler Schritt für Schritt eingrenzen

Fehlermeldung und Zeilennummer in der Konsole lesen.
Klammern und Trennzeichen kontrollieren.
Verdächtige Körper mit # markieren.
Module einzeln anzeigen und Operationen schrittweise aktivieren.
Parameter vorübergehend durch feste Testwerte ersetzen.
Mit F6 vollständig rendern und erst danach exportieren.

F5 liefert nur die schnelle OpenCSG-Vorschau. Für die endgültige Geometrie und einen zuverlässigen STL-Export ist immer F6 erforderlich.