{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "shader-film-grain",
  "title": "Shader Film Grain",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Grão de película correndo sobre uma imagem a 24 quadros por segundo, em cinza ou com um grão por canal de cor.",
  "dependencies": [],
  "registryDependencies": [
    "utils",
    "@visant/css-color"
  ],
  "files": [
    {
      "path": "registry/visant/ui/shader-film-grain.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\nimport { onThemeChange, resolveCssColor } from \"@/lib/css-color\";\n\n/**\n * Shader Film Grain — grão de película correndo por cima de uma imagem, em\n * cinza ou com um grão por canal de cor. Dá textura de filme a uma foto limpa\n * de banco, sem esconder a foto.\n *\n * Colhido do motor de efeitos de impressão do Visant Labs (`print-fx`, o\n * shader `filmGrain` do ImageLab, que por sua vez veio do \"Film Grain\" do\n * Shadertoy). Lá o grão saía congelado na exportação; aqui ele corre.\n *\n * ── As decisões que não se veem ────────────────────────────────────────────\n *\n * 1. **24 quadros, não 60.** Grão que troca a cada quadro de tela vira chiado\n *    de TV. O grão sorteia de novo 24 vezes por segundo, a cadência do\n *    cinema, e entre um sorteio e outro o laço não chama o shader.\n * 2. **Hash no lugar do `mod` encadeado.** O original multiplicava a\n *    coordenada pelo tempo e tirava `mod` duas vezes; com o número crescendo,\n *    a precisão do float acaba e o grão vira listra. Aqui é um hash de seno\n *    com a semente presa num intervalo curto, com a mesma amplitude (±0,005 ×\n *    força) do original.\n * 3. **O grão tem tamanho.** `size` define quantos px de tela tem cada grão,\n *    então num retina o grão não some de tão fino.\n * 4. **O laço dorme.** Fora da tela (IntersectionObserver) não há quadro. Com\n *    movimento reduzido o grão fica parado num sorteio só e redesenha em troca\n *    de tema, tamanho ou knob.\n */\n\nconst VERT = `attribute vec2 a_pos;void main(){gl_Position=vec4(a_pos,0.0,1.0);}`;\n\nconst FRAG = `\n#ifdef GL_FRAGMENT_PRECISION_HIGH\nprecision highp float;\n#else\nprecision mediump float;\n#endif\nuniform vec2 uRes;\nuniform vec2 uImg;\nuniform sampler2D uTex;\nuniform float uForca;\nuniform float uGrao;\nuniform float uSemente;\nuniform float uCor;\nuniform vec3 uPapel;\n\nfloat hash(vec2 p){return fract(sin(dot(p,vec2(12.9898,78.233)))*43758.5453);}\n\nvoid main(){\n  vec2 px=vec2(gl_FragCoord.x,uRes.y-gl_FragCoord.y);\n  float s=max(uRes.x/uImg.x,uRes.y/uImg.y);\n  vec2 tam=uImg*s;\n  vec2 uv=(px-(uRes-tam)*.5)/tam;\n  vec3 cor=uPapel;\n  if(uv.x>=0.&&uv.y>=0.&&uv.x<=1.&&uv.y<=1.){\n    vec4 c=texture2D(uTex,uv);\n    cor=mix(uPapel,c.rgb,c.a);\n  }\n  vec2 g=mod(floor(px/uGrao),1024.)+uSemente;\n  float a=hash(g)*.01-.005;\n  vec3 grao=vec3(a);\n  if(uCor>.5)grao=vec3(a,hash(g+vec2(7.,11.))*.01-.005,hash(g+vec2(13.,5.))*.01-.005);\n  gl_FragColor=vec4(cor+grao*uForca,1.);\n}\n`;\n\nexport interface ShaderFilmGrainProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /** A imagem a granular. Fundo transparente vira papel. */\n  src: string;\n  /** Texto alternativo da imagem. */\n  alt?: string;\n  /**\n   * Força do grão.\n   * @min 0\n   * @max 100\n   * @step 1\n   */\n  strength?: number;\n  /**\n   * Tamanho de cada grão, em px.\n   * @min 1\n   * @max 8\n   * @step 1\n   */\n  size?: number;\n  /** Um grão por canal de cor, em vez de grão cinza. */\n  colored?: boolean;\n}\n\nfunction compilar(gl: WebGLRenderingContext, frag: string): WebGLProgram | null {\n  const shader = (tipo: number, src: string) => {\n    const s = gl.createShader(tipo);\n    if (!s) return null;\n    gl.shaderSource(s, src);\n    gl.compileShader(s);\n    return gl.getShaderParameter(s, gl.COMPILE_STATUS) ? s : null;\n  };\n  const vs = shader(gl.VERTEX_SHADER, VERT);\n  const fs = shader(gl.FRAGMENT_SHADER, frag);\n  const p = gl.createProgram();\n  if (!vs || !fs || !p) return null;\n  gl.attachShader(p, vs);\n  gl.attachShader(p, fs);\n  gl.linkProgram(p);\n  gl.deleteShader(vs);\n  gl.deleteShader(fs);\n  return gl.getProgramParameter(p, gl.LINK_STATUS) ? p : null;\n}\n\nconst QUADROS_POR_SEGUNDO = 24;\n\nexport function ShaderFilmGrain({\n  src,\n  alt = \"Imagem com grão de filme\",\n  strength = 50,\n  size = 1,\n  colored = false,\n  className,\n  ...props\n}: ShaderFilmGrainProps) {\n  const wrapRef = React.useRef<HTMLDivElement>(null);\n  // Parâmetros vivos num ref: mexer no knob não recria o contexto.\n  const params = React.useRef({ strength, size, colored });\n  params.current = { strength, size, colored };\n  const redesenhar = React.useRef<() => void>(() => {});\n\n  React.useEffect(() => {\n    const wrap = wrapRef.current;\n    if (!wrap) return;\n    const canvas = document.createElement(\"canvas\");\n    canvas.setAttribute(\"aria-hidden\", \"true\");\n    canvas.className = \"absolute inset-0 block h-full w-full\";\n    wrap.appendChild(canvas);\n    const gl = canvas.getContext(\"webgl\", { antialias: false, alpha: false });\n    const prog = gl && compilar(gl, FRAG);\n    if (!gl || !prog) {\n      canvas.remove();\n      return;\n    }\n\n    const buf = gl.createBuffer();\n    gl.bindBuffer(gl.ARRAY_BUFFER, buf);\n    gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);\n    gl.useProgram(prog);\n    const aPos = gl.getAttribLocation(prog, \"a_pos\");\n    gl.enableVertexAttribArray(aPos);\n    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, 0, 0);\n    const u = (n: string) => gl.getUniformLocation(prog, n);\n    const U = {\n      res: u(\"uRes\"),\n      img: u(\"uImg\"),\n      tex: u(\"uTex\"),\n      forca: u(\"uForca\"),\n      grao: u(\"uGrao\"),\n      semente: u(\"uSemente\"),\n      cor: u(\"uCor\"),\n      papel: u(\"uPapel\"),\n    };\n\n    const tex = gl.createTexture();\n    gl.bindTexture(gl.TEXTURE_2D, tex);\n    // 1×1 transparente até a imagem chegar: o primeiro quadro é só papel.\n    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, new Uint8Array(4));\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);\n    gl.uniform1i(U.tex, 0);\n    gl.uniform2f(U.img, 1, 1);\n\n    const mq = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    let reduzido = mq.matches;\n    let visivel = false;\n    let dpr = 1;\n    let raf = 0;\n    let sorteio = 0;\n    let ultimoSorteio = 0;\n\n    const cores = () => {\n      gl.uniform3fv(U.papel, resolveCssColor(\"var(--background)\", wrap));\n    };\n\n    const medir = () => {\n      // offsetWidth é a medida local: a vitrine escala o palco com transform.\n      dpr = Math.min(2, window.devicePixelRatio || 1);\n      canvas.width = Math.max(1, Math.round(wrap.offsetWidth * dpr));\n      canvas.height = Math.max(1, Math.round(wrap.offsetHeight * dpr));\n      gl.viewport(0, 0, canvas.width, canvas.height);\n    };\n\n    const desenhar = () => {\n      const p = params.current;\n      gl.uniform2f(U.res, canvas.width, canvas.height);\n      gl.uniform1f(U.forca, (Math.max(0, Math.min(100, p.strength)) / 100) * 32);\n      gl.uniform1f(U.grao, Math.max(1, Math.round(Math.max(1, Math.min(8, p.size)) * dpr)));\n      // Semente num intervalo curto: o hash de seno perde precisão com número grande.\n      gl.uniform1f(U.semente, (sorteio % 97) * 1.37);\n      gl.uniform1f(U.cor, p.colored ? 1 : 0);\n      gl.drawArrays(gl.TRIANGLES, 0, 3);\n    };\n\n    const quadro = (agora: number) => {\n      if (agora - ultimoSorteio >= 1000 / QUADROS_POR_SEGUNDO) {\n        ultimoSorteio = agora;\n        sorteio++;\n        desenhar();\n      }\n      raf = visivel && !reduzido ? requestAnimationFrame(quadro) : 0;\n    };\n\n    const ligar = () => {\n      if (!raf && visivel && !reduzido) raf = requestAnimationFrame(quadro);\n    };\n    const desligar = () => {\n      cancelAnimationFrame(raf);\n      raf = 0;\n    };\n\n    redesenhar.current = desenhar;\n\n    const trocarMovimento = () => {\n      reduzido = mq.matches;\n      if (reduzido) {\n        desligar();\n        desenhar();\n      } else ligar();\n    };\n\n    let vivo = true;\n    const img = new Image();\n    img.crossOrigin = \"anonymous\";\n    img.decoding = \"async\";\n    img.onload = () => {\n      if (!vivo) return;\n      gl.bindTexture(gl.TEXTURE_2D, tex);\n      gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, img);\n      gl.uniform2f(U.img, img.naturalWidth || 1, img.naturalHeight || 1);\n      desenhar();\n    };\n    img.src = src;\n\n    cores();\n    medir();\n    desenhar();\n\n    const ro = new ResizeObserver(() => {\n      medir();\n      desenhar();\n    });\n    ro.observe(wrap);\n    const io = new IntersectionObserver(([e]) => {\n      visivel = e.isIntersecting;\n      if (visivel) ligar();\n      else desligar();\n    });\n    io.observe(wrap);\n    const offTema = onThemeChange(() => {\n      cores();\n      desenhar();\n    });\n    mq.addEventListener(\"change\", trocarMovimento);\n\n    return () => {\n      vivo = false;\n      img.onload = null;\n      desligar();\n      ro.disconnect();\n      io.disconnect();\n      offTema();\n      mq.removeEventListener(\"change\", trocarMovimento);\n      redesenhar.current = () => {};\n      gl.deleteTexture(tex);\n      gl.deleteBuffer(buf);\n      gl.deleteProgram(prog);\n      gl.getExtension(\"WEBGL_lose_context\")?.loseContext();\n      canvas.remove();\n    };\n  }, [src]);\n\n  React.useEffect(() => {\n    redesenhar.current();\n  }, [strength, size, colored]);\n\n  return (\n    <div\n      ref={wrapRef}\n      role=\"img\"\n      aria-label={alt}\n      className={cn(\"relative block aspect-square w-full overflow-hidden bg-background\", className)}\n      {...props}\n    />\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Dar textura de filme a foto limpa de banco, em hero editorial, portfólio ou campanha",
      "evite": "Fita gasta com onda e vinco: shader-vhs; tela de tubo, shader-crt"
    }
  },
  "categories": [
    "shaders",
    "shader",
    "webgl",
    "imagem",
    "grao",
    "filme"
  ],
  "type": "registry:ui"
}