Text im Modell: text() und Schriften

Begriffe vorab

• text(): Erzeugt 2D-Text aus einer Zeichenkette.
• Baseline: Grundlinie, an der Buchstaben stehen.
• halign / valign: Horizontale und vertikale Ausrichtung.
• Schriftname: Name mit optionalem Stil, z. B. „Liberation Sans:style=Bold“.
• Extrusion: Gibt dem 2D-Text eine Höhe.

text() erzeugt 2D

text() liefert 2D-Geometrie. Für gedruckte Beschriftung wird er wie jede 2D-Form extrudiert: linear_extrude(4) text("Text");.

Parameter

• text: die Zeichenkette.
• size: Höhe, Standard 10. In westlicher Schrift sind Großbuchstaben ungefähr so hoch (die tatsächliche Höhe hängt von der Schrift ab).
• font: logischer Schriftname, Standard „Liberation Sans“. Stil mit Doppelpunkt: "Liberation Sans:style=Bold Italic".
• halign: "left" (Standard), "center", "right".
• valign: "top", "center", "baseline" (Standard), "bottom".
• spacing: Zeichenabstand, Standard 1.
• direction: "ltr" (Standard), "rtl", "ttb", "btt".
• language, script: Lokalisierung.
• $fn, $fs, $fa: Kurvenunterteilung.

Ausrichtung

Mit valign = "baseline" sitzen verschiedene Texte wie auf liniertem Papier auf derselben Grundlinie; die anderen Optionen richten sich nach der Begrenzungsbox. Horizontal bezieht sich die Ausrichtung auf die linke, mittlere oder rechte Kante des Textes.

Schriften und Portabilität

Mitgeliefert und deshalb empfehlenswert für portable Modelle sind Liberation Mono, Liberation Sans und Liberation Serif. Welche Schriften dein System kennt, zeigt die Schriftenliste im Menü „Window“. Wer ein Modell weitergibt, sollte mitgelieferte Schriften verwenden, sonst sieht es auf anderen Rechnern anders aus.

// Namensschild: Platte mit erhabener Beschriftung
cube([60, 20, 3]);
translate([30, 10, 3])
    linear_extrude(2)
        text("OpenSCAD", size = 8, halign = "center", valign = "center",
             font = "Liberation Sans:style=Bold");

Die Platte ist 60 × 20 × 3, der Text sitzt mittig auf der Oberseite und ragt 2 Einheiten heraus. halign und valign auf „center“ machen die Positionierung leicht: Der Mittelpunkt des Textes liegt genau am verschobenen Punkt.

Die Doku merkt an, dass size auf einer historisch ungenauen Berechnung beruht: Die tatsächliche Höhe von Großbuchstaben kann je nach Schrift etwas kleiner ausfallen. Miss nach, wenn es auf Millimeter ankommt.

Zentriere Beschriftungen mit halign und valign auf „center“, statt Positionen auszuprobieren.

Zum Selbermachen

1. Beschrifte eine Platte mit deinem Namen und probiere drei Schriftstile.
2. Prüfe die tatsächliche Höhe eines Großbuchstabens mit der Messfunktion der Vorschau.

Verwandte Themen

OpenSCAD → Die übrigen Lektionen dieser Themenwelt; Informatik: Grundlagen → „Algorithmen und Berechenbarkeit“ für das Denken in Schritten.

Prüfstatus: Belegt (Stand 1. Oktober 2026): Parameter, Standardwerte, Schriftnamen-Syntax, die drei mitgelieferten Schriften, das Verhalten von baseline sowie die Extrusion mit linear_extrude wurden gegen die Seite „Text“ geprüft. Alle Codebeispiele dieser Lektion wurden mit OpenSCAD 2026.09.18 (lokale Installation) ausgeführt und liefen ohne Fehler und Warnungen. Nicht einzeln belegt: die Erklärungen in eigenen Worten, die Beispiele als solche (konstruiert) und die Wertungen.

Quellen

• OpenSCAD User Manual – Text (en.wikibooks.org/wiki/OpenSCAD_User_Manual/Text)
• OpenSCAD User Manual – 2D to 3D Extrusion (en.wikibooks.org/wiki/OpenSCAD_User_Manual/2D_to_3D_Extrusion)
• OpenSCAD Cheat Sheet (openscad.org/cheatsheet, bezieht sich auf Version 2021.01)