VersaGUI/doc/06_config_json.md

ConfigJson (Import / Export)

Datei: ConfigJson.cs

Format

Menschenlesbares JSON mit System.Text.Json (WriteIndented=true, Enums als Strings via JsonStringEnumConverter).

{
  "version": 3,
  "profile": 0,
  "buttons": [
    {
      "index": 0,
      "action": { "type": "HidKey", "data": 260 },
      "led": {
        "r": 80,
        "g": 40,
        "b": 0,
        "brightness": 255,
        "anim": "ColorCycle",
        "period_ms": 4000
      }
    },
    ...
  ],
  "encoders": [
    {
      "index": 0,
      "sw":  { "type": "None", "data": 0 },
      "cw":  { "type": "None", "data": 0 },
      "ccw": { "type": "None", "data": 0 }
    },
    ...
  ]
}

Serialisierung

ConfigJson.Serialize(cfg) → JSON-String. Exportiert alle 20 Buttons und vier Encoder des aktuell aktiven Profils vollständig, einschließlich Per-LED-Helligkeit.

Deserialisierung

ConfigJson.Deserialize(json, cfg):

• Prüft version – wirft InvalidDataException bei Mismatch
• prüft und übernimmt profile im Bereich 0..2
• validiert Actions, LED-Enums und die Mindestperiode für Pulse
• Schreibt in bestehendes DeviceConfig-Objekt (kein new)
• Fehlende buttons/encoders-Arrays werden ignoriert (partial import möglich)
• Ungültige index-Werte werden übersprungen

Anmerkungen

• MacroTable wird nicht exportiert (kein JSON-Format für Makros definiert)
• globale Helligkeit und Encoder-Sensitivität werden nicht exportiert
• profile wählt das Zielprofil aus und macht es gleichzeitig zum aktiven Profil; die beiden anderen Profile bleiben unverändert
• data enthält den ushort-Wert direkt (für HidKey z.B. Keycode | (Modifier << 8))
• Die Datei ist kein Binärformat und kann manuell bearbeitet werden
• Ein ungültiger Wert wird vor dem Anwenden mit InvalidDataException abgelehnt