Skip to documentation

Components

Palette Dither

Ordered Bayer dithering that translates an image into a compact four-color editorial palette.

  • pixi.js@^8.20.1

Preparing preview…

Installation

Choose your framework. The registry installs one component file and its PixiJS dependency.

Installation unavailable

This preview is not assigned to the free or paid catalog. Installation is unavailable.

The registry command writes the component to src/lib/components/ui/PaletteDither.svelte and installs its dependencies.

The registry command writes the component to src/components/ui/PaletteDither.tsx and installs its dependencies.

The registry command writes the component to src/components/ui/PaletteDither.vue and installs its dependencies.

Overview

Palette Dither samples an image on a canvas-aligned grid, compares its luminance against a Bayer threshold, and resolves every pixel to one of four explicit palette colors.

The ordered pattern restores the impression of intermediate tones without introducing colors outside the selected palette.

Basic usage

The shader fills its parent. Your layout decides whether that parent is a card, hero, or viewport.

Hero.svelte
<script lang="ts">
	import PaletteDither from '$lib/components/ui/PaletteDither.svelte';
</script>

<section class="relative h-128 overflow-hidden">
	<PaletteDither
		class="absolute inset-0"
		src="/images/your-image.jpg"
	/>

	<div class="relative z-10">Your content</div>
</section>
<script lang="ts">
	import PaletteDither from '$lib/components/ui/PaletteDither.svelte';
</script>

<section class="relative h-128 overflow-hidden">
	<PaletteDither
		class="absolute inset-0"
		src="/images/your-image.jpg"
	/>

	<div class="relative z-10">Your content</div>
</section>
import { PaletteDither } from '@/components/ui/PaletteDither';

export function Hero() {
	return (
		<section className="relative h-128 overflow-hidden">
			<PaletteDither
				className="absolute inset-0"
				src="/images/your-image.jpg"
			/>

			<div className="relative z-10">Your content</div>
		</section>
	);
}
import { PaletteDither } from '@/components/ui/PaletteDither';

export function Hero() {
	return (
		<section className="relative h-128 overflow-hidden">
			<PaletteDither
				className="absolute inset-0"
				src="/images/your-image.jpg"
			/>

			<div className="relative z-10">Your content</div>
		</section>
	);
}
<script setup lang="ts">
import PaletteDither from '@/components/ui/PaletteDither.vue';
</script>

<template>
	<section class="relative h-128 overflow-hidden">
		<PaletteDither
			class="absolute inset-0"
			src="/images/your-image.jpg"
		/>

		<div class="relative z-10">Your content</div>
	</section>
</template>
<script setup lang="ts">
import PaletteDither from '@/components/ui/PaletteDither.vue';
</script>

<template>
	<section class="relative h-128 overflow-hidden">
		<PaletteDither
			class="absolute inset-0"
			src="/images/your-image.jpg"
		/>

		<div class="relative z-10">Your content</div>
	</section>
</template>
  • Use Pixel size to trade fine photographic detail for a more graphic low-resolution texture.
  • Dither strength at zero keeps the same palette while removing the spatial threshold pattern.

Component API

Types below match the selected Svelte component.

Property Type Default Range / values
class
string
src
string Image URL or data URL
imageFit
"cover" | "fit" | "stretch" "cover" cover, fit, stretch
darkColor
string "#131315"
shadowColor
string "#29305F"
brandColor
string "#5867D3"
lightColor
string "#EEF0FF"
cellSize
number 2 1–12
ditherStrength
number 1 0–1
contrast
number 1.1 0.5–2
brightness
number 0 -0.4–0.4
paused
boolean false
interactive
boolean false
maxDpr
number 2 1–3
resolutionScale
number 1 0.25–1
onReady
(backend: ShaderBackend) => void webgpu, webgl
onRendererChange
(backend: ShaderBackend, reason: string) => void webgl
onError
(error: Error) => void
bind:this
Component public instance pause, resume, reset, resize, destroy

Types below match the selected React component.

Property Type Default Range / values
className
string
src
string Image URL or data URL
imageFit
"cover" | "fit" | "stretch" "cover" cover, fit, stretch
darkColor
string "#131315"
shadowColor
string "#29305F"
brandColor
string "#5867D3"
lightColor
string "#EEF0FF"
cellSize
number 2 1–12
ditherStrength
number 1 0–1
contrast
number 1.1 0.5–2
brightness
number 0 -0.4–0.4
paused
boolean false
interactive
boolean false
maxDpr
number 2 1–3
resolutionScale
number 1 0.25–1
onReady
(backend: ShaderBackend) => void webgpu, webgl
onRendererChange
(backend: ShaderBackend, reason: string) => void webgl
onError
(error: Error) => void
ref
PaletteDitherHandle pause, resume, reset, resize, destroy

Types below match the selected Vue component.

Property Type Default Range / values
class
string
src
string Image URL or data URL
imageFit
"cover" | "fit" | "stretch" "cover" cover, fit, stretch
darkColor
string "#131315"
shadowColor
string "#29305F"
brandColor
string "#5867D3"
lightColor
string "#EEF0FF"
cellSize
number 2 1–12
ditherStrength
number 1 0–1
contrast
number 1.1 0.5–2
brightness
number 0 -0.4–0.4
paused
boolean false
interactive
boolean false
maxDpr
number 2 1–3
resolutionScale
number 1 0.25–1
@ready
(backend: ShaderBackend) => void webgpu, webgl
@rendererchange
(backend: ShaderBackend, reason: string) => void webgl
@error
(error: Error) => void
ref
Component public instance pause, resume, reset, resize, destroy