descriptionA Qt based viewer for various YUV file formats
homepage URLhttp://diracvideo.org/
repository URLgit://diracvideo.org/git/imageviewer.git
ownerdavidf@rd.bbc.co.uk
last changeTue, 18 Jan 2011 11:02:38 +0000 (18 11:02 +0000)
last refreshSun, 6 Aug 2017 23:48:59 +0000 (7 01:48 +0200)
content tags
add:
README
Imageviewer program is designed to allow the viewing of raw, headerless YUV
files that are encountered in video processing and broadcast applications. 

The source data can be a single video frame in a file, a set of numerically
named files forming a sequence of frames, or many frames concatenated into
a single large file.

The aim of the program is to display the image 'correctly' :-

* Colour matrixing is derived from first principles.

* 1/2, 1/2 filters are used to upsample chrominance to 4:4:4 for display

* Images can be viewed using 'video' or 'computer' number ranges

* Full screen mode allows an unscaled pixel-for-pixel display if graphics
  mode and monitor pixel counts are the same. Poor scaling implementations
  on graphics cards or in flat panel displays can be avoided by using 
  pixel-for-pixel modes.

Imageviewer provides compatibility with a wide range of YUV formats:

FourCC code     Description
-----------     -----------
I420            YUV planar 8 bit data

YV12            YVU planar 8 bit data

UYVY            UYVY multiplexed 8 bit data

V210            UYVY multiplexed 10 bit data, 3 components packed into 32 bits

V216            UYVY multiplexed 8-16 bit data, little endian,
				data packed to the most significant bits
				
UY16*           UYVY multiplexed 8-16 bit data, big endian, 
				data packed to the least significant bits

YYY8*			Luminance only 8 bit data. 
				As I420/YV12 but with no chrominance planes.

YY16*			Luminance only 16 bit data. Little endian,
				data packed to the most significant bits.

16P4*			YCbCr Planar 4:4:4 16 bit data. Big endian,
				data packed to the most significant bits.

16P2*			YCbCr Planar 4:2:2 16 bit data. Big endian,
				data packed to the most significant bits.

16P0*			YCbCr Planar 4:2:0 16 bit data. Big endian,
				data packed to the most significant bits.

RGB     RGB packed 24 bits per pixel

RGBA    RGBA packed 32 bits per pixel (alpha information ignored)

*This format is not a formal FourCC code, but has been encountered in the wild.

Additional limited support is provided for PPM and PGM formats with
bit depths up to 16 bits. No commonly available viewer provides bit depths
greater than 8 bits for PPM/PGM formats.

More details about these formats, and further instructions for Imageviewer are
available from the 'Help' menu.
shortlog
2011-01-18 Robert WadgeAdd facility to read frames in RGB & RGBA formatmaster
2009-06-29 Jonathan Rosserbump version to 1.3
2009-06-29 Jonathan Rosseradd nsis installer for qt-sdk built excutables
2009-06-26 Jonathan Rosserensure window background is dark at startup
2009-06-26 Jonathan Rosseradd copyright and web links to about dialog
2009-04-09 David Flynnleader-frm: Add frame dump format from leader (HD)SDI...
2009-04-09 David Flynnv210: fix incorrect bytes per frame calculation
2009-01-13 David FlynnFix crash when loading numeric sequence not commencing...
2009-01-13 David FlynnFix missing stdio.h include
2008-11-12 Jonathan Rosseradd support to for opening 8P2 files
2008-11-12 Jonathan Rosseradd IO routines for 8P2 files
2008-10-28 Jonathan Rosserfix loading of file passed as parameter
2008-10-22 Jonathan Rosserfix setting of bit depth for UY16 files
2008-07-10 Jonathan Rosserstepping through multi-frame files got broken, fix it.
2008-06-30 Jonathan Rosserbump version to 1.2
2008-06-30 Jonathan Rosseradded icon for windows executable
...
heads
13 years ago master