Skip to content
Back

Image revealPro

A picture coming into being like a diffusion sampler: a coarse block grid in the picture's colours sheds its noise in visible steps over a soft guess that slowly focuses, then a sweep from the top lays down the final sharp result.

oxyn add image-reveal
Queued
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Show an image forming like a diffusion model samples, so the wait reads as progress rather than a spinner.

When not to use

Installation

Image reveal is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add image-reveal

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Loop

A looping generation over Oxyn's sample scenes.

Queued
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Grid

Four small tiles with staggered starts (Oxyn extra).

Queued
Queued
Queued
Queued
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Wide again

Wide, with Generate again (Oxyn extra).

Queued
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Error

Fails at step 19, with Retry.

Queued
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

ImageReveal

PropTypeDefaultDescription
nowrequiredClockMs—Host clock.
durationu644_600Sampling time, ms.
stepsu6430Denoising steps.
sizeString"md"`sm`, `md` or `lg`.
aspectString"1"Width over height (`1`, `4 / 5`, `16 / 9`).
loopingbooltrueLoop after the finished image holds.
delayu64Default::default()Extra queue time, ms (stagger a grid).
failboolDefault::default()Fails at 60 % (error scenario).
seedu64Default::default()Scene seed.
show_progressbooltrueShow the progress pill.
againboolDefault::default()Generate again button (Oxyn extra).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabRetry after a failure; the picture itself is not a stop
EnterorSpaceRetry or Generate again

Accessibility

  • The picture is exposed as an image whose name reports progress and switches to a real description at the end.
  • Waiting, generating, ready and failures are spoken; individual steps stay silent.
  • During sampling the badge acts as a progress bar reading Step n of total.
From the spec

The canvas is role img, labelled with the state and then the alt text; while generating the pill is a progressbar with Step n of total; states are announced, steps are not. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.

Motion & interaction

Noise strength and blur follow whole steps, not time, so the picture moves in visible steps. The latent cells take the image's own colours. Sample images are Oxyn vector scenes.

Timing

Everything on screen is derived from the host clock now (no timers in the component), so playback, tests and the GPUI view agree.

TransitionDurationEasing
Queue900 ms—
Sampling4600 ms default, 30 stepsstepped
Decode560 mslinear
Hold before loop2600 ms—
Sheen1100 ms onceease-out

Reduced motion: loops and travel stop; each state shows its end pose and its words.

Responsive behaviour

  • Fills its container (up to 560 px) at the given aspect ratio.
  • The small size keeps only the ring and the step count.
Edge cases (spec)

Fills its container up to 560 px at the given aspect ratio (cover-cropped). The small size keeps only the ring and the count. A grid staggers starts. Checked at 1440, 768 and 390 px in light and dark with no text overlap. Chrome is monochrome grey; colour is semantic only (success, warning, danger, info) plus the official coloured brand and model marks.

Notes for AI

  • Import ImageReveal from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: AiKitView in oxyn_gpui.
  • Props to set first: now.
  • It reads a clock (now) for live timers; pass one clock for the whole page rather than one per component.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI