Pixel Transition New
Canvas transitions between images: pixelate, dissolve or blinds, with captions and prev/next.
Installation
01
Install with the shadcn CLI. The NiceUI theme comes along the first time.
$ npx shadcn@latest add https://niceui.dev/r/gallery-pixel-transition.json02
Or copy the source below (2 files). Dependencies: lucide-react.
Source
components/niceui/gallery/PixelTransition.tsx
import { useEffect, useMemo, useRef, useState } from 'react';
import { ChevronLeft, ChevronRight } from 'lucide-react';
import { cn } from '@/lib/cn';
import { ARTWORKS, artwork } from './art';
export type PixelEffect = 'pixelate' | 'dissolve' | 'blinds';
const load = (src: string) =>
new Promise<HTMLImageElement>((res) => {
const img = new Image();
img.onload = () => res(img);
img.src = src;
});
/** Transitions between images on a canvas: pixelate, dissolve or blinds. */
export function PixelTransition({ images, effect = 'pixelate', index, className }: { images: string[]; effect?: PixelEffect; index: number; className?: string }) {
const cvs = useRef<HTMLCanvasElement>(null);
const shown = useRef(index);
const imgs = useRef<HTMLImageElement[]>([]);
useEffect(() => {
let alive = true;
Promise.all(images.map(load)).then((l) => {
if (!alive) return;
imgs.current = l;
const c = cvs.current!;
c.getContext('2d')!.drawImage(l[shown.current], 0, 0, c.width, c.height);
});
return () => {
alive = false;
};
}, [images]);
useEffect(() => {
const c = cvs.current;
const g = c?.getContext('2d');
const from = imgs.current[shown.current];
const to = imgs.current[index];
if (!c || !g || !from || !to || shown.current === index) return;
const W = c.width;
const H = c.height;
const reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
const dur = reduce ? 1 : 900;
const seeds = Array.from({ length: 48 * 27 }, () => Math.random());
const t0 = performance.now();
let raf = 0;
const off = document.createElement('canvas');
const og = off.getContext('2d')!;
const frame = (now: number) => {
const t = Math.min(1, (now - t0) / dur);
g.imageSmoothingEnabled = true;
if (effect === 'pixelate') {
const peak = 1 - Math.abs(t * 2 - 1);
const block = Math.max(1, Math.round(peak * 42));
const src = t < 0.5 ? from : to;
off.width = Math.ceil(W / block);
off.height = Math.ceil(H / block);
og.drawImage(src, 0, 0, off.width, off.height);
g.imageSmoothingEnabled = false;
g.drawImage(off, 0, 0, W, H);
} else if (effect === 'dissolve') {
g.drawImage(from, 0, 0, W, H);
const cw = W / 48;
const ch = H / 27;
for (let y = 0; y < 27; y++)
for (let x = 0; x < 48; x++)
if (seeds[y * 48 + x] < t) g.drawImage(to, (x * to.width) / 48, (y * to.height) / 27, to.width / 48, to.height / 27, x * cw, y * ch, cw + 1, ch + 1);
} else {
g.drawImage(from, 0, 0, W, H);
const n = 12;
const bw = W / n;
for (let i = 0; i < n; i++) {
const p = Math.min(1, Math.max(0, t * 1.6 - (i / n) * 0.6));
g.drawImage(to, (i * to.width) / n, 0, (to.width / n) * p, to.height, i * bw, 0, bw * p, H);
}
}
if (t < 1) raf = requestAnimationFrame(frame);
else {
g.imageSmoothingEnabled = true;
g.drawImage(to, 0, 0, W, H);
shown.current = index;
}
};
raf = requestAnimationFrame(frame);
return () => {
cancelAnimationFrame(raf);
shown.current = index;
};
}, [index, effect]);
return <canvas ref={cvs} width={960} height={540} className={cn('aspect-video w-full rounded-2xl bg-black shadow-card', className)} />;
}
export function PixelTransitionDemo() {
const images = useMemo(() => [0, 2, 6, 9, 11].map((id) => artwork(id, 960, 540)), []);
const [i, setI] = useState(0);
const [effect, setEffect] = useState<PixelEffect>('pixelate');
const [touched, setTouched] = useState(false);
useEffect(() => {
if (touched || window.matchMedia('(prefers-reduced-motion: reduce)').matches) return;
const id = window.setInterval(() => setI((v) => (v + 1) % images.length), 2400);
return () => clearInterval(id);
}, [touched, images.length]);
const go = (d: number) => {
setTouched(true);
setI((v) => (v + d + images.length) % images.length);
};
const art = ARTWORKS[[0, 2, 6, 9, 11][i]];
return (
<div className="w-full space-y-3">
<div className="relative">
<PixelTransition images={images} effect={effect} index={i} />
<div className="pointer-events-none absolute bottom-4 left-4">
<p className="font-mono text-[10.5px] uppercase tracking-wider text-white/60">{art.place} · {art.year}</p>
<p key={i} className="font-serif text-2xl italic text-white animate-fade-up">{art.title}</p>
</div>
</div>
<div className="flex flex-wrap items-center gap-2">
<div className="flex rounded-full bg-white/5 p-0.5" role="group" aria-label="Transition effect">
{(['pixelate', 'dissolve', 'blinds'] as PixelEffect[]).map((e) => (
<button key={e} onClick={() => (setTouched(true), setEffect(e))} className={cn('focus-ring rounded-full px-3 py-1 text-[12px] capitalize transition-colors', effect === e ? 'bg-white text-ink-950' : 'text-ink-300 hover:text-ink-50')}>
{e}
</button>
))}
</div>
<span className="ml-auto font-mono text-[11px] text-ink-500">{i + 1} / {images.length}</span>
<button onClick={() => go(-1)} aria-label="Previous" className="focus-ring grid h-8 w-8 place-items-center rounded-full border border-white/10 text-ink-200 hover:bg-white/5"><ChevronLeft className="h-4 w-4" /></button>
<button onClick={() => go(1)} aria-label="Next" className="focus-ring grid h-8 w-8 place-items-center rounded-full border border-white/10 text-ink-200 hover:bg-white/5"><ChevronRight className="h-4 w-4" /></button>
</div>
</div>
);
}components/niceui/gallery/art.ts
/*
* Procedural artwork for the gallery demos: soft landscapes and abstract mesh
* gradients with film grain, rendered once to data URLs. Swap `src` for real
* photos in your app — every gallery component just takes image URLs.
*/
export type Artwork = { id: number; title: string; artist: string; place: string; year: number; tone: 'warm' | 'cool' | 'dusk' | 'mono' };
const PALETTES: string[][] = [
['#0b1d3a', '#1f4e79', '#f2a65a', '#f7d9a8'],
['#120c26', '#4b2a77', '#e66b9d', '#ffd1b3'],
['#06222b', '#0f5f6b', '#7fd1c7', '#e8f6f1'],
['#1b1410', '#5b3a26', '#d98c4a', '#f6e1c3'],
['#0e0f13', '#2b2f3a', '#8a93a6', '#e6e8ee'],
['#0a1a12', '#1f5134', '#9cc98a', '#f1f7da'],
['#1a0f14', '#6b1f3a', '#ef6f5e', '#ffd8a8'],
['#071426', '#123f73', '#5aa9e6', '#d6ecff'],
['#191325', '#3b2d5c', '#b39ddb', '#f3e9ff'],
['#201608', '#6e4a12', '#e0b34a', '#fff1c4'],
['#0b1216', '#29424f', '#6fa3b8', '#f0e6d2'],
['#170b0b', '#4a1414', '#c84b31', '#f5c26b'],
];
export const ARTWORKS: Artwork[] = [
{ id: 0, title: 'Low Tide, Dawn', artist: 'Mira Okafor', place: 'Comporta', year: 2025, tone: 'warm' },
{ id: 1, title: 'Neon Bloom', artist: 'Ilya Varga', place: 'Kyoto', year: 2024, tone: 'dusk' },
{ id: 2, title: 'Glass Lagoon', artist: 'Sana Iqbal', place: 'Faroe Islands', year: 2025, tone: 'cool' },
{ id: 3, title: 'Copper Dunes', artist: 'Teo Marchetti', place: 'Merzouga', year: 2023, tone: 'warm' },
{ id: 4, title: 'Fog Study No. 4', artist: 'Lena Brandt', place: 'Dolomites', year: 2024, tone: 'mono' },
{ id: 5, title: 'Green Hour', artist: 'Ravi Menon', place: 'Munnar', year: 2025, tone: 'cool' },
{ id: 6, title: 'Ember Coast', artist: 'Noor Haddad', place: 'Big Sur', year: 2024, tone: 'warm' },
{ id: 7, title: 'Blue Hour Harbour', artist: 'Jonas Weber', place: 'Bergen', year: 2025, tone: 'cool' },
{ id: 8, title: 'Lavender Field', artist: 'Camille Roy', place: 'Valensole', year: 2023, tone: 'dusk' },
{ id: 9, title: 'Golden Ridge', artist: 'Aiko Tanaka', place: 'Hokkaido', year: 2025, tone: 'warm' },
{ id: 10, title: 'Salt Flats', artist: 'Diego Alvarez', place: 'Uyuni', year: 2024, tone: 'mono' },
{ id: 11, title: 'Red Canyon', artist: 'Hana Kobayashi', place: 'Arizona', year: 2025, tone: 'warm' },
];
let seedState = 1;
const rand = () => {
seedState = (seedState * 1664525 + 1013904223) >>> 0;
return seedState / 4294967296;
};
const cache = new Map<string, string>();
/** A deterministic artwork as a data URL. `kind` picks a landscape or an abstract mesh. */
export function artwork(id: number, w = 960, h = 640, kind: 'landscape' | 'mesh' = id % 3 === 1 ? 'mesh' : 'landscape'): string {
const key = `${id}-${w}-${h}-${kind}`;
const hit = cache.get(key);
if (hit) return hit;
if (typeof document === 'undefined') return '';
const c = document.createElement('canvas');
c.width = w;
c.height = h;
const g = c.getContext('2d');
if (!g) return '';
seedState = (id + 1) * 9973;
const [deep, mid, hot, light] = PALETTES[id % PALETTES.length];
const sky = g.createLinearGradient(0, 0, 0, h);
sky.addColorStop(0, deep);
sky.addColorStop(0.55, mid);
sky.addColorStop(1, kind === 'mesh' ? deep : hot);
g.fillStyle = sky;
g.fillRect(0, 0, w, h);
// soft light blobs
const blobs = kind === 'mesh' ? 6 : 3;
for (let i = 0; i < blobs; i++) {
const x = rand() * w;
const y = rand() * h * (kind === 'mesh' ? 1 : 0.6);
const r = (0.25 + rand() * 0.45) * Math.max(w, h);
const rg = g.createRadialGradient(x, y, 0, x, y, r);
rg.addColorStop(0, [hot, light, mid][i % 3] + 'cc');
rg.addColorStop(1, 'transparent');
g.globalCompositeOperation = 'screen';
g.fillStyle = rg;
g.fillRect(0, 0, w, h);
}
g.globalCompositeOperation = 'source-over';
if (kind === 'landscape') {
// sun
const sx = (0.25 + rand() * 0.5) * w;
const sy = h * (0.38 + rand() * 0.12);
const sr = Math.min(w, h) * (0.07 + rand() * 0.05);
const glow = g.createRadialGradient(sx, sy, 0, sx, sy, sr * 5);
glow.addColorStop(0, light + 'aa');
glow.addColorStop(1, 'transparent');
g.fillStyle = glow;
g.fillRect(0, 0, w, h);
g.fillStyle = light;
g.beginPath();
g.arc(sx, sy, sr, 0, Math.PI * 2);
g.fill();
// ridges, back to front
for (let layer = 0; layer < 4; layer++) {
const base = h * (0.5 + layer * 0.12);
const amp = h * (0.12 - layer * 0.02);
const f1 = 1.5 + rand() * 2;
const f2 = 4 + rand() * 4;
const ph = rand() * 10;
g.beginPath();
g.moveTo(0, h);
for (let x = 0; x <= w; x += 4) {
const u = x / w;
const y = base - amp * (0.6 * Math.sin(u * f1 * Math.PI + ph) + 0.3 * Math.sin(u * f2 * Math.PI + ph * 2) + 0.1 * Math.sin(u * 23 + ph));
g.lineTo(x, y);
}
g.lineTo(w, h);
g.closePath();
const t = layer / 3;
const lg = g.createLinearGradient(0, base - amp, 0, h);
lg.addColorStop(0, mix(mid, deep, 0.25 + t * 0.6));
lg.addColorStop(1, mix(deep, '#000000', t * 0.5));
g.fillStyle = lg;
g.globalAlpha = 0.92;
g.fill();
g.globalAlpha = 1;
}
} else {
// flowing ribbons
for (let i = 0; i < 3; i++) {
g.beginPath();
const y0 = h * (0.2 + rand() * 0.6);
g.moveTo(-50, y0);
g.bezierCurveTo(w * 0.3, y0 - h * (rand() - 0.5), w * 0.7, y0 + h * (rand() - 0.5), w + 50, y0 + h * (rand() - 0.5) * 0.6);
g.lineWidth = Math.min(w, h) * (0.08 + rand() * 0.12);
g.strokeStyle = [light, hot, mid][i] + '55';
g.filter = `blur(${Math.round(Math.min(w, h) * 0.04)}px)`;
g.stroke();
g.filter = 'none';
}
}
// vignette
const vg = g.createRadialGradient(w / 2, h / 2, Math.min(w, h) * 0.3, w / 2, h / 2, Math.max(w, h) * 0.75);
vg.addColorStop(0, 'transparent');
vg.addColorStop(1, 'rgba(0,0,0,0.45)');
g.fillStyle = vg;
g.fillRect(0, 0, w, h);
// film grain
const img = g.getImageData(0, 0, w, h);
const d = img.data;
for (let i = 0; i < d.length; i += 4) {
const n = (rand() - 0.5) * 18;
d[i] += n;
d[i + 1] += n;
d[i + 2] += n;
}
g.putImageData(img, 0, 0);
const url = c.toDataURL('image/jpeg', 0.86);
cache.set(key, url);
return url;
}
function mix(a: string, b: string, t: number) {
const pa = parseInt(a.slice(1), 16);
const pb = parseInt(b.slice(1), 16);
const ch = (s: number) => Math.round(((pa >> s) & 255) * (1 - t) + ((pb >> s) & 255) * t);
return `rgb(${ch(16)},${ch(8)},${ch(0)})`;
}