useTexture

Read as Markdown

Import useTexture from @pibbl/core/textures alongside a generator. Call it consistently in a synchronous Pibbl component. Pass its returned handle as a primitive’s style.fill or use its documented paint placement API.

const ink = useTexture(reactionDiffusion({ seed: 42 }), {
  resolution: { width: 128, height: 48 },
  palette: ["#082f35", "#72c6b0"],
});

This excerpt belongs inside the complete component and host recipe. The hook owns the resource until its component is removed or the root is disposed. Keep sharing within its owning Pibbl instance and lifetime; do not store a handle for use in unrelated roots. Configuration updates should flow through the mounted hook, rather than recreating the whole root for hover changes.

Resolution defaults to 256 by 160; each dimension must be an integer from 8 to 1024 and the product cannot exceed 262144 cells. A palette has 2 to 16 #RRGGBB colors. A display can be larger than the texture without increasing simulation resolution.

Read marble for a static material and reactionDiffusion for a message-driven living texture. Resource teardown follows pibbl.

Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.