Virtual.ink documentation

The Media module is the shared post-capture inspection system used by Virtual.ink. It helps operators browse datasets, replay media, inspect extracted frames, rate results, and clean up the gallery after capture or import.

What A Dataset Contains

A dataset is a gallery folder, usually named with the timestamp pattern YYMMDD-HHMMSS. Depending on the workflow, a dataset can contain:

• a video render
• a thumbnail
• extracted snapshot frames
• processing status
• rating metadata
• capture and processing details

Choose The Right View

View	Best for	Main actions
Library	scanning many datasets at once	browse, preview, select, move, copy, archive, delete
Quickview	making a decision on one dataset	rate, inspect details, share, archive, delete
Player	continuous playback	play video, step through playable datasets, run slideshows
Frames	frame-by-frame inspection	inspect extracted snapshots, filter frame numbers, auto-follow newest

Typical Workflow

1. Capture or import media so the gallery receives a new dataset.
2. Open Library to scan the gallery and identify the dataset you want.
3. Use Quickview when you need a single-dataset decision view with rating and sharing.
4. Use Player when you want uninterrupted playback of the current playable dataset sequence.
5. Use Frames when you need extracted-image inspection rather than full video playback.
6. Archive, delete, copy, or move datasets once the decision is made.

Shared Behaviors Across Media

• Processing overlays appear when a dataset still has queued or active renders.
• Desktop integrations can open the dataset folder directly. When that bridge is unavailable, Media falls back to copying the folder path.
• Preset-aware views can be opened with preset URLs so operators can reuse known layouts and settings.
• In dashboard-driven workflows, Quickview and Frames can stay synchronized to the same current dataset.

Standalone Pages And Dashboard Use

• Library and Player are full standalone media pages.
• Quickview and Frames are strongest as in-app media views and dashboard tiles.
• Frames and Quickview hide some standalone controls when embedded in a dashboard tile.

Current Media Pages

• Library for gallery browsing and dataset management.
• Quickview for single-dataset review, rating, and sharing.
• Player for playback and slideshow behavior.
• Frames for extracted snapshot inspection.

Used By

• Virtual.ink

Current Implementation Notes

• Library and Player both expose a Filter preset field, but filtering is not actively applied in the current build.
• Quickview exposes a Player size preset field, but its visible effect can vary by host view in the current build.