{
  "schemaVersion": 1,
  "id": "cymbal-crash",
  "version": "1.0.0",
  "status": "published",
  "kind": "object",
  "title": "Cymbal Crash",
  "summary": "A brass cymbal struck by a drumstick: the metal ripples in vibration modes and rings down to stillness. Loops perfectly.",
  "description": "A brass cymbal on a stand in studio light, struck once per loop by a drumstick. Its rim ripples in the lobed patterns of real vibration modes (two, three, four and five lobes around the edge and a rippling bowl), each oscillating a whole number of times per loop while the whole ring fades to nothing before the next strike. Choose the metal (brass, bronze or silver), how violently it rings, the pitch of the vibration, the backdrop colour and whether the camera sways.",
  "role": "Object (3D, three.js): a musical, rhythmic showpiece that makes impact and sound visible.",
  "collections": [
    "satisfying",
    "chrome-glass",
    "hypnotic-loops"
  ],
  "tags": [
    "cymbal",
    "drum",
    "percussion",
    "vibration",
    "metal",
    "brass",
    "music",
    "ring",
    "sound",
    "studio",
    "loop",
    "3d"
  ],
  "synonyms": [
    "crash cymbal",
    "drum kit",
    "percussion hit",
    "vibrating plate",
    "metal ring",
    "drum strike"
  ],
  "useCases": [
    "A music, band or drum lesson title scene",
    "A rhythm or beat-drop moment",
    "A demonstration of vibration modes"
  ],
  "featured": null,
  "publishedAt": "2026-10-06",
  "implementation": {
    "target": "three",
    "runtime": "browser",
    "language": "javascript",
    "module": "esm",
    "entry": "src/cymbal-crash.js",
    "exports": [
      {
        "name": "createCymbal",
        "signature": "createCymbal({ metal?, ring?, speed? }) => { group, setProgress(progress), dispose() }",
        "description": "The cymbal with its stand and drumstick as a group of radius 3; the strike lands at progress 0.5; needs an environment map."
      },
      {
        "name": "METALS",
        "signature": "METALS: { brass, bronze, silver }",
        "description": "Metal finishes with colour and roughness."
      }
    ],
    "reusable": [
      "src/cymbal-crash.js"
    ],
    "demo": "demo.js",
    "harness": "index.html"
  },
  "dependencies": [
    {
      "id": "three",
      "version": "0.185.1",
      "reason": "Renderer, geometry and shader materials."
    },
    {
      "id": "chrome-material",
      "version": "1.1.0",
      "scope": "demo",
      "reason": "Studio environment light, backdrop and contact shadow."
    },
    {
      "id": "apw-runtime",
      "version": "1.0.0",
      "scope": "demo",
      "reason": "Demo harness."
    }
  ],
  "params": [
    {
      "key": "metal",
      "label": "Metal",
      "type": "select",
      "default": "brass",
      "options": [
        {
          "value": "brass",
          "label": "Brass"
        },
        {
          "value": "bronze",
          "label": "Bronze"
        },
        {
          "value": "silver",
          "label": "Silver"
        }
      ]
    },
    {
      "key": "ring",
      "label": "Ring strength",
      "type": "number",
      "min": 0.2,
      "max": 2,
      "step": 0.1,
      "default": 1
    },
    {
      "key": "pitch",
      "label": "Pitch",
      "help": "Multiplies the vibration frequencies.",
      "type": "integer",
      "min": 1,
      "max": 3,
      "step": 1,
      "default": 1
    },
    {
      "key": "background",
      "label": "Backdrop",
      "type": "color",
      "default": "#14151f"
    },
    {
      "key": "orbit",
      "label": "Camera sway",
      "type": "boolean",
      "default": true
    }
  ],
  "presets": [
    {
      "id": "default",
      "label": "Brass, one strike",
      "params": {}
    },
    {
      "id": "silver",
      "label": "Silver, soft ring",
      "params": {
        "metal": "silver",
        "ring": 0.6,
        "background": "#101c2c"
      }
    },
    {
      "id": "bronze",
      "label": "Bronze, high pitch",
      "params": {
        "metal": "bronze",
        "pitch": 2,
        "background": "#241812"
      }
    },
    {
      "id": "crash",
      "label": "Violent crash",
      "params": {
        "ring": 2,
        "pitch": 3
      }
    }
  ],
  "output": {
    "width": 1080,
    "height": 1080,
    "fps": 30,
    "durationSeconds": 10,
    "posterSeconds": 5.4,
    "alpha": false,
    "motion": "procedural",
    "loop": {
      "seamless": true,
      "cycleSeconds": 10,
      "method": "The strike lands halfway through the loop; each vibration mode oscillates a whole number of times in the time since the strike and the ring-down envelope fades to zero before the next strike, so the last frame meets the first."
    },
    "seed": null
  },
  "composition": {
    "inputs": "Time within the loop; the metal, ring strength, pitch, backdrop and camera sway.",
    "outputs": "A full frame rendered in 3D with a studio environment.",
    "coordinates": "The cymbal is centred on the origin with radius 3, lying nearly flat (tilted 0.28 rad towards the camera); the stick strikes at (1.9, ·, 0.7).",
    "lighting": "A warm key light with a shadow map and the studio environment.",
    "timing": "setProgress(progress) rewrites the surface from a closed form; frames render in any order.",
    "compatibleWith": [
      "chrome-material",
      "orbit-camera",
      "kinetic-title",
      "number-reveal"
    ],
    "notes": [
      "Vertices are rewritten on the CPU each frame (about 9 000) and normals recomputed."
    ]
  },
  "reuse": [
    "Music title: Brass, one strike.",
    "Soft intro: Silver, soft ring.",
    "Beat drop: Violent crash."
  ],
  "integration": {
    "newProject": "Create a WebGLRenderer with a studio environment, add createCymbal().group and call cymbal.setProgress(progress) each frame.",
    "existingProject": "Copy src/cymbal-crash.js; add the group to your scene with an environment map and a shadow-casting light."
  },
  "performance": {
    "notes": "About 9 000 vertices rewritten and re-normalised each frame, a shadow map: a couple of milliseconds a frame on an integrated Intel GPU.",
    "limits": "Software WebGL renders in about a second a frame."
  },
  "limitations": [
    "The vibration is a closed-form sum of modes, not a physical simulation.",
    "The stick pivots about its tip and does not bounce off the metal."
  ],
  "license": {
    "spdx": "MIT",
    "notice": "Copyright (c) 2026 AI Pixel Wizard. Released under the MIT License. See LICENSE in this folder.",
    "thirdParty": []
  },
  "provenance": "Adapted from the owner's threejs-sketches/objects-scenes/cymbal-crash (MIT) and rebuilt for AI Pixel Wizard in October 2026 as an original studio object: a lathed-profile cymbal whose surface is a closed-form sum of lobed vibration modes after a strike, on an exact loop.",
  "changelog": [
    {
      "version": "1.0.0",
      "date": "2026-10-05",
      "notes": "Initial release."
    }
  ]
}