pyoni 0.6.1

# pyoni
Pure python tool for manipulating OpenNI recorded files (oni). This tool supports extraction of data, time rescaling and fix of broken files.

Options
=======================
```
usage: pyonitool.py [-h] [--info] [--times] [--seeks] [--dump] [--copy]
[--rescale RESCALE] [--fixcut] [--checkcut]
[--dupframes DUPFRAMES] [--stripcolor] [--stripdepth]
[--stripir] [--registercolor] [--registerdepth] [--mjpeg]
[--extractcolor EXTRACTCOLOR]
[--extractdepth EXTRACTDEPTH] [--extractir EXTRACTIR]
[--fseek FSEEK] [--fduration FDURATION]
[--skipframes SKIPFRAMES] [--coloreddepth]
[--output OUTPUT] [--cutbytime CUTBYTIME]
[--cutbyframe CUTBYFRAME]
file

Scan OpenNI ONI files

positional arguments:
file ONI filename

optional arguments:
-h, --help show this help message and exit
--info
--times print times of each frame
--seeks print seeks
--dump
--copy simply copies the content of the ONI via parsing
(rebuilds the seektable only)
--rescale RESCALE rescale timings
--fixcut fixes cut file NOT TESTED HERE
--checkcut checks if file was cut NOT TESTED HERE
--dupframes DUPFRAMES
duplicate frames
--stripcolor
--stripdepth
--stripir removes IR
--registercolor registers color over depth
--registerdepth registers depth over color
--mjpeg extract the color stream as motion jpeg
--extractcolor EXTRACTCOLOR
extract the color stream single jpeg or png images.
This option specifies the target path, numbering is
the frame number
--extractdepth EXTRACTDEPTH
extract the depth stream single png images. This
option specifies the target path, numbering is the
frame number
--extractir EXTRACTIR
extract the depth stream single png images. This
option specifies the target path, numbering is the
frame number
--fseek FSEEK seek frame for extract
--fduration FDURATION
duration of extraction in frames
--skipframes SKIPFRAMES
skip n frames
--coloreddepth colored depth
--output OUTPUT
--cutbytime CUTBYTIME
cut by specifing time in seconds:
startseconds,endseconds
--cutbyframe CUTBYFRAME
cut by specifing time in frames: startframe,endframe
```

Build
=======================

Two C++ codes require manual steps using cmake and then the resulting shared libraries needs to be visible to python at startup (PATH under Windows, LD_LIBRARY_PATH under Linux, DYLD_LIBRARY_PATH under OSX)

1) make sure that Eigen3 is available http://eigen.tuxfamily.org
2) go top level
3) mkdir build
cd build
cmake ..
4) make
5) make the output DLL/SO visible

In the next version I will package everything

References
=======================

https://github.com/OpenNI/OpenNI2/blob/master/Source/Drivers/OniFile/DataRecords.cpp
https://github.com/OpenNI/OpenNI2/blob/master/Source/Core/OniRecorder.cpp
https://github.com/OpenNI/OpenNI2/blob/master/Source/Core/OniDataRecords.cpp
CODECS: https://github.com/OpenNI/OpenNI2/blob/5b88c95e4f8d19b95713e3c873c7d07e48e5605b/Source/Drivers/OniFile/Formats/Xn16zEmbTablesCodec.h
https://github.com/OpenNI/OpenNI2/blob/5b88c95e4f8d19b95713e3c873c7d07e48e5605b/Source/Drivers/OniFile/Formats/XnStreamCompression.cpp