File	Date	Author	Commit
external	2012-08-12	U-TIMI70\user	[e3acd2] Now works on cygwin
tests	2012-08-12	Purdea Andrei	[c01c39] Initial commit
.gitignore	2012-08-12	U-TIMI70\user	[e3acd2] Now works on cygwin
LICENSE.txt	2012-08-12	Purdea Andrei	[50e201] Adding license
Makefile	2012-08-12	Purdea Andrei	[c01c39] Initial commit
README.txt	2012-08-12	U-TIMI70\user	[e3acd2] Now works on cygwin
common.c	2012-08-12	Purdea Andrei	[50e201] Adding license
common.h	2012-08-12	Purdea Andrei	[50e201] Adding license
data_placement.c	2012-08-12	Purdea Andrei	[50e201] Adding license
data_placement.h	2012-08-12	Purdea Andrei	[50e201] Adding license
image2xml.c	2012-08-12	Purdea Andrei	[50e201] Adding license
image2xmlmem.c	2012-08-12	Purdea Andrei	[50e201] Adding license
image2xmlmem.h	2012-08-12	Purdea Andrei	[50e201] Adding license
initial_build.sh	2012-08-12	U-TIMI70\user	[e3acd2] Now works on cygwin
markers.c	2012-08-12	Purdea Andrei	[50e201] Adding license
markers.h	2012-08-12	Purdea Andrei	[50e201] Adding license
mp_entry.c	2012-08-12	Purdea Andrei	[50e201] Adding license
mp_entry.h	2012-08-12	Purdea Andrei	[50e201] Adding license
mpo2jps.c	2012-08-12	Purdea Andrei	[50e201] Adding license
referenced_images.c	2012-08-12	Purdea Andrei	[50e201] Adding license
referenced_images.h	2012-08-12	Purdea Andrei	[50e201] Adding license
tags.c	2012-08-12	Purdea Andrei	[50e201] Adding license
tags.h	2012-08-12	Purdea Andrei	[50e201] Adding license
writers.c	2012-08-12	Purdea Andrei	[50e201] Adding license
writers.h	2012-08-12	Purdea Andrei	[50e201] Adding license
xml2image.c	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlfile2xmlmem.c	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlfile2xmlmem.h	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlmem2image.c	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlmem2image.h	2012-08-12	Purdea Andrei	[885d1c] typo
xmlmem2xmlfile.c	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlmem2xmlfile.h	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlmem_data_source_manager.c	2012-08-12	Purdea Andrei	[50e201] Adding license
xmlmem_data_source_manager.h	2012-08-12	Purdea Andrei	[50e201] Adding license

Read Me

== Building ==

Run ./initial_build.sh.
This will build the two libraries in the external folder, and then build this project.

If the two libraries are already built, then running a simple "make" command is sufficient to build image_meta_tools.
Run "make clean" to delete files generated by the image_meta_tools build
Run "make cleanall" to also clean the external libraries.

Build was tested on Debian Linux 64 bit, and on Windows/Cygwin.

== Usage ==

There are three tools at the moment:

1) image2xml

Usage: ./image2xml input.mpo/input.jpg output.xml [ flags ]
-i: non-parsed data: include data inline
-f: non-parsed data: generate binary files, and refer to the from XML (default)
-c: try to find unreferenced concatenated images (default)
-n: don't try to find unreferenced images (they remain binary data) (recommended)

2) xml2image

Usage: ./xml2image input.xml output.mpo/output.jpg [ output_offsets.h ] [ prefix for defintions in .h file ]

if a third argument is specified, then the offsets are written to the specified file like this:
#define _ifd_0__Orientation 54


3) mpo2jps

Usage: ./mpo2jps input.mpo output.jps [ flags ]
-hh: half-height output (pixels are averaged
-hw: half-width output (pixels are averaged
-fr: right image first (topmost/leftmost/red)
-fl: left image first (topmost/leftmost/red) (default!)
-i: interleaved layout
-s: side by side layout (default!)
-o: over-under layout
-a: anaglyph
-qNUMBER: JPEG quality (0..100). remember, MPO->JPS conversion reencodes the image!
NOTE: monoscopic format is not implemented.