Format sceny 1.0

Struktura dokumentu#

Scena to obiekt JSON z version, document, objects oraz opcjonalnymi gradients i layers. Nieznane właściwości są odrzucane ze strukturalnymi błędami schemy.

{
  "version": "1.0",
  "document": {
    "width": 1200,
    "height": 800,
    "unit": "px",
    "background": "#FFFFFF"
  },
  "objects": [],
  "gradients": [],
  "layers": []
}

Kanoniczna schema: schemas/vector-scene.schema.json.

Document#

Kolory i paint#

Kolory akceptują:

• #RGB, #RGBA, #RRGGBB, #RRGGBBAA,
• none,
• url(#gradientId) — referencja do gradientu.

{ "fill": "#0052FF", "stroke": "#17171780", "opacity": 0.9 }

Wspólne właściwości obiektów#

Transformacje#

{
  "transform": {
    "translateX": 100,
    "translateY": 50,
    "rotate": 45,
    "scaleX": 1.5,
    "scaleY": 1.5,
    "skewX": 0,
    "skewY": 0,
    "originX": 200,
    "originY": 200
  }
}

Transformacje są afiniczne i składane w kolejności: translate → rotate → scale → skew, wokół punktu originX/originY. Grupy dziedziczą transformacje rodziców.

Workspaces#

Nazwane prostokątne regiony eksportu:

{
  "workspaces": [
    { "id": "social", "name": "Social card", "x": 0, "y": 0, "width": 1200, "height": 630 },
    { "id": "icon", "x": 0, "y": 0, "width": 512, "height": 512 }
  ]
}

Eksport może celować w workspace zamiast całej sceny — patrz Proces eksportu.

Walidacja#

Walidacja jest dwuetapowa:

1. Strukturalna — Ajv Draft 2020-12 + parser JSON C++23.
2. Semantyczna — unikalne ID, warstwy, workspaces, gradienty, limity pamięci.

Błędy są strukturalne i wskazują konkretne pole:

{
  "code": "invalid.color",
  "path": "/objects/2/fill",
  "message": "Expected hex color, none, or url(#id)"
}

Limity#