# ProceduralTexture

Import from `@pibbl/core/textures`. Required `kind` is `marble`, `paper`, or `cellular`.
Defaults: seed 42, 256 × 160 resolution, scale 6, detail 0.65, porcelain palette.
Scale is in the inclusive range 1 to 32; detail is in the inclusive range 0 to 1. Shape inputs regenerate; palettes recolor.
Display dimensions do not change the generated field.

It uses the render-layer style/event surface and stops scheduling after generation.
Use `pointerEvents="none"` for decorative content. The optional `render` callback
supports images, repeating fills, and masks. All three materials have matching opposite edges for seamless repetition.
Feature counts round to whole periods where needed. See [Material Lab](/playground/#/examples/composition/material-lab).

Options: [ProceduralTextureProps](/reference/types/textures/#proceduraltextureprops), [TextureKind](/reference/types/textures/#texturekind), [TextureRenderer](/reference/types/textures/#texturerenderer).

## API details from source

<span id="api-ProceduralTexture"></span>

A seeded static material. It requests no continuing animation frames.

```ts
ProceduralTexture: PibblComponent<ProceduralTextureProps & PibblRenderLayerComponentProps>
```

Related API: [ProceduralTexture](/reference/components/procedural-texture/), [PibblComponent](/reference/types/elements-components/#pibblcomponent), [ProceduralTextureProps](/reference/types/textures/#proceduraltextureprops), [PibblRenderLayerComponentProps](/reference/types/canvas-runtime/#pibblrenderlayercomponentprops).

### Parameters

- **`props`** — Authored component inputs, supplied through JSX or createElement. See the linked
props and style types.

### Throws

When called directly; Pibbl mounts this component through JSX or createElement.

### See also

[ProceduralTextureProps](/reference/types/textures/#proceduraltextureprops)

[View source — packages/core/src/features/textures/lib/procedural-texture.ts:101](/source/packages/core/src/features/textures/lib/procedural-texture-ts/#L101)

## Implementation guidance for agents

Read the [Textures and reaction-diffusion companion](/agents/topics/textures/) for ownership, adaptation, failure modes, and verification. [Agent start](/agents/) provides the version-selection workflow.

## Complete minimal examples

- [Render a procedural material](/minimal-examples/textures/texture-procedural-component/): Paint a marble material with a typed palette, resolution, and synchronous renderer. [Plain source](/minimal/textures/texture-procedural-component.tsx)
## Interactive examples

- [Material Lab](/examples/material-lab/) · [Full page](/experience/material-lab/)
## Documentation version

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