Dateiformat

Ein Plan ist eine JSON-Datei. Was darin steht.

Eine .clearline-Datei ist JSON-Text. Sie können sie lesen, vergleichen, in einer Versionsverwaltung führen und eigene Werkzeuge dafür schreiben. Das Format ist dasjenige, das die frühere Web-Version in plan.json gespeichert hat.

Alle Längen sind Millimeter. x zeigt nach rechts, y nach oben.

Oberste Ebene

Schlüssel Inhalt
version Formatversion, derzeit 1
name Name des Plans
units Anzeigeeinheit: mm, cm oder m
grid Fangraster in mm
defaults Stärke, Höhe und Trockenbau-Aufbau für neue Wände
nodes Ecken: id, x, y
walls Wände zwischen zwei Ecken
openings Türen und Fenster in Wänden
fixtures Objekte: Möbel, Sanitär, Küche, Elektrogeräte, Heizkörper
runs Leitungen und Rohre als Punktlisten
zones Fußbodenheizungszonen als Polygone
taps Zapfstellen
sketches Freihand-Striche
guides Hilfslinien
layers Sichtbarkeit und Sperre je Ebene

Eine Wand

{
  "id": "w-k3f9qa",
  "a": "c-1", "b": "c-2",
  "kind": "drywall",
  "anchor": "interior",
  "inside": 1,
  "thickness": 125,
  "height": 2500,
  "build": {
    "profile": 75,
    "layersInside": 2, "layersOutside": 2,
    "boardInside": "standard", "boardOutside": "moisture",
    "insulation": true
  }
}
  • a und b sind Kennungen von Ecken. Die Linie dazwischen ist die Skizze.
  • anchor sagt, welche Fläche die Skizze ist: interior, center oder exterior.
  • inside sagt, auf welcher Seite der Raum liegt: 1 links von a→b, -1 rechts.
  • build gibt es bei Trockenbau mit Aufbau; thickness ergibt sich dann daraus.

Eine Öffnung

{ "id": "door-1", "wallId": "w-k3f9qa", "kind": "door",
  "offset": 600, "width": 860, "height": 2100, "sill": 0,
  "hinge": "start", "swing": "in" }

offset ist der Abstand von Ecke a zur näheren Laibung. Eine Schiebetür in der Wand hat ein Objekt slide mit dem Blatt und der Taschenseite.

Ein Objekt

{ "id": "sofa-3-x1", "kind": "sofa-3",
  "x": 1500, "y": 900, "rotation": 1.5708,
  "w": 2200, "d": 950, "h": 800, "elevation": 0 }

rotation steht im Bogenmaß; 0 zeigt nach +x. Ein Objekt an einer Wand hat zusätzlich wallId und offset (seine Mitte entlang der Wand ab Ecke a). Steckdosen und Schalter haben electrical mit der Liste der Einsätze und der Ausrichtung.

Ein Skizzenstrich

{ "id": "ink-7", "color": "#e53935", "width": 30,
  "points": [0, 0, 1,  500, 0, 0.4,  1000, 400, 1] }

points ist eine flache Liste aus x, y und Druck (0 bis 1) je Punkt. width steht in mm im Plan. Die Farbe ink bedeutet die Zeichenfarbe des Plans.

Dateien lesen

Beim Öffnen repariert die App, was sie kann: Fehlende optionale Felder erhalten Vorgaben, eine Öffnung in einer fehlenden Wand entfällt, ein Objekt an einer fehlenden Wand wird frei stehend. Objektarten, die die App nicht kennt, werden weggelassen.

Um Pläne aus Skripten zu ändern, nehmen Sie besser das Kommandozeilenwerkzeug: Seine Befehle halten den Plan stimmig.