Projekte

Ein Projekt enthält alles, was auf ein Gerät kommt: die Screens mit ihren Objekten, die Topics, die Icons und Bilder. Es gehört immer zu genau einem Gerätetyp.

Projekte liegen auf dem Rechner, auf dem der Designer läuft, wie Dateien in einem Ordner. Jedes hat einen Namen, und unter diesem Namen findest du es wieder, egal von welchem Browser aus du den Designer öffnest.

Ein neues Projekt

New Project... auf der Startseite, der Knopf New Project im Kopf der Projektliste oder File › New Project öffnen denselben Dialog in zwei Schritten.

Zuerst wählst du das Gerät:

• Server DDFs: die Geräte, die der Designer mitbringt.
• Announced Devices: Geräte, die sich gerade beim Broker melden, auch Android-Handys.
• Geräte, die sich früher gemeldet haben und gerade nicht online sind, blendet ein Link darunter ein.

Ein Klick wählt ein Gerät, Next führt weiter. Ein Doppelklick erledigt beides.

Dann gibst du dem Projekt einen Namen. Create Project speichert es und öffnet es im Editor. Ist der Name schon vergeben, sagt der Dialog das und legt nichts an. Back führt zurück zur Geräteauswahl.

Ein neues Projekt hat einen Master-Screen «Master 1» mit dem Theme Lavender und einen Screen «Screen 1», der diesen Master verwendet. Grösse, Farbtiefe, Schriften und Gerätrahmen kommen vom Gerät.

Über das Feld Add in der Geräteauswahl fügst du ein Gerät hinzu, dessen Beschreibung (eine .ddf.zip-Datei) im Internet liegt.

Namen

Der Name ist das, woran der Designer ein Projekt erkennt. Er darf bis zu 80 Zeichen lang sein. Nicht erlaubt sind / \ : * ? " < > |, ein Punkt am Ende und Namen, die Windows für sich reserviert, etwa CON oder NUL. Gross- und Kleinschreibung zählt nicht: «Van Knob» und «van knob» sind dasselbe Projekt.

Der Name steht oben neben «Schaltli» und in der Adresse des Browsers, etwa …/projects/Van%20Knob. Diese Adresse kannst du als Lesezeichen ablegen, und Neuladen bleibt im Projekt.

Speichern

Der Designer speichert nur, wenn du es sagst:

• File › Save oder Strg+S speichert das Projekt unter seinem Namen.
• File › Save As... oder Strg+Shift+S speichert es unter einem anderen Namen. Danach arbeitest du unter dem neuen weiter, das alte Projekt bleibt, wie es war.

Solange etwas nicht gespeichert ist, steht ein Punkt vor dem Namen, oben und im Tab des Browsers. Machst du mit Rückgängig alles bis zum gespeicherten Stand zurück, verschwindet er wieder.

Hat ein Projekt noch keinen Namen, etwa eine hochgeladene Datei, heisst es «Untitled». Das erste Speichern öffnet dann den Dialog Save Project. Er zeigt die Projekte, die es schon gibt, und ein Feld für den Namen. Wählst du ein bestehendes Projekt, fragt er nach: Replace macht dein Projekt zur neuesten Version des gewählten. Dessen frühere Versionen bleiben erhalten, siehe Versionen.

Jedes Speichern legt eine neue Version an. Auch jede Übertragung auf ein Gerät speichert vorher.

Verlässt du ein Projekt mit ungespeicherten Änderungen, fragt der Designer Save changes to …, mit Save, Don't Save und Cancel. Das gilt, wenn du ein anderes Projekt öffnest, ein neues anlegst oder eine Datei hochlädst. Schliesst oder lädst du den Tab neu, warnt der Browser selbst.

Projekte öffnen, umbenennen, löschen

Links neben den Screens steht die Liste Projects, dieselbe Liste zeigt auch die Startseite. Jedes Projekt steht dort mit Gerät, Zeitpunkt des letzten Speicherns und, falls schon übertragen, mit dem Gerät, auf dem es läuft. Das offene Projekt ist hervorgehoben.

