Vooya YUV/RGB Player - Usage Guide

Quick Start

Drag & Drop is supported, or use CTRL-O to open a file. Unless you have to specify the format due to improper file naming, hit Space to start playback (You should need to enter the format once only - it will be remembered).

Common shortcuts like LEFT, RIGHT, PageUp, PageDown, Pos1/Home, End work as expected. Press F11 to toggle full screen mode, and N to step through color channels. Resize the window as you like with the mouse, or use +/-. Toggle a timecode overlay with T. You can always alter the format (color space, width, height etc.) with CTRL-F. With A, you toggle aspect ratio handling.

You can draw with the right mouse button, enable the Magnifier with the middle mouse button (or M, or with mouse wheel) and drop a bitmap to wherever you like (a skype chat for instance) with the left mouse button. You can also hit CTRL-C to copy a frame as bitmap, or SHIFT-CTRL-S to save it. Clear a drawing with double click or DEL, enable advanced deinterlacing wit I.

On a Mac, of course, CTRL means CMD.

If you drag two files onto a vooya window, you will see the difference. More files will open more player instances.

Command Line Usage

The basic syntax is

vooya [options] path/to/my/file_720x480.yuv

Currently, the following options are supported:

• -p, --play Start playing automatically
• -d, --diff <<file name>> Show difference and MSE/PSNR between the input file and the file specified.

Menu Options

File

Open File(s)... You can load multiple files at once, opening multiple player instances. As a special case, if you open two files at once, the difference mode will be enabled. Note that you can also simply drag files over the playing area and drop them there with the same results.

Reload File Reload the file and update the frame count. The current seeking position is maintained if possible.

Close File Closes the current file and displays the startup panel.

Format shows the format dialog.

Copy Frame copies the current frame (including timestamp overlays and drawing annotations) to the clipboard. Note that you can also drag a frame with the mouse off the display into a folder or something that accepts bitmap clipboard data.

Save Frame Save a frame as image (PNG, JPG, TIF or BMP) to a user-specified folder.

On the bottom of the file menu, a list of recently used sequences should be displayed.

Control

Should be pretty self-explanatory.

The Sync icon on the lower right of the player window can be dragged onto another player instance; the two will then be coupled for playing. This is useful for playing side-by-side.

View

Size Display the video at greater or smaller size. Using "+" and "-", you can also do this with keyboard shortcuts, or even resize the window with the mouse, as usual.

Maintain Aspect Ratio Upon resizing the window, the video can be set to maintain its actual aspect ratio.

Fullscreen As it tells, enables fullscreen mode. Use F11 to activate and deactivate, or double-click in the full screen window.

Time Code Display a time code on the bottom left corner of every frame. This includes the frame number and the current time stamp based on the FPS given in the format dialog, in the format mm'ss''ms.

Next Channel Cycle through the color channels (N). The order of channels depends on the current color format.

Enable Magnifier Show a magnifying rectangle around the pointer, showing the current position and the respective values of all color channels.

Tools

Magnifier is best turned on with mouse wheel / touch pad scroll, on middle click, or M. The magnifier can be moved around with the mouse and can be closed with "ESC". The magnifier can be fine-tuned with Q,W,E,S. 

Difference Against... Turn on diff mode. A file dialog will pop up and let you choose the second reference file. It is assumed that this file has exactly the same format settings as the current one. On the upper right, PSNR and MSE values per color channel are displayed, along with the first difference pixel from top left. You can cycle through diff components with C and V.

Deinterlace Turn on (high quality!) deinterlacing. The frame rate is halved.

Normalize File Name changes the file name into something every yuv player should understand

Extract opens a dialog where you can create a new sequence from a range of frames.

Reverse allows to reverse the current sequence, giving you a new one.

Brightness, Contrast opens a toolbar where you can adjust brightness, contrast and gamma, e.g. for better examining coding artefacts.

Video Formats

Vooya supports the follwoing formats:

• UYVY, YUY2, YUYV (interleaved 4:2:2 YUV formats)
• P420. P422, P444 (4:2:0, 4:2:2, 4:4:4 planar formats in YUV)
• RGB24, RGB32, RGB48 (interleaved 4:4:4 RGB, I444 in file names)
• BGR24, BGR32, BGR48 (interleaved 4:4:4 RGB)
• BW (Gray only)

File Names

To avoid entering formats every time, it is convenient to name raw data files appropriately. A file name Vooya can handle should at least contain the video's resolution, e.g.
     myfile_720x480.yuv                         hisfile_1920x1080.rgb

More generically, a valid file name looks like

youNameIt_WIDTHxHEIGHT[_FPS[Hz|fps]][_BITSbit][_(P420|P422|P444|UYVY|YUY2|YUYV|I444)].[rgb|yuv|bw|rgba|bgr|bgra]

Fallback is P420, 8bit YUV. Some examples:

• foo_720x480_25Hz_8bit_P420.yuv
• foo_720x480_16bit_P422.yuv
• foo_720x480_25Hz_YUY2.yuv
• foo_720x480_25Hz_I444.bgr
• foo_720x480_29.97Hz.rgba
• foo.vix