{
  "schemaVersion": 1,
  "id": "clay-planet",
  "version": "1.0.0",
  "status": "published",
  "kind": "background",
  "title": "A Planet Learns to Walk",
  "summary": "A thumbprinted terracotta planet grows two little boots and waddles across a pastel clay studio, in stop motion at 12 poses a second. Loops.",
  "description": "A terracotta planet with raised green continents, a rolled cloud and a worried little face grows two ochre boots, finds its balance and waddles across a pastel clay studio. The movement is stepped at 12 poses a second like real stop motion, and the surface carries fingerprint arcs, tool marks and hand-pressed brows. It ends back where it began, so the 8 seconds loop. The film has no settings.",
  "role": "Shader film (three.js): Handmade clay stop motion, a finished 8-second portrait film with no settings.",
  "collections": [
    "impossible-worlds",
    "hypnotic-loops"
  ],
  "tags": [
    "clay",
    "stop motion",
    "claymation",
    "planet",
    "character",
    "handmade",
    "cute",
    "walking",
    "earth",
    "plasticine",
    "fingerprints",
    "loop",
    "portrait film"
  ],
  "synonyms": [
    "clay planet animation",
    "claymation earth",
    "stop motion planet",
    "walking planet",
    "plasticine animation",
    "cute planet character"
  ],
  "useCases": [
    "A children's or family channel intro",
    "A playful science or geography explainer opener",
    "A looping character background for a kids' app"
  ],
  "featured": null,
  "publishedAt": "2026-10-10",
  "implementation": {
    "target": "three",
    "runtime": "browser",
    "language": "javascript",
    "module": "esm",
    "entry": "src/clay-planet.js",
    "exports": [
      {
        "name": "createClayPlanet",
        "signature": "createClayPlanet() => { 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/clay-planet.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": true,
      "cycleSeconds": 8,
      "method": "Every part of the film is a function of the time modulo its length, and every motion completes whole cycles, so the last frame meets the first."
    },
    "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, even studio light with a gentle shadow on the pastel table.",
    "timing": "The planet grows its boots, finds its balance and waddles across the frame; the motion is stepped at 12 poses a second, like stop motion.",
    "compatibleWith": [],
    "notes": [
      "The continents, clouds, fingerprints and tool marks are procedural surface detail, not image files.",
      "The stepping is deliberate: it is what makes the clay feel handmade.",
      "Every pixel is a function of the time alone, so frames can be rendered in any order."
    ]
  },
  "reuse": [
    "Kids' intro: the planet is on its feet from about 1.5 s and keeps walking to the end.",
    "Looping mascot: it ends back where it started, so it can repeat for any length.",
    "Earth Day or geography clip: a friendly Earth that needs no voice-over to read."
  ],
  "integration": {
    "newProject": "Create a WebGLRenderer on a canvas (no antialiasing), call createClayPlanet() once and film.setSize(width, height); then for each frame call film.update(timeInSeconds) and renderer.render(film.scene, film.camera).",
    "existingProject": "Copy src/clay-planet.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 20 ms a frame at 1080 by 1350 on an integrated Intel GPU (Iris Xe), and about 2 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.",
    "Its length is fixed at 8 seconds; repeat the loop to fill a longer clip."
  ],
  "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 “A Planet Learns to Walk”, 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."
    }
  ]
}