onShaderRegistered

Be told when a user-defined shader is registered, replaced or removed.

onShaderRegistered(listener: (name: string, definition: GpuShaderDefinition | null) => void): () => void

Import onShaderRegistered from shaders/std.

The listener gets the name and the new definition, or null on removal. Returns a function that unsubscribes. Useful for a component picker or a live editor that lists custom shaders.

Parameters

NameTypeNotes
listener(name: string, definition: GpuShaderDefinition | null) => void

Example

const stop = onShaderRegistered((name, definition) => refreshPicker())

See also

  • registerShader — Make a user-defined shader findable by its name, so preset JSON can reference it as type: 'Halo'.
  • getRegisteredShaders — Every user-defined shader currently registered, oldest first.