Flaw overlays guide

Overlay format

Use an array of annotation objects with normalized values from 0–1 for x, y,width, and height.

[
  {
    "id": "flaw-1",
    "x": 0.18,
    "y": 0.34,
    "width": 0.16,
    "height": 0.12,
    "label": "small weave skip",
    "severity": "minor"
  }
]

Best practices

• Use plain-language labels such as “loom slub” or “oil spot”.
• Keep boxes tight around the flaw, not around the whole image.
• Use one overlay per discrete flaw whenever possible.
• Match overlays to a dedicated flaw photo if available.