• Ein Klick öffnet ein Projekt, immer in seiner neuesten Version.
• Rename im Menü des Eintrags macht den Namen direkt in der Liste bearbeitbar. Enter bestätigt, Esc bricht ab. Mit F2 geht es ebenso, wenn der Eintrag den Fokus hat. Die Versionen und die Zuordnung zum Gerät bleiben beim Umbenennen erhalten.
• Delete im Menü löscht ein Projekt mit allen seinen Versionen. Vorher fragt der Designer nach und sagt, wie viele Versionen wegfallen. Das Häkchen Download latest version as a backup ist gesetzt: Die neueste Version landet dann als Projektdatei in deinen Downloads, bevor gelöscht wird. Nimm es weg, wenn du nur aufräumst. Das offene Projekt lässt sich nicht löschen, öffne vorher ein anderes. Die Taste Entf löscht in der Liste nichts.

Das Menü öffnet sich über die drei Punkte, die beim Überfahren eines Eintrags erscheinen, oder mit einem Rechtsklick.

Das Symbol ganz rechts im Kopf der Liste klappt sie zu einem schmalen Streifen ein. Das hilft, wenn der Platz für grosse Screens knapp wird. Der Browser merkt sich, ob sie eingeklappt ist.

Löschen lässt sich nicht rückgängig machen

Ein gelöschtes Projekt ist mit allen Versionen weg, Rückgängig holt es nicht zurück. Geblieben ist dann nur die Datei aus dem Backup, falls das Häkchen gesetzt war. Mit Upload Project öffnest du sie wieder.

Als Datei sichern und öffnen

• File › Download Project lädt das Projekt als <Name>_project.zip herunter, mit allen Icons und Bildern und der Beschreibung des Geräts. Das ist die Datei zum Aufbewahren und Weitergeben.
• File › Upload Project öffnet so eine Datei wieder, auf der Startseite geht das über Choose File.... Eine hochgeladene Datei ist ein Projekt ohne Namen. Speicherst du sie, schlägt der Dialog den Namen aus der Datei vor. Gibt es den schon, fragt er, ob du ersetzen willst.
• File › Export Project lädt das Projekt in dem Format herunter, das ein Gerät liest. Das brauchst du nur, um ein Gerät von Hand zu bespielen. Zum Aufbewahren nimm Download Project.

Projekteinstellungen

Settings öffnet Project Settings mit diesen Bereichen:

Bereich	was du dort findest
Project Properties	den Namen des Projekts (nur zum Lesen), die Grösse der Screens (vom Gerät vorgegeben) und das Zahlenformat der Platzhalter
Device	das Gerät und seine Drehung (Rotation), falls es sich drehen lässt
Screens	alle Screens in einer Liste: umbenennen, ordnen, Master zuweisen, löschen
Assets	alle Icons und Bilder des Projekts, siehe Icons und Schriften
Fonts	die Schriften des Geräts, mit Vorschau
Adornment	den Gerätrahmen
Snap Grid	Hilfslinien, an denen Objekte beim Verschieben einrasten
Topics	die MQTT-Topics, siehe MQTT-Topics

Unter Device kannst du dem Projekt auch ein anderes Gerät geben (Load Device). Grösse, Farbtiefe, Rahmen, Tasten und Schriften kommen dann vom neuen Gerät. Deine Objekte bleiben, wo sie sind, und können danach ausserhalb des Screens liegen. Texte mit einem Stil bekommen die passende Schrift des neuen Geräts: Ein Label bleibt ein Label, nur in dessen Schrift. Texte mit einer von Hand gewählten Schrift («Custom») behalten ihre. Objekttypen, die das neue Gerät nicht kann, markiert der Designer mit einem orangen gestrichelten Rahmen. Speicherst du danach, läuft die Versionsgeschichte unter demselben Namen weiter.

Die Drehung unter Rotation sagt, wie das Gerät eingebaut ist. Bei 90 und 270 Grad tauschen Breite und Höhe.

Das Häkchen «Hardware supports Software Buttons» unter Project Properties setzt der Designer beim Anlegen passend zum Gerät. Es blendet nur den Bereich für Wischgesten in den Screen-Eigenschaften ein; lass es, wie es ist.

Den Namen änderst du nicht hier, sondern über Rename in der Projektliste oder mit Save As....

Number format bestimmt, wie Platzhalter wie {topic:…:N2} Zahlen schreiben. Zur Wahl stehen Switzerland (12'345.68, der Standard), Germany (12.345,68), Austria (12 345,68) und English (12,345.68). Unter Custom trägst du Dezimal- und Tausendertrennzeichen selbst ein. Das Tausendertrennzeichen darf leer bleiben, die beiden Zeichen müssen sich aber unterscheiden.