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-revealThe preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
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
- Replays a multi-agent run on one clock: use Agent timeline instead.
- One model at a glance: use Model card instead.
- A small automation on a single rail: use AI workflow instead.
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.
oxyn add image-revealUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Loop
A looping generation over Oxyn's sample scenes.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Grid
Four small tiles with staggered starts (Oxyn extra).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Wide again
Wide, with Generate again (Oxyn extra).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Error
Fails at step 19, with Retry.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
ImageReveal
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
duration | u64 | 4_600 | Sampling time, ms. |
steps | u64 | 30 | Denoising steps. |
size | String | "md" | `sm`, `md` or `lg`. |
aspect | String | "1" | Width over height (`1`, `4 / 5`, `16 / 9`). |
looping | bool | true | Loop after the finished image holds. |
delay | u64 | Default::default() | Extra queue time, ms (stagger a grid). |
fail | bool | Default::default() | Fails at 60 % (error scenario). |
seed | u64 | Default::default() | Scene seed. |
show_progress | bool | true | Show the progress pill. |
again | bool | Default::default() | Generate again button (Oxyn extra). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Retry after a failure; the picture itself is not a stop |
| EnterorSpace | Retry 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.
| Transition | Duration | Easing |
|---|---|---|
| Queue | 900 ms | — |
| Sampling | 4600 ms default, 30 steps | stepped |
| Decode | 560 ms | linear |
| Hold before loop | 2600 ms | — |
| Sheen | 1100 ms once | ease-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
ImageRevealfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
AiKitViewinoxyn_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.