{
  "schemaVersion": 1,
  "id": "embroidered-dawn",
  "version": "1.0.0",
  "status": "published",
  "kind": "background",
  "title": "Threaded Dawn",
  "summary": "A needle stitches a morning in golden thread: a sun, layered green hills, wildflowers and an indigo swallow appear in a wooden embroidery hoop.",
  "description": "A silver needle draws a sunrise on linen in a maple embroidery hoop with a brass clasp. Golden floss builds a stitched sun, then layered green hills, tiny wildflowers and an indigo swallow. Every stitch is a raised, twisted thread that really extends in sequence and casts a small shadow on the weave, and the linen shows its warp and weft. It is a one-shot film that ends on the finished picture. The film has no settings.",
  "role": "Shader film (three.js): Embroidered textile, a finished 8-second portrait film with no settings.",
  "collections": [
    "impossible-worlds"
  ],
  "tags": [
    "embroidery",
    "textile",
    "stitching",
    "needle",
    "thread",
    "hoop",
    "craft",
    "handmade",
    "sunrise",
    "landscape",
    "linen",
    "swallow",
    "bird",
    "portrait film"
  ],
  "synonyms": [
    "embroidery animation",
    "stitching animation",
    "sewing a sunrise",
    "needle and thread",
    "cross stitch landscape",
    "hand embroidered morning"
  ],
  "useCases": [
    "A craft, haberdashery or handmade-goods brand intro",
    "A calm \"good morning\" or wellness video opener",
    "A textile or fashion studio showreel title"
  ],
  "featured": null,
  "publishedAt": "2026-10-10",
  "implementation": {
    "target": "three",
    "runtime": "browser",
    "language": "javascript",
    "module": "esm",
    "entry": "src/embroidered-dawn.js",
    "exports": [
      {
        "name": "createEmbroideredDawn",
        "signature": "createEmbroideredDawn() => { scene, camera, setSize(width, height), update(time), dispose() }",
        "description": "The film as one full-screen shader; render its scene with its camera straight to the canvas."
      }
    ],
    "reusable": [
      "src/embroidered-dawn.js"
    ],
    "demo": "demo.js",
    "harness": "index.html"
  },
  "dependencies": [
    {
      "id": "three",
      "version": "0.185.1",
      "reason": "Renderer and a full-screen shader material."
    },
    {
      "id": "apw-runtime",
      "version": "1.0.0",
      "scope": "demo",
      "reason": "Demo harness."
    }
  ],
  "params": [],
  "presets": [],
  "output": {
    "width": 1080,
    "height": 1350,
    "fps": 30,
    "durationSeconds": 8,
    "posterSeconds": 5.5,
    "alpha": false,
    "motion": "procedural",
    "loop": {
      "seamless": false,
      "method": "A one-shot film: it builds to a finished picture that holds to the last frame, so the end does not return to the start."
    },
    "seed": null
  },
  "composition": {
    "inputs": "The time in seconds, 0 to 8. The film has no other settings.",
    "outputs": "An opaque full-frame picture, already in display colours: render it straight to the canvas.",
    "coordinates": "Composed for a 4:5 portrait frame and measured by the frame height: in a wider frame the picture stays centred at full height and its background fills the sides; in a narrower one, such as 9:16, the sides are cropped.",
    "lighting": "Soft studio light on linen: every stitch is shaded and casts a small shadow on the weave.",
    "timing": "The needle moves across the hoop; the sun, hills, flowers and swallow are stitched in turn, each stitch extending as it is drawn.",
    "compatibleWith": [],
    "notes": [
      "The hoop has wood grain and a brass clasp; a silver needle and a loose golden thread move across the cloth.",
      "Played on repeat it cuts from the finished picture back to the empty hoop.",
      "Every pixel is a function of the time alone, so frames can be rendered in any order."
    ]
  },
  "reuse": [
    "Craft brand intro: the picture is complete by about 6.5 s; hold it and add your logo.",
    "Morning-routine opener: a gentle build that suits a slow voice-over.",
    "Slow reveal: the stitches grow in sequence, so it can be cut at any point for a partial picture."
  ],
  "integration": {
    "newProject": "Create a WebGLRenderer on a canvas (no antialiasing), call createEmbroideredDawn() once and film.setSize(width, height); then for each frame call film.update(timeInSeconds) and renderer.render(film.scene, film.camera).",
    "existingProject": "Copy src/embroidered-dawn.js, which needs only three. Render film.scene with film.camera into your own canvas or render target; the output is opaque and already in display colours, so use no tone mapping or colour conversion."
  },
  "performance": {
    "notes": "One full-screen fragment shader. About 9 ms a frame at 1080 by 1350 on an integrated Intel GPU (Iris Xe), and about 2 to 4 s a frame with software WebGL.",
    "limits": "Plays at 30 frames a second at full size on an integrated GPU."
  },
  "limitations": [
    "The film is finished: it has no settings. To change colours or timing, edit the shader.",
    "It is composed for a 4:5 portrait frame.",
    "The end does not return to the start, so repeating it is a hard cut."
  ],
  "license": {
    "spdx": "MIT",
    "notice": "Copyright (c) 2026 AI Pixel Wizard. Released under the MIT License. See LICENSE in this folder.",
    "thirdParty": []
  },
  "provenance": "From the owner's collection Twenty Impossible Worlds: the original GLSL ES 3.00 shader of the film “Threaded Dawn”, created with ChatGPT / Codex and used as published, wrapped for AI Pixel Wizard as a three.js full-screen shader in October 2026. The collection's synthesised soundtrack is not part of this ingredient.",
  "changelog": [
    {
      "version": "1.0.0",
      "date": "2026-10-10",
      "notes": "Initial release."
    }
  ]
}