Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- 3d_druck:mll-masken-generator [2026/06/28 08:15] – oliwel
+++ 3d_druck:mll-masken-generator [2026/09/18 10:22] (aktuell) – [MobaLedLib Lichtmasken-Generator] oliwel
@@ Zeile 1: / Zeile 1: @@
 ====== MobaLedLib Lichtmasken-Generator ======
-Der [[https://3d-haus.mobaledlib.net/|MLL Lichtmasken Generator (https://3d-haus.mobaledlib.net/)]] erzeugt aus einer einfachen Text-Konfiguration eine druckfertige
+Der [[https://3d-haus.mobaledlib.net/|MLL Lichtmasken Generator (https://3d-haus.mobaledlib.net/)]] erzeugt aus einer einfachen Text-Konfiguration eine druckfertige §D-Lichtmaske (STL) für Modellgebäude. Die Maske wird von innen in das Gebäude
-D-Lichtmaske (STL) für Modellgebäude. Die Maske wird von innen in das Gebäude eingesetzt, trennt die Räume lichtdicht voneinander und kann zusammen mit der Hausplatine (296) genutzt werden. Es ist natürlich auch möglich die LEDs manuell einzubauen. Diese Anleitung beschreibt Schritt für Schritt wie eine Konfiguration aufgebaut wird, beim Modellhaus handelt es sich um das //Einfamilienhaus mit Garage (Auhagen 11454)//.
+eingesetzt, trennt die Räume lichtdicht voneinander und nimmt die Hausplatine auf.
 {{bilder:3d_druck:3dhaeuser:screenshot_maskengenerator.png|Screenshot des Generators}}
-{{:bilder:3d_druck:3dhaeuser:img_20260604_222711948.jpg?400 |}} {{:bilder:3d_druck:3dhaeuser:img_20260610_091018941.jpg?400}}
+{{:bilder:3d_druck:3dhaeuser:img_20260604_222711948.jpg?400 |}}{{:bilder:3d_druck:3dhaeuser:img_20260610_091018941.jpg?400}}
+Diese Anleitung beschreibt **Schritt für Schritt, wie eine Konfiguration aufgebaut wird**.
 ----
@@ Zeile 24: / Zeile 25: @@
 ===== Vorbereitung =====
-  - Stelle dein Modellhaus auf ein Blatt kariertes Papier und übertrage die Aussenmaße auf das Papier.
+  - Stelle dein Modellhaus auf ein Blatt karriertes Papier und übertrage die Aussenmaße auf das Papier.
   - Markiere alle Fenster und Türen durch einen dicken Strich auf der Wandlinie.
   - Messe für jedes Fenster den Abstand zur linken Hausecke und vom "Boden" sowie Breite und Höhe der Öffnung, schreibe die vier Zahlen an den Strich.
@@ Zeile 30: / Zeile 31: @@
   - Überlege dir die Position der Wände und skizziere Sie auf dem Papier.
   - Finde eine geeignete Position für die Lichtplatine.
-Die Grundlagen für das Ausmessen der Fenster und der Vorbereitung des Hauses findet ihr auch im [[.:anleitungen:haustrennwaende-teil1|Artikel zur Trennwanderstellung]].
 ----
@@ Zeile 47: / Zeile 46: @@
   * Werte werden durch **Komma** getrennt.
-  * **Alle Maße in Millimetern.** Nachkommastellen mit Punkt schreiben (''2.5'', nicht ''2,5'').
+  * **Alle Maße in Millimetern.** Nachkommastellen mit Punkt schreiben (''2.5'', nicht ''2,5''). Jeder einzelne Wert muss zwischen ''-9999'' und ''9999'' liegen.
-  * Die Reihenfolge der Abschnitte ist frei wählbar.
+  * Die Reihenfolge der Abschnitte ist frei wählbar. Einzige Ausnahme: der Fenster-Abschnitt einer benannten Wand muss **nach** der ''wand''-Zeile stehen, die den Namen vergibt.
   * Mit ''#'' beginnt ein **Kommentar** – sowohl als ganze Zeile als auch am Zeilenende:
@@ Zeile 99: / Zeile 98: @@
 ^ Werte ^ Bedeutung ^
 | ''2.5'' | gleicher Offset auf **allen vier Seiten** |
-| ''2.5,1'' | erste Zahl = **vorne & hinten**, zweite = **links & rechts** |
+| ''2.5,1'' | wie die Maßzeile: erste Zahl = **Breite** (links & rechts), zweite = **Tiefe** (vorne & hinten) |
 | ''2,1,2,1'' | je Seite einzeln: **vorne, rechts, hinten, links** |
+<WRAP info>Die Reihenfolge unterscheidet sich zwischen den beiden Formen. Mit
+**zwei** Werten zählt die Zeile **Achsen** wie die Maßzeile: ''Breite, Tiefe''.
+Mit **vier** Werten zählt sie **Seiten** reihum ab vorne:
+''vorne, rechts, hinten, links''. Die vier Seiten einzeln zu setzen heißt also
+nicht, einfach zwei Werte anzuhängen – ''2,1'' entspricht ''1,2,1,2''.</WRAP>
 <code>
@@ Zeile 107: / Zeile 112: @@
 .5
 </code>
+==== Dritte Zeile – Stockwerk (''G<n>''), optional ====
+Werden mehrere Räume übereinander gestapelt, bekommt der ''raum''-Abschnitt eine
+eigene Zeile ''G<n>'' mit der Stockwerksnummer (''G0'' = Erdgeschoss, einstellig).
+Sie gilt für den ganzen Raum und setzt automatisch:
+  * jedes **ungerade** Stockwerk dreht alle Platinen um 180°, damit die Anschlüsse abwechselnd liegen,
+  * die Ziffer wird in die **vordere rechte Ecke** des Dachs graviert, sodass am gedruckten Teil ablesbar ist, zu welchem Stockwerk es gehört,
+  * an den vier **Innenecken der Außenwände** kommt je eine Aussparung im Dach; ab ''G1'' sitzt an denselben Ecken unten ein passender Zapfen. Aufeinandergesetzt rasten die Räume darüber ineinander ein. An einer Ecke, an der beide angrenzenden Außenwände fehlen (Wand ohne Öffnungen), entfällt der Zapfen.
+Die Ecken liegen **innen an den Wänden**, die Außenkontur der Maske bleibt also
+unberührt und beim Einschieben ins Haus setzt nichts auf. Drei Ecken sind
+Quadrate mit 2 mm Kantenlänge, die Ecke **vorne links** ist ein Viertelkreis mit
+mm Radius – damit passen gestapelte Räume nur in einer Drehlage zusammen.
+Die Offset-Zeile darf fehlen, ''G<n>'' steht dann direkt unter den Außenmaßen.
+<code>
+raum
+,78,35
+.5
+G1
+</code>
+<WRAP alert>''G<n>'' setzt **nicht** die Anschlussart der Platine. ''idc'' bzw.
+''stack'' gehören immer explizit in die Datenzeile des ''licht''-Abschnitts.</WRAP>
 ----
@@ Zeile 113: / Zeile 145: @@
 Der ''licht''-Abschnitt bestimmt, wo die Platine sitzt. Die Platinenaufnahme hat ein
-festes Format von **41 × 36 mm** und muss mit etwas Abstand vollständig innerhalb
+festes Format von **41 × 36 mm** und muss mit mindestens **2 mm** Abstand
-der Maske liegen.
+vollständig innerhalb der Maske liegen.
-**Format:** Mitte-X, Mitte-Y [, Rotation] [, Schalter]
+**Format:** Mitte-X, Mitte-Y [, Rotation] [, Schalter] [, Anschluss]
   * ''Mitte-X, Mitte-Y'' = Koordinaten des **Platinenmittelpunkts** (vom Ursprung vorne links).
-  * ''Rotation'' (optional) = Drehung in Grad: ''90'', ''180'', ''-90''.
+  * ''Rotation'' (optional) = Drehung in Grad: ''90'', ''180'', ''-90''. Ohne Angabe setzt die Stockwerkszeile ''G<n>'' des ''raum''-Abschnitts die Drehung.
   * ''Schalter'' (optional) = Position des Schalterausschnitts: ''weiter'' oder ''ende''.
+  * ''Anschluss'' (optional) = Schlüsselwort: ''idc'' druckt die IDC-Buchse mit, ''stack'' nur die Führung für die Platinenverbinder. Ohne Schlüsselwort bleibt der Tunnel offen; ''G<n>'' setzt die Anschlussart **nicht**.
+Werden beide Schlüsselwörter angegeben, steht ''Schalter'' **vor** ''Anschluss'':
+''41,40,ende,idc'' ist gültig, ''41,40,idc,ende'' nicht.
 <code>
 licht
-,40,ende
+,40,ende,idc
 </code>
@@ Zeile 170: / Zeile 206: @@
 in der Zeile stehen:
-  * **Eine Zahl** → automatische Trennwand: Die Zahl ist die **Position** entlang der Wand. Die Trennwand wächst von der Außenwand nach innen bis zum Dachausschnitt der Platine. Die Lücke zwischen der Wand und der Stützwand der Platine wird entlang der Dachkante automatisch geschlossen.
+  * **Eine Zahl** → automatische Trennwand: Die Zahl ist die **Position** entlang der Wand. Die Trennwand wächst von der Außenwand nach innen bis zum Dachausschnitt der Platine. Die Lücke zwischen der Wand und der Stützwand der Platine wird entlang der Dachkante automatisch geschlossen. Sind mehrere Platinen definiert, läuft die Wand zu der Platine, deren Mitte ihrem Ansatzpunkt an der Außenwand am nächsten liegt.
   * **Zwei Zahlen** (''Position, Länge'') → Trennwand mit **fester Länge**, es findet keine automatische Verbindung mit der Stützstruktur statt.
 <code>
 hinten
-,4,22.5,26     ← Fenster (4 Werte)
+,4,22.5,26     # Fenster (4 Werte)
-.5,4,22.5,26   ← Fenster (4 Werte)
+.5,4,22.5,26   # Fenster (4 Werte)
-               ← automatische Trennwand bei Position 42
+               # automatische Trennwand bei Position 42
 </code>
@@ Zeile 190: / Zeile 226: @@
 zu Punkt.
-**Format:** x1, y1, x2, y2 [, x3, y3, …] (2 bis 10 Punkte)
+**Format:** x1, y1, x2, y2 [, x3, y3, …] (mindestens 2 Punkte, nach oben offen)
+Ein ''wand''-Abschnitt nimmt beliebig viele solcher Zeilen auf; jede ist eine
+**eigenständige** Wand.
 <code>
 wand
-,0,41,25,66,25,66,0
+,0,41,25,66,25,66,0    # ein Linienzug über drei Segmente
+,0,27,22               # davon unabhängige zweite Wand
 </code>
+**Linienzug über mehrere Zeilen:** Trägt eine Zeile nur **ein** Koordinatenpaar,
+verlängert sie die zuletzt begonnene Wand um diesen Punkt – unabhängig davon, wie
+viele Punkte deren vorige Zeile hatte. Eine Zeile mit **zwei oder mehr** Paaren
+beginnt dagegen immer eine neue Wand.
+<code>
+wand
+,10               # eine Wand
+,20               # über zwei
+,30               # Segmente
+,40,50,50         # neue Wand …
+,20               # … um einen Punkt verlängert
+</code>
+<WRAP alert>Ein einzelnes Koordinatenpaar, das nichts fortsetzt und selbst nicht
+fortgesetzt wird, ergibt kein Segment und wird als Fehler gemeldet.</WRAP>
 Auch hier messen negative Koordinaten von der rechten bzw. hinteren Raumkante.
 Die Wände können anhand der Außenmaße gesetzt werden, der Generator beschneidet
 die Länge automatisch an der Außenhülle der Maske.
+==== Fenster in einer freien Wand ====
+Ein einzelnes **gerades** Segment eines Linienzugs lässt sich benennen und bekommt
+dann eigene Fenster – wie eine Außenwand. Der Name ist ein beliebiges Wort, das
+hinter dem **Startpunkt** des Segments steht; das Segment endet am nächsten Punkt.
+**Format:** x1, y1, name, x2, y2 – oder zweizeilig, mit dem Endpunkt in der Folgezeile:
+<code>
+wand
+,10,flur
+,50
+</code>
+Der Name wird anschließend zum **Abschnitts-Schlüsselwort** für die Öffnungen. Sie
+werden wie bei den Außenwänden angegeben, der Abstand misst dabei ab dem
+Startpunkt der Wand (x1, y1):
+<code>
+flur
+,0,8,12
+,4,6,8
+</code>
+  * Der Name darf kein reserviertes Schlüsselwort sein (''raum'', ''wand'', ''vorne'', …) und nicht zweimal vergeben werden.
+  * Der Fenster-Abschnitt muss **nach** der ''wand''-Zeile stehen, die den Namen vergibt – sonst ist der Name noch unbekannt und die Datei wird abgewiesen.
+  * Benannt wird immer nur **ein** Segment, nicht der ganze Linienzug. Ein Linienzug kann mehrere benannte Segmente enthalten.
+  * Ohne zugehörigen Fenster-Abschnitt bleibt das Segment eine normale freie Wand.
+  * Anders als bei den Außenwänden ist der Abstand hier immer positiv; negative Werte werden nicht von der Gegenecke gemessen, sondern abgewiesen.
 ----
@@ Zeile 210: / Zeile 297: @@
 ^ Zeile ^ Bedeutung ^
-| Musterhaus | Text, automatisch platziert |
+| Musterhaus | Text, automatisch platziert: 3 mm/3 mm von der vorderen linken Ecke des **Druckkörpers**, wandert also mit dem Offset |
 | 20,30,Musterhaus | Text an Position ''X,Y'' |
 | 20,30,90,Musterhaus | Text an Position ''X,Y'' mit Drehung in Grad |
@@ Zeile 218: / Zeile 305: @@
 Musterhaus
 </code>
+Zwei Einschränkungen ergeben sich aus dem CSV-Format: Der Text darf **kein Komma**
+enthalten (es trennt die Felder), und er darf nicht genauso heißen wie ein
+Abschnitts-Schlüsselwort oder eine benannte Wand – ein solches Wort beendet den
+''text''-Abschnitt, statt als Beschriftung zu gelten.
+----
 ===== Optional – Dachöffnungen (''dach'') =====
@@ Zeile 223: / Zeile 317: @@
 Zusätzliche Öffnungen in der Dachfläche, z. B. für Dachfenster oder zum Einbau weiterer LEDs von oben.
-**Format:** ''X, Y, Breite, Tiefe'' (Ursprung vorne links)
+**Format:**
+  * ''X, Y, Breite, Tiefe'' – rechteckiger Ausschnitt (Ecke bei X,Y, Ursprung vorne links)
+  * ''X, Y, <LED-Typ>'' – Öffnung passend zu einem LED-Typ (Mitte bei X,Y); die Geometrie wird wie in der Lichtbox erzeugt. Anstelle der Ausschnitt-Masse wird der Name des LED-Typs angegeben: ''none'' (auch ''keine''), ''3mm'', ''5mm'', ''plcc6'', ''plcc2'', ''ws2812''.
 <code>
 dach
 ,10,5,5
+,40,ws2812
 </code>
@@ Zeile 246: / Zeile 343: @@
 aussen,1.0
 dach,1.2
+</code>
+----
+===== Lichtbox-Modus (''box'') =====
+Statt einer kompletten Hausmaske (''raum'') lässt sich auch eine einzelne
+**Lichtbox** erzeugen – ein kleiner Kasten, der über eine LED gestülpt wird und
+das Licht gerichtet abgibt. Sobald das Schlüsselwort ''box'' verwendet wird,
+schaltet der Generator auf den Lichtbox-Renderer (''lightbox.scad'') um;
+''box'' und ''raum'' schließen sich gegenseitig aus.
+**Erste Zeile – Außenmaße (Pflicht):** Breite, Höhe, Tiefe
+<code>
+box
+,25,15
+</code>
+==== LED-Öffnungen (''oben'', ''links'', ''rechts'') ====
+Die Schlüsselwörter ''oben'', ''links'' und ''rechts'' setzen je eine (oder
+mehrere) LED-Öffnung auf die entsprechende Fläche. Jede Öffnung ist eine eigene
+Zeile, die mit dem **LED-Typ** beginnt:
+^ LED-Typ ^ Bedeutung ^
+| ''none'' (auch ''keine'') | keine Öffnung |
+| ''3mm'' | durchgehende Bohrung 3 mm |
+| ''5mm'' | durchgehende Bohrung 5 mm |
+| ''plcc6'' | PLCC6 (innen 4 mm, außen 6×6 mm) |
+| ''plcc2'' | PLCC2 (innen 3 mm, außen 4×3 mm) |
+| ''ws2812'' | innen 6×6 mm, außen 15 mm |
+**Format:** ''<typ> [, <clip>] [, offset_breite [, offset_tiefe]]''
+  * Nur ''<typ>'' → LED **mittig** auf der Fläche.
+  * ''<clip>'' (optional, 2. Argument) → Halteclip: ''ohne'', ''einfach'' oder ''doppel''. Standard ist ''ohne'' und kann weggelassen werden.
+  * ''offset_breite'' → Verschiebung **entlang der Vorderkante** der Fläche.
+  * ''offset_tiefe'' → zusätzliche Verschiebung **in Tiefenrichtung (Z)**.
+Die Offsets messen von der **Flächenmitte** aus und dürfen der Kante nicht näher
+als **5 mm** kommen.
+<code>
+box
+,25,15
+oben
+plcc6, doppel
+links
+ws2812, 4
+rechts
+plcc2, einfach, 4, -2
 </code>
@@ Zeile 254: / Zeile 403: @@
 <code>
 licht
-,40,ende
+,40,ende,idc
 raum
 ,78,35
@@ Zeile 281: / Zeile 430: @@
 Musterhaus
 </code>
+----
+===== Anhang – Generator starten =====
+Der Generator ist ein kleiner Webserver, der OpenSCAD zum Rendern aufruft. Beides
+muss lokal installiert sein.
+<code>
+python3 server.py
+</code>
+Danach ist die Oberfläche unter **http://localhost:8080** erreichbar. Sie lädt die
+Vorschau über ''POST /preview'' und liefert die Downloads über ''POST /'' (STL) und
+''POST /export3mf'' (3MF).
+Ohne Oberfläche lässt sich eine Konfiguration auch direkt übersetzen – die Ausgabe
+ist das Datenfile, das ''house_mask.scad'' einliest:
+<code>
+python3 server.py --parse meine_maske.csv > house_data.scad
+</code>
+Mit ''--debug'' schreibt der Server zusätzlich das Datenfile jeder Anfrage auf die
+Konsole – hilfreich, um nachzusehen, was aus einer Konfiguration tatsächlich
+geworden ist.

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge